Osiris/API/GetRotation

From Divinity Engine Wiki
Revision as of 16:00, 31 January 2018 by Tinkerer (talk | contribs)
Jump to: navigation, search
Full Definition(s)
  • query GetRotation([in](GUIDSTRING)_Target, [out](REAL)_X, [out](REAL)_Y, [out](REAL)_Z)
Description

Returns the rotation of the _Target as rotations around the X, Y and Z axes (Y = vertical axis). It works on any kind of game object.

Return Values
  • Success/Failure: Fails if _Target does not exist.
  • _X: Rotation in degrees of _Target around the X axis.
  • _Y: Rotation in degrees of _Target around the Y axis. This angle is offset 90 degrees from the X-axis (i.e., if a character faces in the same direction as the X-axis, the result of this call will be -90).
  • _Z: Rotation in degrees of _Target around the Z axis.
Notes
  • If _Target is an item and the item is inside the inventory of a character or a container, this call returns the rotation of the character/outermost container.
  • The results of this call correspond to the Xr, Yr and Zr values you can see in the editor when selecting an object (as long as it hasn't rotated since the game started).
  • All returned angles are in the interval [-180, 360].
See Also
Retrieved from "https://docs.larian.game/index.php?title=Osiris/API/GetRotation&oldid=5450"