# dxDrawImage (Cliente)

> Dibuja una imagen en la pantalla durante un fotograma.

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

## Sintaxis

```lua
bool dxDrawImage(float x, y, float width, height, texture|dui|string image [, float rotation = 0, float rotationCenterOffsetX, rotationCenterOffsetY = 0, 0, color color = tocolor(255, 255, 255), bool postGUI = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y` | `float` | Esquina superior izquierda en la pantalla, en píxeles. También acepta un vec2. |
| `width, height` | `float` | Tamaño en la pantalla, en píxeles. También acepta un vec2. |
| `image` | `texture\|dui\|string` | La imagen (textura, render target, screen source o dui) o la ruta de un archivo de imagen del recurso. |
| `rotation` | `float` | Rotación en grados, en sentido horario. *(por defecto: `0`)* |
| `rotationCenterOffsetX, rotationCenterOffsetY` | `float` | Desplazamiento del centro de rotación desde el centro de la imagen, en píxeles. También acepta un vec2. *(por defecto: `0, 0`)* |
| `color` | `color` | Color que multiplica la imagen, un valor de `tocolor`. *(por defecto: `tocolor(255, 255, 255)`)* |
| `postGUI` | `bool` | Dibuja por encima de la interfaz. *(por defecto: `false`)* |

## Retorno

`true` si el dibujo quedó en cola, `false` si la imagen no se pudo cargar.

Una ruta se carga una vez y se guarda para las siguientes llamadas. Mientras el archivo carga, no se dibuja nada.

## Ejemplo

```lua
local sx, sy = getScreenSize()

addEventHandler("onClientRender", root, function()
    dxDrawImage(sx - 140, 20, 120, 120, "images/logo.png", getTickCount() / 20 % 360)
end)
```

## Ver también

- [dxDrawImageSection (Cliente)](https://wiki.mymp.gg/es/dxDrawImageSection.md): Dibuja una parte de una imagen en la pantalla durante un fotograma.
- [engineCreateTexture (Cliente)](https://wiki.mymp.gg/es/engineCreateTexture.md): Crea una textura a partir de un archivo de imagen del recurso o de los bytes de una imagen en memoria. La textura solo existe en este cliente.
- [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.
- [dxGetMaterialSize (Cliente)](https://wiki.mymp.gg/es/dxGetMaterialSize.md): Devuelve el tamaño de una imagen en píxeles.
