li.cil.tis3d.api

Interface ManualClientAPI

All Superinterfaces:

ManualCommonAPI

All Known Implementing Classes:

ManualAPIImpl

public interface ManualClientAPI
extends ManualCommonAPI

This API allows interfacing with the in-game manual of TIS-3D.

It allows opening the manual at a desired specific page, as well as registering custom tabs and content callback handlers.

Note: this is a client side only API. It will do nothing on dedicated servers (i.e. API.manual will be null).

Method Summary

Modifier and Type	Method and Description
void	addProvider(ContentProvider provider) Register a content provider.
void	addProvider(java.lang.String prefix, ImageProvider provider) Register an image provider.
void	addTab(TabIconRenderer renderer, java.lang.String tooltip, java.lang.String path) Register a tab to be displayed next to the manual.
java.lang.Iterable<java.lang.String>	contentFor(java.lang.String path) Get the content of the documentation page at the specified location.
ImageRenderer	imageFor(java.lang.String path) Get the image renderer for the specified image path.
void	navigate(java.lang.String path) Navigate to a page in the manual.
void	openFor(net.minecraft.entity.player.PlayerEntity player) Open the manual for the specified player.
java.lang.String	pathFor(net.minecraft.item.ItemStack stack) Look up the documentation path for the specified item stack.
java.lang.String	pathFor(net.minecraft.world.World world, net.minecraft.util.math.BlockPos pos) Look up the documentation for the specified block in the world.
void	reset() Reset the history of the manual.

Methods inherited from interface li.cil.tis3d.api.ManualCommonAPI

addProvider

Method Detail

addTab

void addTab(TabIconRenderer renderer,
            @Nullable
            java.lang.String tooltip,
            java.lang.String path)

Register a tab to be displayed next to the manual.

These are intended to link to index pages, and for the time being there a relatively low number of tabs that can be displayed, so I'd ask you to only register as many tabs as actually, technically *needed*. Which will usually be one, for your main index page.

Parameters:

renderer - the renderer used to render the icon on your tab.

tooltip - the unlocalized tooltip of the tab, or null.

path - the path to the page to open when the tab is clicked.

addProvider

void addProvider(ContentProvider provider)

Register a content provider.

Content providers are used to resolve paths to page content, if the standard system (using Minecraft's resource loading facilities) fails.

This can be useful for providing dynamic content, for example.

Parameters:

provider - the provider to register.

addProvider

void addProvider(java.lang.String prefix,
                 ImageProvider provider)

Register an image provider.

Image providers are used to render custom content in a page. These are selected via the standard image tag of Markdown, based on the prefix of the image URL, i.e.  will select the image provider registered for the prefix prefix, and pass to it the argument data, then use the returned renderer to draw an element in the place of the tag.

Custom providers are only selected if a prefix is matched, otherwise it'll treat it as a relative path to an image to load via Minecraft's resource providing facilities, and display that.

Parameters:

prefix - the prefix on which to use the provider.

provider - the provider to register.

pathFor

@Nullable
java.lang.String pathFor(net.minecraft.item.ItemStack stack)

Look up the documentation path for the specified item stack.

Parameters:

stack - the stack to find the documentation path for.

Returns:

the path to the page, null if none is known.

pathFor

@Nullable
java.lang.String pathFor(net.minecraft.world.World world,
                                   net.minecraft.util.math.BlockPos pos)

Look up the documentation for the specified block in the world.

Parameters:

world - the world containing the block.

pos - the position of the block.

Returns:

the path to the page, null if none is known.

contentFor

@Environment(value=CLIENT)
 @Nullable
java.lang.Iterable<java.lang.String> contentFor(java.lang.String path)

Get the content of the documentation page at the specified location.

The provided path may contain the special variable %LANGUAGE%, which will be resolved to the currently set language, falling back to en_US.

Parameters:

path - the path of the page to get the content of.

Returns:

the content of the page, or null if none exists.

imageFor

@Environment(value=CLIENT)
 @Nullable
ImageRenderer imageFor(java.lang.String path)

Get the image renderer for the specified image path.

This will look for ImageProviders registered for a prefix in the specified path. If there is no match, or the matched content provider does not provide a renderer, this will return null.

Parameters:

path - the path to the image to get the renderer for.

Returns:

the custom renderer for that path, or null if none exists.

openFor

@Environment(value=CLIENT)
void openFor(net.minecraft.entity.player.PlayerEntity player)

Open the manual for the specified player.

If you wish to display a specific page, call navigate(String) after this function returns, with the path to the page to show.

Parameters:

player - the player to open the manual for.

reset

void reset()

Reset the history of the manual.

navigate

@Environment(value=CLIENT)
void navigate(java.lang.String path)

Navigate to a page in the manual.

Parameters:

path - the path to navigate to.