Knuckle Cracker Wiki

User Tools

Site Tools

Trace:
4rpl:commands:getunitposition

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
4rpl:commands:getunitposition [2021/01/24 14:53] – added get/set tabs Sanian4rpl:commands:getunitposition [2022/07/16 12:55] – Noted V2.4 change. Karsten75
Line 13: Line 13:
 Get the 3D position of a unit.  A vector is returned.  The X and Z positions are where on the map the unit is, and the Y coordinate Get the 3D position of a unit.  A vector is returned.  The X and Z positions are where on the map the unit is, and the Y coordinate
 is the height, or elevation, of the unit. is the height, or elevation, of the unit.
 +
 +Note: If this call is attempted on an non-existing unit, nothing will be put on the stack. 
 +In V 2.4, this behavior changes and this API will now return V3(0 0 0), similar to other APIs. 
  
 ===== Examples ===== ===== Examples =====
Line 18: Line 21:
 GetUnitPosition(<-UID) ->pos GetUnitPosition(<-UID) ->pos
 </code> </code>
 +
 +
 +A "safe" method to use this function and to handle the lack of a return value on non-existent units  Are as follows:
 +
 +<code 4rpl>
 + Trace (@UnitPos(7) )
 +
 +:unitPos
 +    StackSize ->size
 +    GetUnitPosition
 +    If (Stacksize <-size NEQ)
 +        V3(-1 -1 -1)
 +    endif
 +</code>
 +
 <=[[4rpl:start| Index]] <=[[4rpl:start| Index]]
  
4rpl/commands/getunitposition.txt · Last modified: 2023/01/19 09:28 by Karsten75

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki