Difference between revisions of "Osiris/API/GetRotation"
From Divinity Engine Wiki
m |
|||
| Line 6: | Line 6: | ||
* '''Success/Failure''': Fails if '''_Target''' does not exist. | * '''Success/Failure''': Fails if '''_Target''' does not exist. | ||
* '''_X''': Rotation in degrees of '''_Target''' around the X axis. | * '''_X''': Rotation in degrees of '''_Target''' around the X axis. | ||
| − | * '''_Y''': Rotation in degrees of '''_Target''' around the Y 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. | * '''_Z''': Rotation in degrees of '''_Target''' around the Z axis. | ||
===== Notes ===== | ===== Notes ===== | ||
Revision as of 15:43, 31 January 2018
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.
- All returned angles are in the interval [-180, 360].
