SetElementBoneQuaternion: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Add documentation)
 
m (Stylistic corrections)
Line 31: Line 31:
===Returns===
===Returns===
Returns ''true'' if the set was successful, otherwise returns an error message and returns ''false''.
Returns ''true'' if the set was successful, otherwise returns an error message and returns ''false''.
==Requirements==
{{Requirements|n/a|1.6.0-9.22722}}


==Example==  
==Example==  
<section name="Client" class="client" show="true">
This example rotates the player's head 180 degrees around an arbitrary axis.<br/>
This example rotates the player's head 180 degrees around an arbitrary axis.<br/>
The use of [[updateElementRpHAnim]] is necessary here as it applies the rotation.
The use of [[updateElementRpHAnim]] is necessary here as it applies the rotation.
Line 51: Line 47:
)
)
</syntaxhighlight>
</syntaxhighlight>
</section>
 
==Requirements==
{{Requirements|n/a|1.6.0-9.22722}}


==See Also==
==See Also==
{{Client_element_functions}}
{{Client_element_functions}}

Revision as of 10:16, 16 September 2024

ADDED/UPDATED IN VERSION 1.6.0 r22722:

This function determines how a particular bone rotates in relation to the element.
The use of quaternions are more effective and do not generate issues like gimbal lock that might arise with Euler angles, so they are a preferable choice for rotation.


[[{{{image}}}|link=|]] Tip: If you want to attach an element to a bone, see attachElementToBone.
[[{{{image}}}|link=|]] Note: If you want to apply the rotation, updateElementRpHAnim must be called after this function.

Syntax

bool setElementBoneQuaternion(element ped, int bone, float x, float y, float z, float w)

Required Arguments

  • ped: The element (ped or player) on which the bone's rotation will be set.
  • bone: The ID of the bone to set the quaternion of.
  • The bone ID corresponds to specific body parts like arms, legs, spine, head, etc.
  • The full list of bones is available in the Bone IDs reference.
  • x: The quaternion's coefficient of the 𝑖 component.
  • This represents the rotation around the x-axis and is the first imaginary part of the quaternion.
  • y: The quaternion's coefficient of the 𝑗 component.
  • This represents the rotation around the y-axis and is the second imaginary part of the quaternion.
  • z: The quaternion's coefficient of the 𝑘 component.
  • This represents the rotation around the z-axis and is the third imaginary part of the quaternion.
  • w: The real part of the quaternion.
  • This denotes the scalar component of the quaternion, which is linked to the angle of rotation.
  • The w value is derived by taking the cosine of half of the rotation angle, defined as the overall angle of rotation.

Returns

Returns true if the set was successful, otherwise returns an error message and returns false.

Example

This example rotates the player's head 180 degrees around an arbitrary axis.
The use of updateElementRpHAnim is necessary here as it applies the rotation. 

local playerBone = 1
local playerBoneX, playerBoneY, playerBoneZ = 0.577, 0.577, 0.577
local playerBoneW = 0

addEventHandler("onClientPedsProcessed", root,
    function()
        setElementBoneQuaternion(localPlayer, playerBone, playerBoneX, playerBoneY, playerBoneZ, playerBoneW)
        updateElementRpHAnim(localPlayer)
    end
)

Requirements

This template will be deleted.

See Also



Retrieved from "https://wiki.multitheftauto.com/wiki/SetElementBoneQuaternion?oldid=80583"