SetElementBoneMatrix: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
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:
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]]
 
* [[Element/Ped|Ped]]
{{Tip|If you want to attach an element to a bone, see [[attachElementToBone]].}}
}}
{{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.


Line 23: Line 21:
==Example==  
==Example==  
{{Needs Example}}
{{Needs Example}}
==Requirements==
{{Requirements|n/a|1.5.8-9.20704|}}


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

Revision as of 15:10, 19 September 2021

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.


Requirements

This template will be deleted.

See Also