# engineSetMaterialValue (Cliente)

> Define un valor del material: un parámetro del shader, un interruptor estático o el render target de una salida `TARGET_n`.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Materiales y shaders
- **URL**: https://wiki.mymp.gg/es/engineSetMaterialValue

## Sintaxis

```lua
bool engineSetMaterialValue(material material, string name, any value)
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `material` | `material` | El material. |
| `name` | `string` | El nombre del parámetro, del interruptor o de la salida. |
| `value` | `any` | Un número para `float` y `uint`; un vector para `vec2`, `vec3` y `vec4`, o un valor de `tocolor` para `vec3` y `vec4` (convertido de sRGB a lineal); el nombre de una textura o una imagen (textura, render target, screen source, dui o imagen de posprocesado) para una textura; un booleano para un interruptor; un render target para `TARGET_n`. |

## Retorno

`true` cuando el valor se definió.

## Ejemplo

```lua
local screen = dxCreateRenderTarget(512, 256)
local material = engineCreateMaterial("surface")
engineSetMaterialValue(material, "emissionMap", screen)
engineSetMaterialValue(material, "roughnessFactor", 0.1)
engineSetModelMaterial("kmb_atm1", 1, material)
```

### Atención

Un nombre que el shader no declara es un error, igual que un valor del tipo equivocado. Mientras el shader aún compila, el tipo se toma del valor Lua.

## Ver también

- [engineGetMaterialValue (Cliente)](https://wiki.mymp.gg/es/engineGetMaterialValue.md): Lee un valor que define el material: un parámetro, un interruptor estático o una salida TARGET_n.
- [engineResetMaterialValue (Cliente)](https://wiki.mymp.gg/es/engineResetMaterialValue.md): Deshace un valor que definió el material, o todos, y vuelve a lo que da su base.
- [engineGetMaterialParameters (Cliente)](https://wiki.mymp.gg/es/engineGetMaterialParameters.md): Lista los parámetros del shader que usa un material.
- [dxCreateRenderTarget (Cliente)](https://wiki.mymp.gg/es/dxCreateRenderTarget.md): Crea un render target: una imagen en la que las funciones dx pueden dibujar y que se puede usar como cualquier otra imagen.