From 99ca72e9dfb889c68389fb93cff98715c9821950 Mon Sep 17 00:00:00 2001 From: Beha Date: Fri, 30 Aug 2019 13:40:08 -0400 Subject: [PATCH] Clarify docs regarding pointed_thing and get_pointed_thing_position (#8766) --- doc/lua_api.txt | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/lua_api.txt b/doc/lua_api.txt index eaca09fe9..bfd983296 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -1325,6 +1325,9 @@ For helper functions see [Spatial Vectors]. * `{type="nothing"}` * `{type="node", under=pos, above=pos}` + * Indicates a pointed node selection box. + * `under` refers to the node position behind the pointed face. + * `above` refers to the node position in front of the pointed face. * `{type="object", ref=ObjectRef}` Exact pointing location (currently only `Raycast` supports these fields): @@ -4543,7 +4546,10 @@ Item handling * `minetest.inventorycube(img1, img2, img3)` * Returns a string for making an image of a cube (useful as an item image) * `minetest.get_pointed_thing_position(pointed_thing, above)` - * Get position of a `pointed_thing` (that you can get from somewhere) + * Returns the position of a `pointed_thing` or `nil` if the `pointed_thing` + does not refer to a node or entity. + * If the optional `above` parameter is true and the `pointed_thing` refers + to a node, then it will return the `above` position of the `pointed_thing`. * `minetest.dir_to_facedir(dir, is6d)` * Convert a vector to a facedir value, used in `param2` for `paramtype2="facedir"`.