From: Paramat Date: Thu, 7 Jun 2018 23:46:10 +0000 (+0100) Subject: Lua_api.txt: Warn of errors possible with VoxelArea:index()/indexp() (#7422) X-Git-Tag: 5.0.0~374 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=9ca37d86a3f8fd35150880e3c64cb81796430d68;p=oweals%2Fminetest.git Lua_api.txt: Warn of errors possible with VoxelArea:index()/indexp() (#7422) --- diff --git a/doc/lua_api.txt b/doc/lua_api.txt index d9cf96800..29befca52 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -4736,9 +4736,14 @@ The coordinates are *inclusive*, like most other things in Minetest. `MaxEdge`. * `index(x, y, z)`: returns the index of an absolute position in a flat array starting at `1`. - * useful for things like `VoxelManip`, raw Schematic specifiers, + * `x`, `y` and `z` must be integers to avoid an incorrect index result. + * The position (x, y, z) is not checked for being inside the area volume, + being outside can cause an incorrect index result. + * Useful for things like `VoxelManip`, raw Schematic specifiers, `PerlinNoiseMap:get2d`/`3dMap`, and so on. -* `indexp(p)`: same as above, except takes a vector +* `indexp(p)`: same functionality as `index(x, y, z)` but takes a vector. + * As with `index(x, y, z)`, the components of `p` must be integers, and `p` + is not checked for being inside the area volume. * `position(i)`: returns the absolute position vector corresponding to index `i`. * `contains(x, y, z)`: check if (`x`,`y`,`z`) is inside area formed by