# engineGetMaterialValue (Cliente)

> Lê um valor que o material define: um parâmetro, uma chave estática ou uma saída `TARGET_n`.

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

## Sintaxe

```lua
any engineGetMaterialValue(material material, string name)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `material` | `material` | O material. |
| `name` | `string` | O nome do parâmetro, da chave ou da saída. |

## Retorno

Um número, um vetor ou um inteiro, conforme o tipo do parâmetro. Uma textura dá o nome dela, ou `true` quando é uma imagem. Uma chave dá `true` ou `false` (o padrão do shader se não foi definida), e uma saída com render target dá `true`. `nil` quando o material não define esse nome.

## Exemplo

```lua
local material = engineCreateMaterial("surface")
engineSetMaterialValue(material, "roughnessFactor", 0.2)
outputDebugString(tostring(engineGetMaterialValue(material, "roughnessFactor")))
```

## Veja também

- [engineSetMaterialValue (Cliente)](https://wiki.mymp.gg/pt/engineSetMaterialValue.md): Define um valor do material: um parâmetro do shader, uma chave estática ou a render target de uma saída TARGET_n.
- [engineResetMaterialValue (Cliente)](https://wiki.mymp.gg/pt/engineResetMaterialValue.md): Desfaz um valor que o material definiu, ou todos, e volta ao que vem da base.
- [engineGetMaterialParameters (Cliente)](https://wiki.mymp.gg/pt/engineGetMaterialParameters.md): Lista os parâmetros do shader que um material usa.