GetElementBoneQuaternion - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:35:20Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:35, 7 November 2024
Line 37:		Line 37:
	)		)
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.6.0-9.22741}}~~

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

Nico834: Add correct revision

2024-09-30T04:33:06Z

Add correct revision

← Older revision		Revision as of 04:33, 30 September 2024
Line 2:		Line 2:
	{{Client function}}		{{Client function}}

	{{New feature/item\|3.0161\|1.6.0\|~~22722~~\|		{{New feature/item\|3.0161\|1.6.0\|22741\|
	This function retrieves how a particular bone rotates in relation to the element.<br/>		This function retrieves how a particular bone rotates in relation to the element.<br/>
	The use of [https://en.wikipedia.org/wiki/Quaternion quaternions] are more effective and do not generate issues like gimbal lock that might arise with [https://en.wikipedia.org/wiki/Euler_angles Euler angles], so they are a preferable choice for rotation.		The use of [https://en.wikipedia.org/wiki/Quaternion quaternions] are more effective and do not generate issues like gimbal lock that might arise with [https://en.wikipedia.org/wiki/Euler_angles Euler angles], so they are a preferable choice for rotation.
Line 39:		Line 39:

	==Requirements==		==Requirements==
	{{Requirements\|n/a\|1.6.0-9.~~22722~~}}		{{Requirements\|n/a\|1.6.0-9.22741}}

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

FileEX: Stylistic corrections

2024-09-16T10:18:56Z

Stylistic corrections

← Older revision		Revision as of 10:18, 16 September 2024
Line 23:		Line 23:
	* '''z:''' The quaternion's coefficient of the 𝑘 component, representing rotation around the z-axis.		* '''z:''' The quaternion's coefficient of the 𝑘 component, representing rotation around the z-axis.
	* '''w:''' The real part of the quaternion, which is linked to the angle of rotation.		* '''w:''' The real part of the quaternion, which is linked to the angle of rotation.

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.6.0-9.22722}}~~

	==Example==		==Example==
	~~<section name="Client" class="client" show="true">~~
	This example retrieves the rotation of the player's head in quaternion.<br/>		This example retrieves the rotation of the player's head in quaternion.<br/>
	The retrieved values can be used for calculations.		The retrieved values can be used for calculations.
Line 41:		Line 37:
	)		)
	</syntaxhighlight>		</syntaxhighlight>
	</~~section>~~
			==Requirements==
			{{Requirements\|n/a\|1.6.0-9.22722}}

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

Nico834: Add documentation

2024-09-15T20:05:47Z

Add documentation

New page

__NOTOC__
{{Client function}}

{{New feature/item|3.0161|1.6.0|22722|
This function retrieves how a particular bone rotates in relation to the element.<br/>
The use of [https://en.wikipedia.org/wiki/Quaternion quaternions] are more effective and do not generate issues like gimbal lock that might arise with [https://en.wikipedia.org/wiki/Euler_angles Euler angles], so they are a preferable choice for rotation.
}}
==Syntax==
<syntaxhighlight lang="lua">
int, int, int, int getElementBoneQuaternion(element ped, int bone)
</syntaxhighlight>

===Required Arguments===
* '''ped:''' The [[element]] (ped or player) from which the bone's rotation will be retrieved.
* '''bone:''' The ID of the bone to retrieve 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.

===Returns===
Returns four float values:
* '''x:''' The quaternion's coefficient of the 𝑖 component, representing rotation around the x-axis.
* '''y:''' The quaternion's coefficient of the 𝑗 component, representing rotation around the y-axis.
* '''z:''' The quaternion's coefficient of the 𝑘 component, representing rotation around the z-axis.
* '''w:''' The real part of the quaternion, which is linked to the angle of rotation.

==Requirements==
{{Requirements|n/a|1.6.0-9.22722}}

==Example==
<section name="Client" class="client" show="true">
This example retrieves the rotation of the player's head in quaternion.<br/>
The retrieved values can be used for calculations.
<syntaxhighlight lang="lua">
local playerBone = 1
local playerBoneX, playerBoneY, playerBoneZ, playerBoneW

addEventHandler("onClientResourceStart", resourceRoot,
function()
playerBoneX, playerBoneY, playerBoneZ, playerBoneW = getElementBoneQuaternion(localPlayer, playerBone)
end
)
</syntaxhighlight>
</section>

==See Also==
{{Client_element_functions}}