SetElementBoneMatrix: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Remove obsolete Requirements section)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Client function}}
{{Client function}}
__NOTOC__  
__NOTOC__  
{{New feature/item|3.0159|1.5.8|20704|This function sets the transformation matrix of a specific bone. Currently the following element types are accepted:
{{Added feature/item|1.5.9|1.5.8|20704|This function sets the transformation matrix of a specific bone. Currently the [[Element/Player|Player]] and [[Element/Ped|Ped]] element types are accepted.}}
* [[Element/Player|Player]]
{{Tip|If you want to attach an element to a bone, see [[attachElementToBone]].}}
* [[Element/Ped|Ped]]
}}
{{Tip|If you want to attach an element to a bone, see [[attachElementToBone]]}}
{{Tip|For [[matrix]] manipulation which goes beyond the basic examples given on this page, see the [[Lua matrix library]]. Using the built-in [[matrix]] class is also recommended.}}
{{Tip|For [[matrix]] manipulation which goes beyond the basic examples given on this page, see the [[Lua matrix library]]. Using the built-in [[matrix]] class is also recommended.}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setElementBoneMatrix ( element theElement, int bone, matrix matrix )
bool setElementBoneMatrix ( element theElement, int boneId, matrix matrix )
</syntaxhighlight>
</syntaxhighlight>


===Required Arguments===  
===Required Arguments===  
*'''theElement:''' the element to set the bone matrix on.
*'''theElement:''' the [[element]] to set the bone matrix on.
*'''bone:''' the ID of the bone. See [[Bone IDs]]
*'''boneId:''' the ID of the bone. See [[Bone IDs]].
*'''matrix:''' the MTA [[matrix]] to set.
*'''matrix:''' the MTA [[matrix]] to set.



Latest revision as of 17:24, 7 November 2024

This function sets the transformation matrix of a specific bone. Currently the Player and Ped element types are accepted.

[[{{{image}}}|link=|]] Tip: If you want to attach an element to a bone, see attachElementToBone.
[[{{{image}}}|link=|]] Tip: For matrix manipulation which goes beyond the basic examples given on this page, see the Lua matrix library. Using the built-in matrix class is also recommended.

Syntax

bool setElementBoneMatrix ( element theElement, int boneId, matrix matrix )

Required Arguments

  • theElement: the element to set the bone matrix on.
  • boneId: the ID of the bone. See Bone IDs.
  • matrix: the MTA matrix to set.

Returns

Returns true if the function was successful, false otherwise.

Example

Accessories-text-editor.png Script Example Missing Function SetElementBoneMatrix needs a script example, help out by writing one.

Before submitting check out Editing Guidelines Script Examples.


See Also