# engineSetWorldOverlay (Cliente)

> Desenha um material como uma camada a mais por cima dos materiais escolhidos de todos os modelos do mundo.

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

## Sintaxe

```lua
bool engineSetWorldOverlay(int|string selector, material material [, string targets = world vehicle, int priority = 0, int order = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `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. |
| `targets` | `string` | Que modelos alcança: `world`, `vehicle` e `ped`, separados por espaço ou vírgula. *(padrão: `world vehicle`)* |
| `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 snow = engineCreateMaterial("surface_alpha")
engineSetWorldOverlay("*grass*", snow, "world", 0, 1)
```

## Veja também

- [engineRestoreWorldOverlay (Cliente)](https://wiki.mymp.gg/pt/engineRestoreWorldOverlay.md): Desfaz o que engineSetWorldOverlay deste recurso fez de todos os modelos do mundo.
- [engineSetWorldMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldMaterial.md): Substitui os materiais escolhidos de todos os modelos do mundo por um material.
- [engineSetModelOverlay (Cliente)](https://wiki.mymp.gg/pt/engineSetModelOverlay.md): Desenha um material como uma camada a mais por cima dos materiais escolhidos de todas as instâncias de um modelo.
- [engineCreateMaterial (Cliente)](https://wiki.mymp.gg/pt/engineCreateMaterial.md): Cria um material: um shader com valores de parâmetros, que depois substitui ou se sobrepõe aos materiais dos modelos.