# engineLoadTxd (Cliente)

> Carrega um dicionário de texturas (`.ktd`) de um arquivo do recurso com um nome. Ele existe só neste cliente.

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

## Sintaxe

```lua
txd engineLoadTxd(string path [, string name = the file's name without its extension])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `path` | `string` | Caminho do arquivo `.ktd` no recurso. |
| `name` | `string` | Nome do dicionário. *(padrão: `the file's name without its extension`)* |

## Retorno

O novo elemento `txd`. Lança um erro se o txd de outro script já tiver esse nome ou se o arquivo não for encontrado.

Se um pack já tiver um txd com esse nome, o carregado o cobre enquanto existir, e um aviso é registrado no log.

## Exemplo

```lua
local txd = engineLoadTxd("models/u6car.ktd")

addEventHandler("onClientAssetLoad", txd, function(loaded)
    if loaded then
        engineSetModelTxd("infernus", txd)
    end
end)
```

### Atenção

O arquivo é lido em segundo plano, então o txd fica vazio até `onClientAssetLoad` disparar nele. Se o arquivo não puder ser lido, o evento recebe `false`.

## Veja também

- [engineCreateTxd (Cliente)](https://wiki.mymp.gg/pt/engineCreateTxd.md): Cria um dicionário de texturas vazio com um nome. Preencha-o com engineSetTxdTexture. Ele existe só neste cliente.
- [engineSetModelTxd (Cliente)](https://wiki.mymp.gg/pt/engineSetModelTxd.md): Coloca um txd na frente do txd do próprio modelo, para que o modelo procure suas texturas nele primeiro e use o seu para o resto.
- [engineGetTxdTextures (Cliente)](https://wiki.mymp.gg/pt/engineGetTxdTextures.md): Lista os nomes das texturas que um txd dá, incluindo os links.
- [onClientAssetLoad (Cliente)](https://wiki.mymp.gg/pt/onClientAssetLoad.md): Disparado uma vez quando um asset que um script começou a carregar em segundo plano fica pronto, ou falha.
