# engineSetModelOverlay (Cliente)

> Desenha um material como uma camada a mais por cima dos materiais escolhidos de todas as instâncias de um modelo.

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

## Sintaxe

```lua
bool engineSetModelOverlay(string|element model, int|string selector, material material [, int priority = 0, int order = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `model` | `string\|element` | O nome do modelo ou um elemento `model`. |
| `selector` | `int\|string` | Qual material: o índice a partir de 1 ou o nome, como `engineGetModelMaterials` os lista. O nome não diferencia maiúsculas e aceita os curingas `*` e `?`. |
| `material` | `material` | O material desenhado por cima. |
| `priority` | `int` | Desempata camadas com a mesma ordem: a de maior prioridade é desenhada depois. *(padrão: `0`)* |
| `order` | `int` | A ordem entre as camadas do mesmo material, da menor para a maior. *(padrão: `0`)* |

## Retorno

`true` quando foi aplicado.

Todas as camadas que escolhem um material são desenhadas, por ordem e depois por prioridade.

## Exemplo

```lua
local dirt = engineCreateMaterial("surface_alpha")
engineSetMaterialValue(dirt, "roughnessFactor", 1)
engineSetModelOverlay("bobcat", 1, dirt, 0, 1)
```

### Atenção

Um nome que não é de modelo é um erro.

## Veja também

- [engineRestoreModelOverlay (Cliente)](https://wiki.mymp.gg/pt/engineRestoreModelOverlay.md): Desfaz o que engineSetModelOverlay deste recurso fez de todas as instâncias de um modelo.
- [engineSetModelMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetModelMaterial.md): Substitui os materiais escolhidos de todas as instâncias de um modelo por um material.
- [engineSetWorldOverlay (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldOverlay.md): Desenha um material como uma camada a mais por cima dos materiais escolhidos de todos os modelos do mundo.
- [engineGetModelMaterials (Cliente)](https://wiki.mymp.gg/pt/engineGetModelMaterials.md): Lista os materiais do modelo carregado, na ordem em que o modelo os guarda.