lv_img_create
用于创建图形用户界面- lv_obj_t * lv_img_create(lv_obj_t * parent);
- //parent:父对象,表示图像对象将被添加到哪个容器中
- //ret:返回创建的图像对象的指针
复制代码 lv_img_set_src
用于设置图像对象(lv_img)的源图片的函数。通过这个函数,可以指定图像对象要显示的图片资源,例如图片文件路径、内存中的图片数据或符号等- void lv_img_set_src(lv_obj_t * img, const void * src);
- //img:指向图像对象的指针(lv_obj_t *),通常是通过 lv_img_create 创建的
- //src:指定图片的源。src 的类型取决于图片资源的存储方式
- /*
- 字符串:表示图片文件的路径(例如 "path/to/image.png")。
- C 图像数组:指向存储在内存中的图像数据的指针(例如 const uint8_t *)。
- 符号:LVGL 内置的符号(例如 LV_SYMBOL_OK)
- */
复制代码 lv_img_set_offset_x
用于设置图像对象(lv_img)的水平偏移量的函数。通过这个函数,可以调整图像在水平方向上的显示位置,而不需要改变图像对象的整体位置- void lv_img_set_offset_x(lv_obj_t * img, lv_coord_t x);
- //img:指向图像对象的指针
- //x:水平偏移量(lv_coord_t),正值表示向右偏移,负值表示向左偏移
复制代码 lv_img_set_offset_y
用于设置图像对象(lv_img)的垂直偏移量的函数- void lv_img_set_offset_y(lv_obj_t * img, lv_coord_t y);
- //img:指向图像对象的指针
- //y:垂直偏移量(lv_coord_t),正值表示向下偏移,负值表示向上偏移
复制代码 lv_img_set_angle
用于设置图像对象(lv_img)的旋转角度的函数- void lv_img_set_angle(lv_obj_t * img, int16_t angle);
- //img:指向图像对象的指针
- //angle:旋转角度(以弧度为单位,范围为 -360° 到 +360°)。正值表示顺时针旋转,负值表示逆时针旋转。
复制代码 lv_img_set_pivot
用于设置图像对象(lv_img)的旋转中心点的函数。默认情况下,图像的旋转中心是图像的中心点,但可以通过此函数自定义旋转中心点的位置- void lv_img_set_pivot(lv_obj_t * img, lv_coord_t pivot_x, lv_coord_t pivot_y);
- //img:指向图像对象的指针
- //pivot_x:旋转中心点的 X 坐标,相对于图像左上角
- //pivot_y:旋转中心点的 Y 坐标,相对于图像左上角
复制代码 lv_img_set_zoom
用于设置图像对象(lv_img)的缩放比例的函数- void lv_img_set_zoom(lv_obj_t * img, uint16_t zoom);
- //img:指向图像对象的指针
- //zoom:缩放比例,单位是 1/256
- /*
- 256 表示不缩放(100%)。
- 512 表示放大 2 倍(200%)。
- 128 表示缩小到 50%
- */
复制代码 lv_img_set_antialias
用于设置图像对象(lv_img)是否启用抗锯齿的函数。抗锯齿可以平滑图像的边缘,使图像在缩放或旋转时看起来更清晰、更平滑。- void lv_img_set_antialias(lv_obj_t * img, bool en);
- //img:指向图像对象的指针
- /*
- en:布尔值,表示是否启用抗锯齿:
- true:启用抗锯齿。
- false:禁用抗锯齿
- */
复制代码 lv_img_set_size_mode
控制图像对象(image object)的尺寸行为模式。这个函数决定了图像如何根据原始尺寸和父容器尺寸进行缩放、拉伸或裁剪- void lv_img_set_size_mode(lv_obj_t *img_obj, lv_img_size_mode_t mode);
- //img_obj:指向图像对象的指针
- //mode:尺寸模式
- /*
- LV_IMG_SIZE_MODE_VIRTUAL 图像尺寸保持为原始像素大小,不受父容器影响
- LV_IMG_SIZE_MODE_REAL 强制图像完全填充父容器自动拉伸/压缩图像以匹配对象尺寸,不保持宽高比(可能变形)
- LV_IMG_SIZE_MODE_ZOOM 缩放图像以填充父容器,同时保持宽高比
- LV_IMG_SIZE_MODE_CENTER 居中显示原始图像(不缩放)
- */
复制代码 lv_img_get_src
用于获取图像对象(lv_img)当前设置的图片源的函数。通过这个函数,可以查询图像对象当前使用的图片资源,例如图片文件路径、内存中的图片数据或符号等。- const void* lv_img_get_src(const lv_obj_t * img);
- //img:指向图像对象的指针
- //返回当前设置的图片源
- /*
- 如果是图片文件路径,则返回 const char *。
- 如果是内存中的图片数据,则返回 const uint8_t *。
- 如果是符号,则返回对应的符号常量
- */
复制代码 lv_img_get_offset_x
用于获取图像对象(lv_img)的水平偏移量的函数- lv_coord_t lv_img_get_offset_x(const lv_obj_t * img);
- //img:指向图像对象的指针
- //ret:返回图像的水平偏移量(lv_coord_t),正值表示向右偏移,负值表示向左偏移
复制代码 lv_img_get_offset_y
用于获取图像对象(lv_img)的垂直偏移量的函数- lv_coord_t lv_img_get_offset_y(const lv_obj_t * img);
- //img:指向图像对象的指针
- //ret:返回图像的垂直偏移量(lv_coord_t),正值表示向下偏移,负值表示向上偏移
复制代码 lv_img_get_angle
用于获取图像对象(lv_img)的旋转角度- uint16_t lv_img_get_angle(lv_obj_t * img);
- //img:指向图像对象的指针
- //ret:返回图像的旋转角度,单位是 0.1 度(范围为 0 到 3600)。例如,返回值为 450 表示旋转了 45 度
复制代码 lv_img_get_pivot
用于获取图像对象(lv_img)的旋转中心点坐标- void lv_img_get_pivot(lv_obj_t * img, lv_coord_t * x, lv_coord_t * y);
- //img:指向图像对象的指针
- //x:指向 lv_coord_t 类型的指针,用于存储旋转中心点的 X 坐标
- //y:指向 lv_coord_t 类型的指针,用于存储旋转中心点的 Y 坐标
复制代码 lv_img_get_zoom
用于获取图像对象(lv_img)的当前缩放比例的函数- uint16_t lv_img_get_zoom(lv_obj_t * img);
- //img:指向图像对象的指针
- //ret:返回图像的缩放比例,单位是 1/256
- /*
- 256 表示不缩放(100%)。
- 512 表示放大 2 倍(200%)。
- 128 表示缩小到 50%。
- */
复制代码 lv_img_get_antialias
用于获取图像对象(lv_img)是否启用了抗锯齿功能的函数- bool lv_img_get_antialias(lv_obj_t * img);
- //img:指向图像对象的指针
- //ret:返回一个布尔值.true:表示启用了抗锯齿功能 false:表示未启用抗锯齿功能
复制代码 lv_img_get_size_mode
用于获取图像对象(lv_img)的尺寸模式的函数。尺寸模式决定了图像对象如何根据其内容调整大小- lv_img_size_mode_t lv_img_get_size_mode(const lv_obj_t *img_obj);
- //img_obj:指向图像对象的指针
- //ret:返回图像对象当前的尺寸模式
- /*
- LV_IMG_SIZE_MODE_VIRTUAL 图像尺寸保持为原始像素大小,不受父容器影响
- LV_IMG_SIZE_MODE_REAL 强制图像完全填充父容器自动拉伸/压缩图像以匹配对象尺寸,不保持宽高比(可能变形)
- LV_IMG_SIZE_MODE_ZOOM 缩放图像以填充父容器,同时保持宽高比
- LV_IMG_SIZE_MODE_CENTER 居中显示原始图像(不缩放)
- */
复制代码 来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |