GetElementBonePosition

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

* FEATURE ADDED IN 1.5.9 (REVISION: r20704)
Returns the 3D world coordinates of a specific bone of a given element. Currently the Player and Ped element types are accepted.
[[{{{image}}}|link=|]] Tip: If you want to attach an element to a bone, see attachElementToBone.

Syntax

float, float, float getElementBonePosition ( element theElement, int boneId )

Required Arguments

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

Returns

Returns 3 floats, representing the X, Y, Z world position of the bone.

Example

This example outputs the X, Y, Z world position of the local player bone specified through a command:

function getBonePosition (commandName, boneId)
    if not tonumber (boneId) then
        outputChatBox ("You didn't insert an bone ID!", 255, 0, 0)
        return false
    end

    local x, y, z = getElementBonePosition (localPlayer, boneId)
    outputChatBox ("The bone position is: "..x..", "..y..", "..z)
end

addCommandHandler ("getboneposition", getBonePosition)

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

* FEATURE ADDED IN 1.5.9 (REVISION: r20704)
* FEATURE ADDED IN 1.5.9 (REVISION: r20704)
* FEATURE ADDED IN 1.5.9 (REVISION: r20704)