Difference between revisions of "Osiris/API/GetPosition"

From Divinity Engine Wiki
Jump to: navigation, search
(Created page with "===== Full Definition(s) ===== * query '''GetPosition'''('''''[in]'''(GUIDSTRING)'''''_Target''', '''''[out]'''(REAL)'''''_X''', '''''[out]'''(REAL)'''''_Y''', '''''[out]'''(R...")
 
m
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
* query '''GetPosition'''('''''[in]'''(GUIDSTRING)'''''_Target''', '''''[out]'''(REAL)'''''_X''', '''''[out]'''(REAL)'''''_Y''', '''''[out]'''(REAL)'''''_Z''')
 
* query '''GetPosition'''('''''[in]'''(GUIDSTRING)'''''_Target''', '''''[out]'''(REAL)'''''_X''', '''''[out]'''(REAL)'''''_Y''', '''''[out]'''(REAL)'''''_Z''')
 
===== Description =====
 
===== Description =====
Returns the position of the '''_Target''', with '''_Y''' being the vertical coordinate.
+
Returns the position of the '''_Target''', with '''_Y''' being the vertical coordinate. It works on any kind of game object.
 
===== Return Values =====
 
===== Return Values =====
* '''Success/Failure''': Fails if '''Target''' does not exist.
+
* '''Success/Failure''': Fails if '''_Target''' does not exist.
* '''_X''': X coordinate of the object created.
+
* '''_X''': X coordinate of '''_Target'''.
* '''_Y''': Y coordinate of the object created.
+
* '''_Y''': Y coordinate of '''_Target'''.
* '''_Z''': Z coordinate of the object created.
+
* '''_Z''': Z coordinate of '''_Target'''.
 
===== Notes =====
 
===== Notes =====
* /
+
* If '''_Target''' is an item and the item is inside the inventory of a character or a container, this call returns the position of the character/outermost container.
  
 +
===== See Also =====
 +
* [[Osiris/API/ItemToTransform|ItemToTransform]]
 +
* [[Osiris/API/GetRotation|GetRotation]]
 
    
 
    
 
[[Category:Osiris Queries|GetPosition]]
 
[[Category:Osiris Queries|GetPosition]]

Latest revision as of 12:43, 23 February 2018

Full Definition(s)
  • query GetPosition([in](GUIDSTRING)_Target, [out](REAL)_X, [out](REAL)_Y, [out](REAL)_Z)
Description

Returns the position of the _Target, with _Y being the vertical coordinate. It works on any kind of game object.

Return Values
  • Success/Failure: Fails if _Target does not exist.
  • _X: X coordinate of _Target.
  • _Y: Y coordinate of _Target.
  • _Z: Z coordinate of _Target.
Notes
  • If _Target is an item and the item is inside the inventory of a character or a container, this call returns the position of the character/outermost container.
See Also