diff options
author | paramat <paramat@users.noreply.github.com> | 2018-01-15 03:34:03 +0000 |
---|---|---|
committer | paramat <mat.gregory@virginmedia.com> | 2018-01-15 04:42:14 +0000 |
commit | 70a90bc83a0b244a494627cfbc0305946bb1e593 (patch) | |
tree | 21adfc620f784a7ec538fa2d6dc49a4b8af49839 | |
parent | 142474196a86bf7d04f24ce4571c6b743be72595 (diff) | |
download | minetest-70a90bc83a0b244a494627cfbc0305946bb1e593.tar.gz minetest-70a90bc83a0b244a494627cfbc0305946bb1e593.tar.bz2 minetest-70a90bc83a0b244a494627cfbc0305946bb1e593.zip |
Lua_api.txt: Various improvements
Improve documentation for formspec 'position' and 'anchor' elements.
Add missing documentation of 'animation' and 'glow' for particle spawners.
-rw-r--r-- | doc/lua_api.txt | 25 |
1 files changed, 19 insertions, 6 deletions
diff --git a/doc/lua_api.txt b/doc/lua_api.txt index df72c6aa2..f588211b6 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -1897,14 +1897,23 @@ examples. * deprecated: `invsize[<W>,<H>;]` #### `position[<X>,<Y>]` -* Define the position of the formspec -* A value between 0.0 and 1.0 represents a position inside the screen -* The default value is the center of the screen (0.5, 0.5) +* Must be used after `size` element. +* Defines the position on the game window of the formspec's `anchor` point. +* For X and Y, 0.0 and 1.0 represent opposite edges of the game window, for example: + * [0.0, 0.0] sets the position to the top left corner of the game window. + * [1.0, 1.0] sets the position to the bottom right of the game window. +* Defaults to the center of the game window [0.5, 0.5]. #### `anchor[<X>,<Y>]` -* Define the anchor of the formspec -* A value between 0.0 and 1.0 represents an anchor inside the formspec -* The default value is the center of the formspec (0.5, 0.5) +* Must be used after both `size` and `position` (if present) elements. +* Defines the location of the anchor point within the formspec. +* For X and Y, 0.0 and 1.0 represent opposite edges of the formspec, for example: + * [0.0, 1.0] sets the anchor to the bottom left corner of the formspec. + * [1.0, 0.0] sets the anchor to the top right of the formspec. +* Defaults to the center of the formspec [0.5, 0.5]. + +* `position` and `anchor` elements need suitable values to avoid a formspec + extending off the game window due to particular game window sizes. #### `container[<X>,<Y>]` * Start of a container block, moves all physical elements in the container by (X, Y) @@ -5277,6 +5286,10 @@ Note that in params, use of symbols is as follows: -- ^ Uses texture (string) playername = "singleplayer" -- ^ Playername is optional, if specified spawns particle only on the player's client + animation = {Tile Animation definition}, + -- ^ optional, specifies how to animate the particle texture + glow = 0 + -- ^ optional, specify particle self-luminescence in darkness } ### `HTTPRequest` definition (`HTTPApiTable.fetch_async`, `HTTPApiTable.fetch_async`) |