LuaAPI: PlaceSprite return value
authorWuzzy
Sat, 09 Apr 2016 08:22:46 +0100
changeset 865 ed6a7ad2770f
parent 864 a442063fcf2e
child 866 e8d5c66477b7
LuaAPI: PlaceSprite return value
LuaAPI.wiki
--- a/LuaAPI.wiki	Thu Apr 07 19:52:48 2016 +0100
+++ b/LuaAPI.wiki	Sat Apr 09 08:22:46 2016 +0100
@@ -938,7 +938,8 @@
 || 7 || long || increasing right ||
 
 ==== <tt>!PlaceSprite(x, y, sprite, frameIdx, tint, behind, flipHoriz, flipVert, [, landFlag, ...])</tt> ====
-Places a [Sprites sprite] at the specified position (`x`, `y`) on the map, it behaves like terrain then. `frameIdx` is the frame index starting by 0. This is used if the sprite consists of several sub-images. Only a subset of the sprites is currently supported by this function:
+Places a [Sprites sprite] at the specified position (`x`, `y`) on the map, it behaves like terrain then. `frameIdx` is the frame index starting by 0. The placement may fail, for example if the sprite goes too far out of the land boundaries. The function returns `true` if the placement was successful, `false` otherwise.
+`frameIdx` is used if the sprite consists of several sub-images. Only a subset of the sprites is currently supported by this function:
 
  * `sprAmGirder`
  * `sprAmRubber`