LVGL 库提交
This commit is contained in:
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,340 @@
|
||||
/**
|
||||
* @file lv_image.h
|
||||
*
|
||||
*/
|
||||
|
||||
#ifndef LV_IMAGE_H
|
||||
#define LV_IMAGE_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/*********************
|
||||
* INCLUDES
|
||||
*********************/
|
||||
#include "../../lv_conf_internal.h"
|
||||
|
||||
#if LV_USE_IMAGE != 0
|
||||
|
||||
/*Testing of dependencies*/
|
||||
#if LV_USE_LABEL == 0
|
||||
#error "lv_img: lv_label is required. Enable it in lv_conf.h (LV_USE_LABEL 1)"
|
||||
#endif
|
||||
|
||||
#include "../../core/lv_obj.h"
|
||||
#include "../../misc/lv_fs.h"
|
||||
#include "../../draw/lv_draw.h"
|
||||
|
||||
/*********************
|
||||
* DEFINES
|
||||
*********************/
|
||||
|
||||
/**********************
|
||||
* TYPEDEFS
|
||||
**********************/
|
||||
|
||||
LV_ATTRIBUTE_EXTERN_DATA extern const lv_obj_class_t lv_image_class;
|
||||
|
||||
/**
|
||||
* Image size mode, when image size and object size is different
|
||||
*/
|
||||
typedef enum {
|
||||
LV_IMAGE_ALIGN_DEFAULT = 0,
|
||||
LV_IMAGE_ALIGN_TOP_LEFT,
|
||||
LV_IMAGE_ALIGN_TOP_MID,
|
||||
LV_IMAGE_ALIGN_TOP_RIGHT,
|
||||
LV_IMAGE_ALIGN_BOTTOM_LEFT,
|
||||
LV_IMAGE_ALIGN_BOTTOM_MID,
|
||||
LV_IMAGE_ALIGN_BOTTOM_RIGHT,
|
||||
LV_IMAGE_ALIGN_LEFT_MID,
|
||||
LV_IMAGE_ALIGN_RIGHT_MID,
|
||||
LV_IMAGE_ALIGN_CENTER,
|
||||
LV_IMAGE_ALIGN_AUTO_TRANSFORM,
|
||||
LV_IMAGE_ALIGN_STRETCH, /* Set X and Y scale to fill the Widget's area. */
|
||||
LV_IMAGE_ALIGN_TILE, /* Tile image to fill Widget's area. Offset is applied to shift the tiling. */
|
||||
LV_IMAGE_ALIGN_CONTAIN, /* The image keeps its aspect ratio, but is resized to the maximum size that fits within the Widget's area. */
|
||||
LV_IMAGE_ALIGN_COVER, /* The image keeps its aspect ratio and fills the Widget's area. */
|
||||
} lv_image_align_t;
|
||||
|
||||
#if LV_USE_OBJ_PROPERTY
|
||||
enum {
|
||||
LV_PROPERTY_ID(IMAGE, SRC, LV_PROPERTY_TYPE_IMGSRC, 0),
|
||||
LV_PROPERTY_ID(IMAGE, OFFSET_X, LV_PROPERTY_TYPE_INT, 1),
|
||||
LV_PROPERTY_ID(IMAGE, OFFSET_Y, LV_PROPERTY_TYPE_INT, 2),
|
||||
LV_PROPERTY_ID(IMAGE, ROTATION, LV_PROPERTY_TYPE_INT, 3),
|
||||
LV_PROPERTY_ID(IMAGE, PIVOT, LV_PROPERTY_TYPE_POINT, 4),
|
||||
LV_PROPERTY_ID(IMAGE, SCALE, LV_PROPERTY_TYPE_INT, 5),
|
||||
LV_PROPERTY_ID(IMAGE, SCALE_X, LV_PROPERTY_TYPE_INT, 6),
|
||||
LV_PROPERTY_ID(IMAGE, SCALE_Y, LV_PROPERTY_TYPE_INT, 7),
|
||||
LV_PROPERTY_ID(IMAGE, BLEND_MODE, LV_PROPERTY_TYPE_INT, 8),
|
||||
LV_PROPERTY_ID(IMAGE, ANTIALIAS, LV_PROPERTY_TYPE_INT, 9),
|
||||
LV_PROPERTY_ID(IMAGE, INNER_ALIGN, LV_PROPERTY_TYPE_INT, 10),
|
||||
LV_PROPERTY_IMAGE_END,
|
||||
};
|
||||
#endif
|
||||
|
||||
/**********************
|
||||
* GLOBAL PROTOTYPES
|
||||
**********************/
|
||||
|
||||
/**
|
||||
* Create an image object
|
||||
* @param parent pointer to an object, it will be the parent of the new image
|
||||
* @return pointer to the created image
|
||||
*/
|
||||
lv_obj_t * lv_image_create(lv_obj_t * parent);
|
||||
|
||||
/*=====================
|
||||
* Setter functions
|
||||
*====================*/
|
||||
|
||||
/**
|
||||
* Set the image data to display on the object
|
||||
* @param obj pointer to an image object
|
||||
* @param src 1) pointer to an ::lv_image_dsc_t descriptor (converted by LVGL's image converter) (e.g. &my_img) or
|
||||
* 2) path to an image file (e.g. "S:/dir/img.bin")or
|
||||
* 3) a SYMBOL (e.g. LV_SYMBOL_OK)
|
||||
*/
|
||||
void lv_image_set_src(lv_obj_t * obj, const void * src);
|
||||
|
||||
/**
|
||||
* Set an offset for the source of an image so the image will be displayed from the new origin.
|
||||
* @param obj pointer to an image
|
||||
* @param x the new offset along x axis.
|
||||
*/
|
||||
void lv_image_set_offset_x(lv_obj_t * obj, int32_t x);
|
||||
|
||||
/**
|
||||
* Set an offset for the source of an image.
|
||||
* so the image will be displayed from the new origin.
|
||||
* @param obj pointer to an image
|
||||
* @param y the new offset along y axis.
|
||||
*/
|
||||
void lv_image_set_offset_y(lv_obj_t * obj, int32_t y);
|
||||
|
||||
/**
|
||||
* Set the rotation angle of the image.
|
||||
* The image will be rotated around the set pivot set by `lv_image_set_pivot()`
|
||||
* Note that indexed and alpha only images can't be transformed.
|
||||
* @param obj pointer to an image object
|
||||
* @param angle rotation in degree with 0.1 degree resolution (0..3600: clock wise)
|
||||
* @note if image_align is `LV_IMAGE_ALIGN_STRETCH` or `LV_IMAGE_ALIGN_FIT`
|
||||
* rotation will be set to 0 automatically.
|
||||
*
|
||||
*/
|
||||
void lv_image_set_rotation(lv_obj_t * obj, int32_t angle);
|
||||
|
||||
/**
|
||||
* Set the rotation center of the image.
|
||||
* The image will be rotated around this point.
|
||||
* x, y can be set with value of LV_PCT, lv_image_get_pivot will return the true pixel coordinate of pivot in this case.
|
||||
* @param obj pointer to an image object
|
||||
* @param x rotation center x of the image
|
||||
* @param y rotation center y of the image
|
||||
*/
|
||||
void lv_image_set_pivot(lv_obj_t * obj, int32_t x, int32_t y);
|
||||
|
||||
/**
|
||||
* Set the zoom factor of the image.
|
||||
* Note that indexed and alpha only images can't be transformed.
|
||||
* @param obj pointer to an image object
|
||||
* @param zoom the zoom factor. Example values:
|
||||
* - 256 or LV_ZOOM_IMAGE_NONE: no zoom
|
||||
* - <256: scale down
|
||||
* - >256: scale up
|
||||
* - 128: half size
|
||||
* - 512: double size
|
||||
*/
|
||||
void lv_image_set_scale(lv_obj_t * obj, uint32_t zoom);
|
||||
|
||||
/**
|
||||
* Set the horizontal zoom factor of the image.
|
||||
* Note that indexed and alpha only images can't be transformed.
|
||||
* @param obj pointer to an image object
|
||||
* @param zoom the zoom factor. Example values:
|
||||
* - 256 or LV_ZOOM_IMAGE_NONE: no zoom
|
||||
* - <256: scale down
|
||||
* - >256: scale up
|
||||
* - 128: half size
|
||||
* - 512: double size
|
||||
*/
|
||||
void lv_image_set_scale_x(lv_obj_t * obj, uint32_t zoom);
|
||||
|
||||
/**
|
||||
* Set the vertical zoom factor of the image.
|
||||
* Note that indexed and alpha only images can't be transformed.
|
||||
* @param obj pointer to an image object
|
||||
* @param zoom the zoom factor. Example values:
|
||||
* - 256 or LV_ZOOM_IMAGE_NONE: no zoom
|
||||
* - <256: scale down
|
||||
* - >256: scale up
|
||||
* - 128: half size
|
||||
* - 512: double size
|
||||
*/
|
||||
void lv_image_set_scale_y(lv_obj_t * obj, uint32_t zoom);
|
||||
|
||||
/**
|
||||
* Set the blend mode of an image.
|
||||
* @param obj pointer to an image object
|
||||
* @param blend_mode the new blend mode
|
||||
*/
|
||||
void lv_image_set_blend_mode(lv_obj_t * obj, lv_blend_mode_t blend_mode);
|
||||
|
||||
/**
|
||||
* Enable/disable anti-aliasing for the transformations (rotate, zoom) or not.
|
||||
* The quality is better with anti-aliasing looks better but slower.
|
||||
* @param obj pointer to an image object
|
||||
* @param antialias true: anti-aliased; false: not anti-aliased
|
||||
*/
|
||||
void lv_image_set_antialias(lv_obj_t * obj, bool antialias);
|
||||
|
||||
/**
|
||||
* Set the image object size mode.
|
||||
* @param obj pointer to an image object
|
||||
* @param align the new align mode.
|
||||
* @note if image_align is `LV_IMAGE_ALIGN_STRETCH` or `LV_IMAGE_ALIGN_FIT`
|
||||
* rotation, scale and pivot will be overwritten and controlled internally.
|
||||
*/
|
||||
void lv_image_set_inner_align(lv_obj_t * obj, lv_image_align_t align);
|
||||
|
||||
/**
|
||||
* Set an A8 bitmap mask for the image.
|
||||
* @param obj pointer to an image object
|
||||
* @param src an lv_image_dsc_t bitmap mask source.
|
||||
*/
|
||||
void lv_image_set_bitmap_map_src(lv_obj_t * obj, const lv_image_dsc_t * src);
|
||||
|
||||
/*=====================
|
||||
* Getter functions
|
||||
*====================*/
|
||||
|
||||
/**
|
||||
* Get the source of the image
|
||||
* @param obj pointer to an image object
|
||||
* @return the image source (symbol, file name or ::lv-img_dsc_t for C arrays)
|
||||
*/
|
||||
const void * lv_image_get_src(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the offset's x attribute of the image object.
|
||||
* @param obj pointer to an image
|
||||
* @return offset X value.
|
||||
*/
|
||||
int32_t lv_image_get_offset_x(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the offset's y attribute of the image object.
|
||||
* @param obj pointer to an image
|
||||
* @return offset Y value.
|
||||
*/
|
||||
int32_t lv_image_get_offset_y(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the rotation of the image.
|
||||
* @param obj pointer to an image object
|
||||
* @return rotation in 0.1 degrees (0..3600)
|
||||
* @note if image_align is `LV_IMAGE_ALIGN_STRETCH` or `LV_IMAGE_ALIGN_FIT`
|
||||
* rotation will be set to 0 automatically.
|
||||
*/
|
||||
int32_t lv_image_get_rotation(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the pivot (rotation center) of the image.
|
||||
* If pivot is set with LV_PCT, convert it to px before return.
|
||||
* @param obj pointer to an image object
|
||||
* @param pivot store the rotation center here
|
||||
*/
|
||||
void lv_image_get_pivot(lv_obj_t * obj, lv_point_t * pivot);
|
||||
|
||||
/**
|
||||
* Get the zoom factor of the image.
|
||||
* @param obj pointer to an image object
|
||||
* @return zoom factor (256: no zoom)
|
||||
*/
|
||||
int32_t lv_image_get_scale(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the horizontal zoom factor of the image.
|
||||
* @param obj pointer to an image object
|
||||
* @return zoom factor (256: no zoom)
|
||||
*/
|
||||
int32_t lv_image_get_scale_x(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the vertical zoom factor of the image.
|
||||
* @param obj pointer to an image object
|
||||
* @return zoom factor (256: no zoom)
|
||||
*/
|
||||
int32_t lv_image_get_scale_y(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the width of an image before any transformations.
|
||||
* @param obj Pointer to an image object.
|
||||
* @return The width of the image.
|
||||
*/
|
||||
int32_t lv_image_get_src_width(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the height of an image before any transformations.
|
||||
* @param obj Pointer to an image object.
|
||||
* @return The height of the image.
|
||||
*/
|
||||
int32_t lv_image_get_src_height(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the transformed width of an image object.
|
||||
* @param obj Pointer to an image object.
|
||||
* @return The transformed width of the image.
|
||||
*/
|
||||
int32_t lv_image_get_transformed_width(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the transformed height of an image object.
|
||||
* @param obj Pointer to an image object.
|
||||
* @return The transformed height of the image.
|
||||
*/
|
||||
int32_t lv_image_get_transformed_height(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the current blend mode of the image
|
||||
* @param obj pointer to an image object
|
||||
* @return the current blend mode
|
||||
*/
|
||||
lv_blend_mode_t lv_image_get_blend_mode(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get whether the transformations (rotate, zoom) are anti-aliased or not
|
||||
* @param obj pointer to an image object
|
||||
* @return true: anti-aliased; false: not anti-aliased
|
||||
*/
|
||||
bool lv_image_get_antialias(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the size mode of the image
|
||||
* @param obj pointer to an image object
|
||||
* @return element of `lv_image_align_t`
|
||||
*/
|
||||
lv_image_align_t lv_image_get_inner_align(lv_obj_t * obj);
|
||||
|
||||
/**
|
||||
* Get the bitmap mask source.
|
||||
* @param obj pointer to an image object
|
||||
* @return an lv_image_dsc_t bitmap mask source.
|
||||
*/
|
||||
const lv_image_dsc_t * lv_image_get_bitmap_map_src(lv_obj_t * obj);
|
||||
|
||||
/**********************
|
||||
* MACROS
|
||||
**********************/
|
||||
|
||||
/** Use this macro to declare an image in a C file*/
|
||||
#define LV_IMAGE_DECLARE(var_name) extern const lv_image_dsc_t var_name
|
||||
|
||||
#endif /*LV_USE_IMAGE*/
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /*extern "C"*/
|
||||
#endif
|
||||
|
||||
#endif /*LV_IMAGE_H*/
|
||||
@@ -0,0 +1,65 @@
|
||||
/**
|
||||
* @file lv_image_private.h
|
||||
*
|
||||
*/
|
||||
|
||||
#ifndef LV_IMAGE_PRIVATE_H
|
||||
#define LV_IMAGE_PRIVATE_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/*********************
|
||||
* INCLUDES
|
||||
*********************/
|
||||
|
||||
#include "../../core/lv_obj_private.h"
|
||||
#include "lv_image.h"
|
||||
|
||||
#if LV_USE_IMAGE != 0
|
||||
|
||||
/*********************
|
||||
* DEFINES
|
||||
*********************/
|
||||
|
||||
/**********************
|
||||
* TYPEDEFS
|
||||
**********************/
|
||||
|
||||
/**
|
||||
* Data of image
|
||||
*/
|
||||
struct _lv_image_t {
|
||||
lv_obj_t obj;
|
||||
const void * src; /**< Image source: Pointer to an array or a file or a symbol*/
|
||||
const lv_image_dsc_t * bitmap_mask_src; /**< Pointer to an A8 bitmap mask */
|
||||
lv_point_t offset;
|
||||
int32_t w; /**< Width of the image (Handled by the library)*/
|
||||
int32_t h; /**< Height of the image (Handled by the library)*/
|
||||
uint32_t rotation; /**< Rotation angle of the image*/
|
||||
uint32_t scale_x; /**< 256 means no zoom, 512 double size, 128 half size*/
|
||||
uint32_t scale_y; /**< 256 means no zoom, 512 double size, 128 half size*/
|
||||
lv_point_t pivot; /**< Rotation center of the image*/
|
||||
uint32_t src_type : 2; /**< See: lv_image_src_t*/
|
||||
uint32_t cf : 5; /**< Color format from `lv_color_format_t`*/
|
||||
uint32_t antialias : 1; /**< Apply anti-aliasing in transformations (rotate, zoom)*/
|
||||
uint32_t align: 4; /**< Image size mode when image size and object size is different. See lv_image_align_t*/
|
||||
uint32_t blend_mode: 4; /**< Element of `lv_blend_mode_t`*/
|
||||
};
|
||||
|
||||
/**********************
|
||||
* GLOBAL PROTOTYPES
|
||||
**********************/
|
||||
|
||||
/**********************
|
||||
* MACROS
|
||||
**********************/
|
||||
|
||||
#endif /* LV_USE_IMAGE != 0 */
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /*extern "C"*/
|
||||
#endif
|
||||
|
||||
#endif /*LV_IMAGE_PRIVATE_H*/
|
||||
Reference in New Issue
Block a user