Entity::getRotation: Difference between revisions

Revision as of 15:34, 30 March 2021

Syntax

entity.getRotation(rotationOrder);

Required Arguments

rotationOrder: Int (specifies which axis rotates before the other axis in a certain order)

Rotation Orders

0: ZYX
1: YZX
2: ZXY
3: XZY
4: YXZ
5: XYZ

Return value

Vector3

Example

// todo

@@ Line 1: / Line 1: @@
-rotationOrder refers to the order yaw pitch roll is applied<br>value ranges from 0 to 5. What you use for rotationOrder when getting must be the same as rotationOrder when setting the rotation. <br>Unsure what value corresponds to what rotation order, more testing will be needed for that.<br>------<br>rotationOrder is usually 2 in scripts<br>------<br>ENTITY::GET_ENTITY_ROTATION(Any p0, false or true);<br>if false than return from -180 to 180<br>if true than return from -90 to 90<br><br>---<br><br>As said above, the value of p1 affects the outcome. R* uses 1 and 2 instead of 0 and 1, so I marked it as an int.<br><br>What it returns is the yaw on the z part of the vector, which makes sense considering R* considers z as vertical. Here's a picture for those of you who don't understand pitch, yaw, and roll:<br><br>www.allstar.fiu.edu/aero/images/pic5-1.gif<br><br>I don't know why it returns a Vec3, but sometimes the values x and y go negative, yet they're always zero. Just use GET_ENTITY_PITCH and GET_ENTITY_ROLL for pitch and roll.
 ==Syntax==
 <syntaxhighlight lang="javascript">entity.getRotation(rotationOrder);</syntaxhighlight>
 === Required Arguments ===
-*'''rotationOrder:''' int
+*'''rotationOrder:''' {{RageType|Int}} (specifies which axis rotates before the other axis in a certain order)
+==== Rotation Orders ====
+*0: '''ZYX'''
+*1: '''YZX'''
+*2: '''ZXY'''
+*3: '''XZY'''
+*4: '''YXZ'''
+*5: '''XYZ'''
 ===Return value===
 *'''Vector3'''
 ==Example==
 <syntaxhighlight lang="javascript">

Revision as of 15:34, 30 March 2021

Syntax

Required Arguments

Rotation Orders

Return value

Example

See also