# getElementBoneRotation (Cliente)

> Devolve a rotação de um osso de um ped ou objeto em relação ao osso pai, em graus.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Componentes e ossos
- **URL**: https://wiki.mymp.gg/pt/getElementBoneRotation

## Sintaxe

```lua
vec3|false getElementBoneRotation(ped|object element, int|string bone)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `ped\|object` | O ped, jogador ou objeto. Um objeto precisa ter um modelo com esqueleto ou árvore de nós. |
| `bone` | `int\|string` | O osso. Num ped: um id de osso do MTA, a tag de um osso do rig ou o nome dele. Num objeto: o nome de um nó ou a tag de um osso. |

## Retorno

Um `vec3` com `yaw, pitch, roll` em graus, ou `false` se o elemento está fora do alcance de streaming ou o osso não tem pose.

## Exemplo

```lua
local rotation = getElementBoneRotation(localPlayer, 5)
if rotation then
    outputDebugString(("Head: yaw %.1f, pitch %.1f, roll %.1f"):format(rotation.x, rotation.y, rotation.z))
end
```

### Vindo do MTA

No MTA só funciona com peds e devolve três números. Aqui também aceita objetos e ossos do rig por tag ou nome.

### Atenção

Dá erro se o osso não existe no elemento. Enquanto o elemento está fora do alcance de streaming, devolve `false`.

## Veja também

- [setElementBoneRotation (Cliente)](https://wiki.mymp.gg/pt/setElementBoneRotation.md): Gira um osso de um ped ou objeto em relação ao osso pai. A mudança vale só neste cliente.
- [getElementBoneQuaternion (Cliente)](https://wiki.mymp.gg/pt/getElementBoneQuaternion.md): Devolve a orientação de um osso de um ped ou objeto em relação ao osso pai, como quatérnio.
- [getElementBoneMatrix (Cliente)](https://wiki.mymp.gg/pt/getElementBoneMatrix.md): Devolve a matriz de um osso de um ped ou objeto no mundo.