Declare GetVehicleRotation

this function is already present in docs and server implementation

Author: NexiusTailer

omp_vehicle.inc

@@ -599,20 +599,7 @@ native bool:GetVehicleZAngle(vehicleid, &Float:angle);
  * <param name="y">A float variable in which to store the third quaternion angle, passed by reference</param>
  * <param name="z">A float variable in which to store the fourth quaternion angle, passed by reference</param>
  * <seealso name="GetVehicleZAngle" />
- * <remarks>
- *   <b>To euler:</b><br />
- *   <code>
- *     // GetVehicleRotation Created by IllidanS4<br />
- *     stock GetVehicleRotation(vehicleid, &amp;Float:rx, &amp;Float:ry, &amp;Float:rz)<br />
- *     {<br />
- *         new Float:qw, Float:qx, Float:qy, Float:qz;<br />
- *         GetVehicleRotationQuat(vehicleid, qw, qx, qy, qz);<br />
- *         rx = asin((2 * qy * qz) - (2 * qx * qw));<br />
- *         ry = -atan2((qx * qz) + (qy * qw), 0.5 - (qx * qx) - (qy * qy));<br />
- *         rz = -atan2((qx * qy) + (qz * qw), 0.5 - (qx * qx) - (qz * qz));<br />
- *     }
- *   </code>
- * </remarks>
+ * <seealso name="GetVehicleRotation" />
  * <remarks>There is no 'set' variation of this function; you can not SET a vehicle's rotation (apart
  * from the <a href="#SetVehicleZAngle">z angle</a>) </remarks>
  * <remarks>This function may return incorrect values for unoccupied vehicles.  The reason is that the
@@ -625,6 +612,28 @@ native bool:GetVehicleZAngle(vehicleid, &Float:angle);
  */
 native bool:GetVehicleRotationQuat(vehicleid, &Float:w, &Float:x, &Float:y, &Float:z);
 
+/**
+ * <library>omp_vehicle</library>
+ * <summary>Returns a vehicle's rotation as euler.</summary>
+ * <param name="vehicleid">The ID of the vehicle to get the rotation of</param>
+ * <param name="x">A float variable in which to store the X axis angle, passed by reference</param>
+ * <param name="y">A float variable in which to store the Y axis angle, passed by reference</param>
+ * <param name="z">A float variable in which to store the Z axis angle, passed by reference</param>
+ * <seealso name="GetVehicleZAngle" />
+ * <seealso name="GetVehicleRotationQuat" />
+ * <seealso name="GetVehicleMatrix" />
+ * <remarks>There is no 'set' variation of this function; you can not SET a vehicle's rotation (apart
+ * from the <a href="#SetVehicleZAngle">z angle</a>) </remarks>
+ * <remarks>This function may return incorrect values for unoccupied vehicles.  The reason is that the
+ * third row of the vehicle's internal rotation matrix gets corrupted if it gets updated while unoccupied.
+ * </remarks>
+ * <returns>
+ *   <b><c>1</c></b>: The function executed successfully.<br />
+ *   <b><c>0</c></b>: The function failed to execute.  This means the vehicle specified does not exist.
+ * </returns>
+ */
+native bool:GetVehicleRotation(vehicleid, &Float:x, &Float:y, &Float:z);
+
 /**
  * <library>omp_vehicle</library>
  * <summary>This function can be used to calculate the distance (as a float) between a vehicle and another