Lua: change obj.rotation from Euler angles to Quaternion

files/lua_api/openmw/core.lua

@@ -152,9 +152,9 @@
 -- @field #boolean enabled Whether the object is enabled or disabled. Global scripts can set the value. Items in containers or inventories can't be disabled.
 -- @field openmw.util#Vector3 position Object position.
 -- @field #number scale Object scale.
--- @field openmw.util#Vector3 rotation Object rotation (ZXY order).
+-- @field openmw.util#Transform rotation Object rotation.
 -- @field openmw.util#Vector3 startingPosition The object original position
--- @field openmw.util#Vector3 startingRotation The object original rotation
+-- @field openmw.util#Transform startingRotation The object original rotation
 -- @field #string ownerRecordId NPC who owns the object (nil if missing). Global and self scripts can set the value.
 -- @field #string ownerFactionId Faction who owns the object (nil if missing). Global and self scripts can set the value.
 -- @field #number ownerFactionRank Rank required to be allowed to pick up the object. Global and self scripts can set the value.
@@ -228,12 +228,12 @@
 -- @param #any cellOrName A cell to define the destination worldspace; can be either #Cell, or cell name, or an empty string (empty string means the default exterior worldspace).
 -- If the worldspace has multiple cells (i.e. an exterior), the destination cell is calculated using `position`.
 -- @param openmw.util#Vector3 position New position.
--- @param #TeleportOptions options (optional) Either table @{#TeleportOptions} or @{openmw.util#Vector3} rotation.
+-- @param #TeleportOptions options (optional) Either table @{#TeleportOptions} or @{openmw.util#Transform} rotation.
 
 ---
 -- Either table with options or @{openmw.util#Vector3} rotation.
 -- @type TeleportOptions
--- @field openmw.util#Vector3 rotation New rotation; if missing, then the current rotation is used.
+-- @field openmw.util#Transform rotation New rotation; if missing, then the current rotation is used.
 -- @field #boolean onGround If true, adjust destination position to the ground.
 
 ---

files/lua_api/openmw/types.lua

@@ -1333,7 +1333,7 @@
 -- Destination rotation (only if a teleport door).
 -- @function [parent=#Door] destRotation
 -- @param openmw.core#GameObject object
--- @return openmw.util#Vector3
+-- @return openmw.util#Transform
 
 ---
 -- Destination cell (only if a teleport door).
@@ -1443,7 +1443,7 @@
 -- Destination rotation (only if a teleport door).
 -- @function [parent=#ESM4Door] destRotation
 -- @param openmw.core#GameObject object
--- @return openmw.util#Vector3
+-- @return openmw.util#Transform
 
 ---
 -- Destination cell (only if a teleport door).

files/lua_api/openmw/util.lua

@@ -501,6 +501,33 @@
 -- @param #Vector3 v
 -- @return #Vector3
 
+---
+-- Get yaw angle (radians)
+-- @function [parent=#Transform] getYaw
+-- @param self
+-- @return #number
+
+---
+-- Get pitch angle (radians)
+-- @function [parent=#Transform] getPitch
+-- @param self
+-- @return #number
+
+---
+-- Get Euler angles for XZ rotation order (pitch and yaw; radians)
+-- @function [parent=#Transform] getAnglesXZ
+-- @param self
+-- @return #number pitch (rotation around X axis)
+-- @return #number yaw (rotation around Z axis)
+
+---
+-- Get Euler angles for ZYX rotation order (radians)
+-- @function [parent=#Transform] getAnglesZYX
+-- @param self
+-- @return #number rotation around Z axis (first rotation)
+-- @return #number rotation around Y axis (second rotation)
+-- @return #number rotation around X axis (third rotation)
+
 ---
 -- @type TRANSFORM
 -- @field [parent=#TRANSFORM] #Transform identity Empty transform.