Mirrorlandia_minetest/minetest_hudbars
1
0
Fork 0
mirror of https://repo.or.cz/minetest_hudbars.git synced 2024-11-27 17:43:44 +01:00
Code Issues Projects Releases Wiki Activity

Final fixes to API documentation

Browse Source
This commit is contained in:
Wuzzy 2015-02-12 21:51:01 +01:00
parent 0ac416ad49
commit 7cd27de925
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
API.md
View File

@ -130,7 +130,8 @@ has been unhidden. Both functions will only call `hud_change` if there has been
unneccessary traffic. unneccessary traffic.
Note that the hidden state of a HUD bar will *not* be saved by this mod on server shutdown, so you may need Note that the hidden state of a HUD bar will *not* be saved by this mod on server shutdown, so you may need
to write your own routines for this. to write your own routines for this or by setting the correct value for `start_hidden` when calling
`hb.init_hudbar`.
### `hb.hide_hudbar(player, identifier)` ### `hb.hide_hudbar(player, identifier)`
Hides the specified HUD bar from the screen of the specified player. Hides the specified HUD bar from the screen of the specified player.
@ -143,7 +144,7 @@ Hides the specified HUD bar from the screen of the specified player.
Always `nil`. Always `nil`.
### `hb.hide_hudbar(player, identifier)` ### `hb.unhide_hudbar(player, identifier)`
Makes a previously hidden HUD bar visible again to a player. Makes a previously hidden HUD bar visible again to a player.
#### Parameters #### Parameters
@ -165,11 +166,12 @@ Returns the current state of the active player's HUD bar.
* `identifier`: The identifier of the HUD bar type to hide, as specified in `hb.register_hudbar`. * `identifier`: The identifier of the HUD bar type to hide, as specified in `hb.register_hudbar`.
#### Return value #### Return value
A table which holds information on the current state of the HUD bar. Note the table is a partial A table which holds information on the current state of the HUD bar. Note the table is a deep
copy of the internal HUD bar state, it is *not* a reference; the information hold by the table is copy of the internal HUD bar state, it is *not* a reference; the information hold by the table is
only true for the moment you called this function. The fields of this table are: only true for the moment you called this function. The fields of this table are:
* `value`: Current value of HUD bar
* `max`: Current maximum value of HUD bar * `value`: Current value of HUD bar.
* `hidden`: Boolean denoting whether the HUD bar is hidden * `max`: Current maximum value of HUD bar.
* `hidden`: Boolean denoting whether the HUD bar is hidden.
* `barlength`: The length of the HUD bar in pixels. This field is meaningless if the HUD bar is currently hidden. * `barlength`: The length of the HUD bar in pixels. This field is meaningless if the HUD bar is currently hidden.
* `text`: The text shown on the HUD bar. This fiels is meaningless if the HUD bar is currently hidden. * `text`: The text shown on the HUD bar. This fiels is meaningless if the HUD bar is currently hidden.