透视 (Perspective)

透视控件是一个六面体形状的控件，由六个标签页作为六个面。当创建好透视控件后，该控件会自动旋转来显示不同的标签页，在旋转的同时也可以点击不同的标签页实现快速跳转到当前标签页。

用法

创建透视控件

使用 gui_perspective_create() 函数创建透视控件。img_file 是一个包含六个标签页的图像资源的结构体。创建透视控件时，六个标签页的图片资源可以使用内存地址或文件路径，gui_perspective_imgfile_t (参考如下结构体) 中的字段 src_mode 表明了图片资源是来自内存地址还是文件路径，如示例中展示，src_mode 为 IMG_SRC_MEMADDR 时表示图片资源来自内存地址。

typedef struct
{
    IMG_SOURCE_MODE_TYPE src_mode[6];                    //!< flag: indicate file src
    union
    {
        char *img_path[6];               //!< images file path
        void *data_addr[6];              //!< images memory address
    };
} gui_perspective_imgfile_t;

设置透视控件的图片

使用 gui_perspective_set_img() 函数设置透视控件的图片。

设置图片混合模式

默认情况下，控件的图像混合模式为 IMG_SRC_OVER_MODE，调用 gui_perspective_set_mode() 函数可以设置图像的混合模式。混合模式 BLEND_MODE_TYPE 枚举类型如下：

typedef enum
{
    IMG_BYPASS_MODE = 0,
    IMG_FILTER_BLACK,
    IMG_SRC_OVER_MODE, //S * Sa + (1 - Sa) * D
    IMG_COVER_MODE,
    IMG_RECT,
} BLEND_MODE_TYPE;

示例

API

Defines

RAD(d): angle to rad

Functions

void gui_perspective_set_mode(gui_perspective_t *perspective, uint8_t img_index, BLEND_MODE_TYPE mode)

set the perspective image’s blend mode

参数:

perspective – the perspective widget pointer
img_index – the perspective image’s index
mode – the enumeration value of the mode is BLEND_MODE_TYPE

void gui_perspective_set_img(gui_perspective_t *perspective, gui_perspective_imgfile_t *img_file)

set perspective image

参数:

perspective – the perspective widget pointer
img_file – the image file data, set flg_fs true when using filesystem

gui_perspective_t *gui_perspective_create(void *parent, const char *name, gui_perspective_imgfile_t *img_file, int16_t x, int16_t y)

create 3D perspective, images can be loaded from filesystem or memory address

Example usage

void perspctive_example(void *parent)
{
    gui_perspective_imgfile_t imgfile =
    {
        .flg_fs = true,
        .img_path[0] = "Clockn.bin",
        .img_path[1] = "Weather.bin",
        .img_path[2] = "Music.bin",
        .img_path[3] = "QuickCard.bin",
        .img_path[4] = "HeartRate.bin",
        .img_path[5] = "Activity.bin"
    };
    img_test = gui_perspective_create(canvas, "test", &imgfile, 0, 0);
}

参数:

parent – parent widget
name – widget name
img_file – the image file data, set flg_fs true when using filesystem
x – left
y – top

返回:

gui_perspective_t* widget pointer

struct gui_perspective_imgfile_t

Public Members

IMG_SOURCE_MODE_TYPE src_mode[6]: flag: indicate file src

char *img_path[6]: images file path

void *data_addr[6]: images memory address

union gui_perspective_imgfile_t

struct gui_perspective_t

Public Members

gui_obj_t base: base structure

draw_img_t img[6]

int ry[6]

int temp[6]

void *file_path[6]

void *ftl[6]

union gui_perspective_t

void *data[6]

uint8_t src_mode[6]

int16_t release_x

uint8_t checksum