# engineSetElementStencil (Cliente)

> Marca um veículo, ped ou objeto com um valor de stencil, que os shaders de pós-processamento leem para contornos, destaques e efeitos parecidos.

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

## Sintaxe

```lua
bool engineSetElementStencil(element element, int value [, bool seeThrough = false, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | Um veículo, ped, jogador ou objeto. |
| `value` | `int` | A marca, um inteiro de 1 a 255. |
| `seeThrough` | `bool` | Um sinal a mais que os shaders de pós-processamento leem com `stencil_see_through`. *(padrão: `false`)* |
| `priority` | `int` | Quando vários recursos marcam o mesmo alvo, vence a maior prioridade; entre iguais, o mais recente. *(padrão: `0`)* |

## Retorno

`true` quando a marca foi aplicada.

## Exemplo

```lua
local outline = engineCreateMaterial(engineCreateShader("shaders/outline.shader"))
engineAddPostProcess(outline)

local vehicle = createVehicle("infernus", 2495.0, -1680.0, 13.4)
engineSetElementStencil(vehicle, 1)
```

### Atenção

O valor aceita 1 a 255, mas os shaders de pós-processamento leem só os 7 bits de baixo (`stencil` dá 0 a 127): de 128 em diante o bit de cima se perde, e 128 fica sem marca. Um elemento que não é veículo, ped, jogador ou objeto é um erro.

## Veja também

- [engineGetElementStencil (Cliente)](https://wiki.mymp.gg/pt/engineGetElementStencil.md): Diz com que valor de stencil um veículo, ped ou objeto está marcado.
- [engineRestoreElementStencil (Cliente)](https://wiki.mymp.gg/pt/engineRestoreElementStencil.md): Tira a marca de stencil que este recurso pôs com engineSetElementStencil.
- [engineSetModelStencil (Cliente)](https://wiki.mymp.gg/pt/engineSetModelStencil.md): Marca todas as instâncias de um modelo com um valor de stencil, que os shaders de pós-processamento leem para contornos, destaques e efeitos parecidos.
- [engineAddPostProcess (Cliente)](https://wiki.mymp.gg/pt/engineAddPostProcess.md): Liga um pós-processamento na tela: um material cujo shader é #type post.