# setElementBoneRotation (Cliente)

> Gira um osso de um ped ou objeto em relação ao osso pai. A mudança vale só neste cliente.

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

## Sintaxe

```lua
bool setElementBoneRotation(ped|object element, int|string bone, float yaw, pitch, roll)
```

## 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. |
| `yaw, pitch, roll` | `float` | Ângulos em graus, em três números ou um `vec3`. |

## Retorno

`true` se girou. `false` se o elemento está fora do alcance de streaming, o osso não tem pose ou o ped está em ragdoll.

A pose de um ped e a de um objeto animado são refeitas a cada quadro: mude-as em `onClientPedsProcessed`, que dispara depois que as poses do quadro ficam prontas. Um objeto sem animação mantém o que foi definido. O que estiver anexado ao osso o acompanha.

## Exemplo

```lua
addEventHandler("onClientPedsProcessed", root, function()
    setElementBoneRotation(localPlayer, 5, 0, 30, 0)
end)
```

### Vindo do MTA

No MTA só funciona com peds. 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

- [getElementBoneRotation (Cliente)](https://wiki.mymp.gg/pt/getElementBoneRotation.md): Devolve a rotação de um osso de um ped ou objeto em relação ao osso pai, em graus.
- [setElementBoneQuaternion (Cliente)](https://wiki.mymp.gg/pt/setElementBoneQuaternion.md): Define a orientação de um osso de um ped ou objeto em relação ao osso pai, como quatérnio. A mudança vale só neste cliente.
- [onClientPedsProcessed (Cliente)](https://wiki.mymp.gg/pt/onClientPedsProcessed.md): Disparado a cada quadro depois que os peds e objetos foram animados, antes de serem apresentados e desenhados.