# setVehicleDoorOpenRatio (Compartilhado)

> Abre ou fecha uma ou mais portas de um veículo até uma fração, de uma vez ou aos poucos.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Veículos
- **URL**: https://wiki.mymp.gg/pt/setVehicleDoorOpenRatio

## Sintaxe

```lua
bool setVehicleDoorOpenRatio(element vehicle, int|string|table door, float ratio [, int time = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `vehicle` | `element` | O veículo, ou um elemento pai cujos veículos mudam todos. |
| `door` | `int\|string\|table` | Qual porta: o número (0 a tampa da frente, 1 a de trás, 2 e 3 as portas da frente do lado do motorista e do passageiro, 4 e 5 as de trás), o nome do frame (`door_dside_f`; `left` e `right` no lugar de `dside` e `pside` seguem o lado de direção do veículo), um grupo (`all`, `side_doors`, `front_doors`, `rear_doors`, `left_doors`, `right_doors`), `-1` para todas ou uma tabela com vários deles. |
| `ratio` | `float` | De 0 (fechada) a 1 (toda aberta). Valores fora disso são limitados. |
| `time` | `int` | Tempo em milissegundos para chegar lá. 0 move na hora. *(padrão: `0`)* |

## Retorno

`true` se alguma porta foi movida, `false` se o veículo não tem a porta.

Dado um elemento pai, como `root`, vale para todos os veículos abaixo dele, mas o valor devolvido é o do próprio elemento: `false` quando ele não é um veículo.

## Exemplo

```lua
addCommandHandler("capo", function(player)
    local vehicle = getPedOccupiedVehicle(player)
    if vehicle then
        setVehicleDoorOpenRatio(vehicle, 0, 1, 1500)
    end
end)
```

## Veja também

- [getVehicleDoorOpenRatio (Compartilhado)](https://wiki.mymp.gg/pt/getVehicleDoorOpenRatio.md): Devolve quanto uma ou mais portas de um veículo estão abertas.
- [setVehicleDoorState (Compartilhado)](https://wiki.mymp.gg/pt/setVehicleDoorState.md): Muda o estado de uma ou mais portas de um veículo: fechada, aberta, amassada ou arrancada.