# CFX::GET_PED_BONE_MATRIX

- **Hash:** `0x9C5E7C9C`
- **Namespace:** CFX
- **Runtime name (Lua/JS):** `GetPedBoneMatrix`
- **Side:** client (Cfx runtime native)
- **Name status:** official
- **Documentation:** described with examples
- **URL:** https://natives.borderlinerp.com/natives/CFX/GET_PED_BONE_MATRIX

## Signature

```c
void GET_PED_BONE_MATRIX(Ped ped, int boneId, Vector3* forwardVector, Vector3* rightVector, Vector3* upVector, Vector3* position);
```

## Parameters

- `ped` (`Ped`)
- `boneId` (`int`)
- `forwardVector` (`Vector3*`)
- `rightVector` (`Vector3*`)
- `upVector` (`Vector3*`)
- `position` (`Vector3*`)

## Returns

`void` — *   **forwardVector**:
*   **rightVector**:
*   **upVector**:
*   **position**:

## Description

*Source: Cfx.re native reference*

Returns the bone matrix of the specified bone id. usefull for entity attachment

## Usage

### Lua

```lua
local forwardVector, rightVector, upVector, position = GetPedBoneMatrix(ped, boneId)

-- always available, by hash
local forwardVector, rightVector, upVector, position = Citizen.InvokeNative(0x9c5e7c9c, ped, boneId, Citizen.PointerValueVector(), Citizen.PointerValueVector(), Citizen.PointerValueVector(), Citizen.PointerValueVector())
```

### JavaScript

```js
const [forwardVector, rightVector, upVector, position] = GetPedBoneMatrix(ped, boneId);

// by hash
const [forwardVector, rightVector, upVector, position] = Citizen.invokeNative('0x9c5e7c9c', ped, boneId, Citizen.pointerValueVector(), Citizen.pointerValueVector(), Citizen.pointerValueVector(), Citizen.pointerValueVector());
```

### C#

```csharp
var forwardVector = new OutputArgument();
var rightVector = new OutputArgument();
var upVector = new OutputArgument();
var position = new OutputArgument();
Function.Call((Hash)0x9c5e7c9c, ped, boneId, forwardVector, rightVector, upVector, position);
// forwardVector.GetResult<Vector3>()
// rightVector.GetResult<Vector3>()
// upVector.GetResult<Vector3>()
// position.GetResult<Vector3>()
```

- Pointer (out) arguments are not passed in Lua/JS: their values are returned after the result, in order.

## Examples

*Source: Cfx.re native reference*

```lua
local fowardVector, rightVector, upVector, position = GetPedBoneMatrix(PlayerPedId(),boneId)
```

*Sources: Cfx.re native reference.*