lv_image_decoder.h

API reference for lv_image_decoder.h

Report on GitHub
See Also: Private HeaderThis header has a companion private implementation with internal data structures.lv_image_decoder_private.h

Functions

lv_image_decoder_set_info_cb

Set a callback to get information about the image

 
void lv_image_decoder_set_info_cb(lv_image_decoder_t *decoder, lv_image_decoder_info_f_t info_cb)
Parameters
NameTypeDescription
decoderlv_image_decoder_t *pointer to an image decoder
info_cblv_image_decoder_info_f_ta function to collect info about an image (fill an lv_image_header_t struct)

lv_image_decoder_set_open_cb

Set a callback to open an image

 
void lv_image_decoder_set_open_cb(lv_image_decoder_t *decoder, lv_image_decoder_open_f_t open_cb)
Parameters
NameTypeDescription
decoderlv_image_decoder_t *pointer to an image decoder
open_cblv_image_decoder_open_f_ta function to open an image

lv_image_decoder_set_get_area_cb

Set a callback to a decoded line of an image

 
void lv_image_decoder_set_get_area_cb(lv_image_decoder_t *decoder, lv_image_decoder_get_area_cb_t read_line_cb)
Parameters
NameTypeDescription
decoderlv_image_decoder_t *pointer to an image decoder
read_line_cblv_image_decoder_get_area_cb_ta function to read a line of an image

lv_image_decoder_set_close_cb

Set a callback to close a decoding session. E.g. close files and free other resources.

 
void lv_image_decoder_set_close_cb(lv_image_decoder_t *decoder, lv_image_decoder_close_f_t close_cb)
Parameters
NameTypeDescription
decoderlv_image_decoder_t *pointer to an image decoder
close_cblv_image_decoder_close_f_ta function to close a decoding session

Enums

lv_image_src_t

Source of image.

NameDescription
LV_IMAGE_SRC_VARIABLE
LV_IMAGE_SRC_FILEBinary/C variable
LV_IMAGE_SRC_SYMBOLFile in filesystem
LV_IMAGE_SRC_UNKNOWNSymbol (lv_symbol_def.h)

Typedefs

lv_image_decoder_info_f_t

 
typedef lv_result_t(* lv_image_decoder_info_f_t) (lv_image_decoder_t *decoder, lv_image_decoder_dsc_t *dsc, lv_image_header_t *header)

Get info from an image and store in the header

Used by 1 function
  • lv_image_decoder_set_info_cb — param info_cb

lv_image_decoder_open_f_t

 
typedef lv_result_t(* lv_image_decoder_open_f_t) (lv_image_decoder_t *decoder, lv_image_decoder_dsc_t *dsc)

Open an image for decoding. Prepare it as it is required to read it later

Used by 1 function
  • lv_image_decoder_set_open_cb — param open_cb

lv_image_decoder_get_area_cb_t

 
typedef lv_result_t(* lv_image_decoder_get_area_cb_t) (lv_image_decoder_t *decoder, lv_image_decoder_dsc_t *dsc, const lv_area_t *full_area, lv_area_t *decoded_area)

Decode full_area pixels incrementally by calling in a loop. Set decoded_area values to LV_COORD_MIN on first call. Required only if the "open" function can't return with the whole decoded pixel array.

Used by 1 function
  • lv_image_decoder_set_get_area_cb — param read_line_cb

lv_image_decoder_close_f_t

 
typedef void(* lv_image_decoder_close_f_t) (lv_image_decoder_t *decoder, lv_image_decoder_dsc_t *dsc)

Close the pending decoding. Free resources etc.

Used by 1 function
  • lv_image_decoder_set_close_cb — param close_cb

lv_image_decoder_custom_draw_t

 
typedef void(* lv_image_decoder_custom_draw_t) (lv_layer_t *layer, const lv_image_decoder_dsc_t *dsc, const lv_area_t *coords, const lv_draw_image_dsc_t *draw_dsc, const lv_area_t *clip_area)

Custom drawing functions for special image formats.

Dependencies

How is this guide?

Last updated on

On this page