# dxConvertPixels (Cliente)

> Convierte una imagen guardada en un string a otro formato, en segundo plano, y entrega el resultado a una función.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Dibujo en pantalla
- **URL**: https://wiki.mymp.gg/es/dxConvertPixels

## Sintaxis

```lua
bool dxConvertPixels(string pixels, string format, function callback [, int quality = 80])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `pixels` | `string` | Los píxeles. |
| `format` | `string` | Formato de destino: `plain`, `png` o `jpeg`. |
| `quality` | `int` | Calidad del `jpeg`, de 0 a 100. *(por defecto: `80`)* |
| `callback` | `function` | Recibe los píxeles convertidos, o `false` si la conversión falló. |

## Retorno

`true` si la conversión empezó. `false` si el formato de origen no se reconoció o si la conversión es desde o hacia `dds`.

## Ejemplo

```lua
local target = dxCreateRenderTarget(256, 256)

dxGetTexturePixels(target, function(pixels)
    if not pixels then return end
    dxConvertPixels(pixels, "jpeg", 90, function(jpeg)
        if jpeg then
            local file = fileCreate("snapshot.jpg")
            fileWrite(file, jpeg)
            fileClose(file)
        end
    end)
end)
```

### Si vienes de MTA

En MTA el resultado se devuelve al instante. En MYMP llega a una función, porque la conversión corre en un hilo de trabajo.

## Ver también

- [dxGetTexturePixels (Cliente)](https://wiki.mymp.gg/es/dxGetTexturePixels.md): Lee los píxeles de una imagen y los entrega a una función, unos fotogramas después.
- [dxGetPixelsFormat (Cliente)](https://wiki.mymp.gg/es/dxGetPixelsFormat.md): Detecta el formato de una imagen guardada en un string.
- [dxSetTexturePixels (Cliente)](https://wiki.mymp.gg/es/dxSetTexturePixels.md): Escribe píxeles en una textura creada por script o en un render target.