# engineSetTxdTexture (Cliente)

> Coloca uma imagem num txd sob um nome de textura, substituindo a textura com esse nome ou acrescentando uma nova. Tudo que lê o txd acompanha: modelos, peds, landscapes, ruas, partículas, água e céu.

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

## Sintaxe

```lua
bool engineSetTxdTexture(txd|string txd, string name, texture|dui|bool source [, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `txd` | `txd\|string` | Um elemento `txd`, o nome de um txd, ou um padrão glob que pega vários txds. |
| `name` | `string` | Nome da textura, ou um padrão glob. |
| `source` | `texture\|dui\|bool` | Uma `texture` (textura de arquivo, render target, screen source ou textura de txd), um `dui`, ou `false` para esconder a textura. |
| `priority` | `int` | Entre vários links para a mesma textura, a maior prioridade vale; entre iguais, o mais novo. *(padrão: `0`)* |

## Retorno

`true` quando o link é criado. Lança um erro se o txd não existir ou se a fonte não for uma imagem ou `false`.

Um link para uma textura de txd segue os links desse txd, até 8 níveis. Os links do recurso somem quando ele para ou quando `engineRestoreTxdTexture` os remove.

## Exemplo

```lua
local plate = engineCreateTexture("images/plate.png")
engineSetTxdTexture("infernus", "vehiclelights128", plate)
engineSetTxdTexture("*", "graffiti*", false)
```

## Veja também

- [engineRestoreTxdTexture (Cliente)](https://wiki.mymp.gg/pt/engineRestoreTxdTexture.md): Remove os links que este recurso criou num txd com engineSetTxdTexture, para que ele volte a dar suas próprias texturas.
- [engineGetTxdTexture (Cliente)](https://wiki.mymp.gg/pt/engineGetTxdTexture.md): Dá um elemento texture que mostra o que um txd mostra sob um nome de textura, para desenhá-lo ou usá-lo como fonte.
- [engineSetModelTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetModelTexture.md): Troca uma textura em todas as instâncias de um modelo. Só os materiais desse modelo mudam, não o txd de onde a textura vem.
- [engineSetWorldTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldTexture.md): Troca uma textura em todos os modelos dos tipos escolhidos que a usam. Só os materiais dos modelos mudam, não o txd de onde a textura vem.