# lv_draw_image.h (/api/draw/lv_draw_image_h) Functions [#functions] lv_draw_task_get_image_dsc [#lv_draw_task_get_image_dsc] Try to get an image draw descriptor from a draw task. ```c title=" " lineNumbers=1 lv_draw_image_dsc_t * lv_draw_task_get_image_dsc(lv_draw_task_t *task) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------ | ----------- | | `task` | | draw task | **Returns:** — the task's draw descriptor or NULL if the task is not of type LV\_DRAW\_TASK\_TYPE\_IMAGE lv_image_src_get_type [#lv_image_src_get_type] Get the type of an image source ```c title=" " lineNumbers=1 lv_image_src_t lv_image_src_get_type(const void *src) ``` Parameters | Name | Type | Description | | ----- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `src` | `const void *` | pointer to an image source:
- pointer to an 'lv\_image\_t' variable (image stored internally and compiled into the code)
- a path to a file (e.g. "S:/folder/image.bin")
- or a symbol (e.g. LV\_SYMBOL\_CLOSE) | **Returns:** — type of the image source LV\_IMAGE\_SRC\_VARIABLE/FILE/SYMBOL/UNKNOWN lv_draw_image_dsc_init [#lv_draw_image_dsc_init] Initialize an image draw descriptor. ```c title=" " lineNumbers=1 void lv_draw_image_dsc_init(lv_draw_image_dsc_t *dsc) ``` Parameters | Name | Type | Description | | ----- | ---------------------------------------------------------------------- | ---------------------------- | | `dsc` | | pointer to a draw descriptor | lv_draw_image [#lv_draw_image] Create an image draw task ```c title=" " lineNumbers=1 void lv_draw_image(lv_layer_t *layer, const lv_draw_image_dsc_t *dsc, const lv_area_t *coords) ``` Parameters | Name | Type | Description | | -------- | ---------------------------------------------------------------------------- | ----------------------------------------- | | `layer` | | pointer to a layer | | `dsc` | | pointer to an initialized draw descriptor | | `coords` | | the coordinates of the image | `coords` can be small than the real image area (if only a part of the image is rendered) or can be larger (in case of tiled images). . lv_draw_layer [#lv_draw_layer] Create a draw task to blend a layer to another layer ```c title=" " lineNumbers=1 void lv_draw_layer(lv_layer_t *layer, const lv_draw_image_dsc_t *dsc, const lv_area_t *coords) ``` Parameters | Name | Type | Description | | -------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | `layer` | | pointer to a layer | | `dsc` | | pointer to an initialized draw descriptor. `src` must be set to the layer to blend | | `coords` | | the coordinates of the layer. | `coords` can be small than the total widget area from which the layer is created (if only a part of the widget was rendered to a layer) Structs [#structs] \_lv_draw_image_dsc_t [#_lv_draw_image_dsc_t] | Member | Type | Description | | ----------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `base` | | | | `src` | `const void *` | The image source: pointer to or a path to a file | | `header` | | The header of the image. Initialized internally in `lv_draw_image` | | `clip_radius` | | Clip the corner of the image with this radius. Use `LV_RADIUS_CIRCLE` for max. radius | | `rotation` | | The rotation of the image in 0.1 degree unit. E.g. 234 means 23.4° | | `scale_x` | | Horizontal scale (zoom) of the image. 256 (LV\_SCALE\_NONE): means no zoom, 512 double size, 128 half size. | | `scale_y` | | Same as `scale_y` but vertically | | `skew_x` | | Parallelogram like transformation of the image horizontally in 0.1 degree unit. E.g. 456 means 45.6°. | | `skew_y` | | Same as `skew_x` but vertically | | `pivot` | | The pivot point of transformation (scale and rotation). 0;0 is the top left corner of the image. Can be outside of the image too. | | `recolor` | | Mix this color to the images. In case of `LV_COLOR_FORMAT_A8` it will be the color of the visible pixels | | `recolor_opa` | | The intensity of recoloring. 0 means, no recolor, 255 means full cover (transparent pixels remain transparent) | | `opa` | | Opacity in 0...255 range. LV\_OPA\_TRANSP, LV\_OPA\_10, LV\_OPA\_20, .. LV\_OPA\_COVER can be used as well | | `blend_mode` | | Describes how to blend the pixels of the image to the background. See `lv_blend_mode_t` for more details. | | `antialias` | | 1: perform the transformation with anti-aliasing | | `tile` | | If the image is smaller than the `image_area` field of `lv_draw_image_dsc_t` tile the image (repeat is both horizontally and vertically) to fill the `image_area` area | | `colorkey` | | | | `sup` | | Used internally to store some information about the palette or the color of A8 images | | `image_area` | | Used to indicate the entire original, non-clipped area where the image is to be drawn. This is important for:
1. Layer rendering, where it might happen that only a smaller area of the layer is rendered and e.g. `clip_radius` needs to know what the original image was.
2. Tiled images, where the target draw area is larger than the image to be tiled. | | `bitmap_mask_src` | | Pointer to an A8 or L8 image descriptor to mask the image with. The mask is always center aligned. | Typedefs [#typedefs] lv_draw_image_core_cb [#lv_draw_image_core_cb] ```c title=" " lineNumbers=1 typedef void(* lv_draw_image_core_cb) (lv_draw_task_t *t, const lv_draw_image_dsc_t *draw_dsc, const lv_image_decoder_dsc_t *decoder_dsc, lv_draw_image_sup_t *sup, const lv_area_t *img_coords, const lv_area_t *clipped_img_area) ``` PErform the actual rendering of a decoded image * `lv_draw_image_normal_helper` — param `draw_core_cb` * `lv_draw_image_tiled_helper` — param `draw_core_cb` Dependencies [#dependencies]