GetElementBoneMatrix: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 18: Line 18:


==Example==  
==Example==  
<lua>addCommandHandler ("getbonematrix",
addCommandHandler ("getbonematrix",
function(commandName, boneID)
function(commandName, boneID)
     local matrix = {getElementBoneMatrix(localPlayer, boneID)}
     local matrix = {getElementBoneMatrix(localPlayer, boneID)}
     iprint(matrix[1])
     iprint(matrix[1])
end)
end)
</lua>
<sub>function</sub>


==Requirements==
==Requirements==

Revision as of 17:59, 8 October 2021

This function returns 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

table getElementBoneMatrix ( element theElement, int boneId )

Required Arguments

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

Returns

Returns a multi-dimensional array (which can be transformed into a proper matrix class using Matrix.create method) containing a 4x4 matrix. Returns false if invalid arguments were passed.

Example

addCommandHandler ("getbonematrix", function(commandName, boneID)

   local matrix = {getElementBoneMatrix(localPlayer, boneID)}
   iprint(matrix[1])

end) function

Requirements

Minimum server version n/a
Minimum client version 1.5.8-9.20704

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.5.8-9.20704" />

See Also