# engineSetModelStencil (Cliente)

> Marca todas las instancias de un modelo 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/engineSetModelStencil

## Sintaxis

```lua
bool engineSetModelStencil(string|element model, int value [, bool seeThrough = false, int priority = 0])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `model` | `string\|element` | El nombre del modelo o un elemento `model`. |
| `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)
engineSetModelStencil("kmb_atm1", 3, true)
```

### 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 nombre que no es de modelo es un error.

## Ver también

- [engineGetModelStencil (Cliente)](https://wiki.mymp.gg/es/engineGetModelStencil.md): Indica con qué valor de stencil está marcado un modelo.
- [engineRestoreModelStencil (Cliente)](https://wiki.mymp.gg/es/engineRestoreModelStencil.md): Quita la marca de stencil que este recurso puso con engineSetModelStencil.
- [engineSetElementStencil (Cliente)](https://wiki.mymp.gg/es/engineSetElementStencil.md): Marca un vehículo, ped u objeto 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.
