# engineSetElementStencil (Cliente)

> Marca un vehículo, ped u objeto con un valor de stencil, que los shaders de posprocesado leen para contornos, resaltados y efectos parecidos.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Materiales y shaders
- **URL**: https://wiki.mymp.gg/es/engineSetElementStencil

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `element` | `element` | Un vehículo, ped, jugador u objeto. |
| `value` | `int` | La marca, un entero de 1 a 255. |
| `seeThrough` | `bool` | Una señal más que los shaders de posprocesado leen con `stencil_see_through`. *(por defecto: `false`)* |
| `priority` | `int` | Cuando varios recursos marcan el mismo objetivo, gana la mayor prioridad; entre iguales, el más reciente. *(por defecto: `0`)* |

## Retorno

`true` cuando se aplicó la marca.

## Ejemplo

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

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

### Atención

El valor acepta de 1 a 255, pero los shaders de posprocesado leen solo sus 7 bits bajos (`stencil` da de 0 a 127): desde 128 se pierde el bit alto, y 128 queda sin marca. Un elemento que no es vehículo, ped, jugador u objeto es un error.

## Ver también

- [engineGetElementStencil (Cliente)](https://wiki.mymp.gg/es/engineGetElementStencil.md): Indica con qué valor de stencil está marcado un vehículo, ped u objeto.
- [engineRestoreElementStencil (Cliente)](https://wiki.mymp.gg/es/engineRestoreElementStencil.md): Quita la marca de stencil que este recurso puso con engineSetElementStencil.
- [engineSetModelStencil (Cliente)](https://wiki.mymp.gg/es/engineSetModelStencil.md): Marca todas las instancias de un modelo con un valor de stencil, que los shaders de posprocesado leen para contornos, resaltados y efectos parecidos.
- [engineAddPostProcess (Cliente)](https://wiki.mymp.gg/es/engineAddPostProcess.md): Activa un posprocesado en la pantalla: un material cuyo shader es #type post.