进度条 (Progressbar)

进度条控件允许创建具备三种不同效果的控件。开发者创建进度条控件后，可以设置控件显示的百分比。

用法

创建水平方向控件

开发者可以使用API gui_progressbar_img_h_create() 创建基于单张图片的水平方向进度条控件。这是一个普通的单张图片进度条控件。

创建垂直方向控件

类似于上面提到的创建水平方向控件，开发者可以使用 gui_progressbar_img_v_create() 创建基于单张图片的垂直方向进度条控件。

创建电影风格控件

与上述两种单张图片的进度条控件不同，电影风格的进度条控件由一系列的图片组成。开发者可以调用 gui_progressbar_movie_create() 从内存地址创建电影风格的进度条控件，或者调用 gui_progressbar_movie_create_from_fs() 从文件系统创建电影风格的进度条控件。在 0% 进度时显示第一张图片，在 100% 进度时显示最后一张图片。

进度

例如，开发者想创建一个电影风格的进度条控件，可以通过 gui_progressbar_set_progress() 和 gui_progressbar_get_progress() 来设置和获取进度。

百分比

上述用法进度适用于电影风格的进度条控件。对于普通的单张图片进度条控件，如果开发者想使用一个进度条控件来显示歌曲播放的进度，可以在创建进度条控件后使用 gui_progressbar_set_percentage() 来设置当前的百分比进度。此外，还可以使用 gui_progressbar_get_percentage() 来获取当前的百分比进度。

获取最大值

此 API gui_progressbar_get_max() 用于获取电影风格进度条控件中的图片数量，这样就可以知道总共会显示多少张图片。

示例

#include "root_image_hongkong/ui_resource.h"
#include "gui_progressbar.h"
#include "gui_text.h"
#include "draw_font.h"

static void *array[] = {DOG40_BIN, DOG60_BIN, DOG80_BIN, DOG100_BIN, DOG120_BIN, DOG140_BIN};

void page_tb_one(void *parent)
{
    gui_set_font_mem_resourse(24, TEST_FONT24_DOT_BIN, TEST_FONT24_TABLE_BIN);

    gui_progressbar_t *test_bar_one = gui_progressbar_img_v_create(parent, TEST_BIN, 50, 0);
    gui_progressbar_set_percentage(test_bar_one, 1);

    gui_progressbar_t *test_bar_two = gui_progressbar_img_v_create(parent, TEST_BIN, 150, 0);
    gui_progressbar_set_percentage(test_bar_two, 0.5);

    gui_text_t *text1 = gui_text_create(parent, "vertical1", 50, 250, 300, 24);
    gui_text_set(text1, "100%    50%  vertical", GUI_FONT_SRC_BMP, 0xffffffff, 21, 24);
    gui_text_mode_set(text1, LEFT);

    gui_text_t *text2 = gui_text_create(parent, "vertical2", 10, 300, 330, 24);
    gui_text_set(text2, "gui_progressbar_img_v_create", GUI_FONT_SRC_BMP, 0xff0000ff, 28, 24);
    gui_text_mode_set(text2, LEFT);
}

void page_tb_two(void *parent)
{
    gui_set_font_mem_resourse(24, TEST_FONT24_DOT_BIN, TEST_FONT24_TABLE_BIN);

    gui_progressbar_t *test_bar_three = gui_progressbar_img_h_create(parent, TEST_BIN, 50, 0);
    gui_progressbar_set_percentage(test_bar_three, 1);

    gui_progressbar_t *test_bar_four = gui_progressbar_img_h_create(parent, TEST_BIN, 150, 0);
    gui_progressbar_set_percentage(test_bar_four, 0.5);

    gui_text_t *text3 = gui_text_create(parent, "horizontal1", 50, 250, 300, 24);
    gui_text_set(text3, "100%    50%  horizontal", GUI_FONT_SRC_BMP, 0xffffffff, 23, 24);
    gui_text_mode_set(text3, LEFT);

    gui_text_t *text4 = gui_text_create(parent, "horizontal2", 10, 300, 330, 24);
    gui_text_set(text4, "gui_progressbar_img_h_create", GUI_FONT_SRC_BMP, 0xff0000ff, 28, 24);
    gui_text_mode_set(text4, LEFT);
}

void page_tb_three(void *parent)
{
    gui_set_font_mem_resourse(24, TEST_FONT24_DOT_BIN, TEST_FONT24_TABLE_BIN);

    gui_progressbar_t *test_bar_five = gui_progressbar_movie_create(parent, array, 6, 0, 0);

    gui_progressbar_t *test_bar_six = gui_progressbar_movie_create(parent, array, 6, 150, 0);
    gui_progressbar_set_progress(test_bar_six, 4);

    gui_text_t *text5 = gui_text_create(parent, "movie1", 80, 250, 300, 24);
    gui_text_set(text5, "pic0   pic4  movie", GUI_FONT_SRC_BMP, 0xffffffff, 18, 24);
    gui_text_mode_set(text5, LEFT);

    gui_text_t *text6 = gui_text_create(parent, "movie2", 10, 300, 330, 24);
    gui_text_set(text6, "gui_progressbar_movie_create", GUI_FONT_SRC_BMP, 0xff0000ff, 28, 24);
    gui_text_mode_set(text6, LEFT);
}

API

Functions

gui_progressbar_t *gui_progressbar_img_h_create(void *parent, void *picture, int16_t x, int16_t y)

create a horizontal progressbar based on picture.

参数:

parent – parent widget.
picture – the picture background.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

gui_progressbar_t *gui_progressbar_img_h_create_from_ftl(void *parent, void *picture, int16_t x, int16_t y)

create a horizontal progressbar based on picture.

参数:

parent – parent widget.
picture – the picture background, should be ftl addr.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

gui_progressbar_t *gui_progressbar_img_v_create(void *parent, void *picture, int16_t x, int16_t y)

create a vertical progressbar based on picture.

参数:

parent – parent widget.
picture – the picture background.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

gui_progressbar_t *gui_progressbar_img_v_create_from_ftl(void *parent, void *picture, int16_t x, int16_t y)

create a vertical progressbar based on picture.

参数:

parent – parent widget.
picture – the picture background, should be ftl addr.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

gui_progressbar_t *gui_progressbar_movie_create(void *parent, void **picture_array, uint16_t array_length, int16_t x, int16_t y)

create a frame progressbar based on pictures, file source is memory address.

参数:

parent – parent widget.
picture_array – the pictures frame memory address.
array_length – picture_array length.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

gui_progressbar_t *gui_progressbar_movie_create_from_fs(void *parent, void **picture_array, uint16_t array_length, int16_t x, int16_t y)

create a frame progressbar based on pictures, file source is filesystem.

参数:

parent – parent widget.
picture_array – the pictures frame filepath.
array_length – picture_array length.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.

返回:

gui_progressbar_t*.

void gui_progressbar_set_progress(gui_progressbar_t *_this, size_t progress)

set progress.

参数:

_this – widget object pointer.
progress – the progress of widget.

size_t gui_progressbar_get_progress(gui_progressbar_t *_this)

get_progress.

参数:: _this – widget object pointer.
返回:: size_t

void gui_progressbar_set_percentage(gui_progressbar_t *_this, float percentage)

set_percentage.

参数:

_this – widget object pointer.
percentage – the percentage of widget.

float gui_progressbar_get_percentage(gui_progressbar_t *_this)

get_percentage.

参数:: _this – widget object pointer.
返回:: float.

size_t gui_progressbar_get_max(gui_progressbar_t *_this)

get_max.

参数:: _this – widget object pointer.
返回:: size_t.

gui_progressbar_t *gui_progressbar_thumb_h_create(void *parent, void *picture_pointer, int16_t x, int16_t y, uint16_t bar_width)

create a horizontal progressbar based on picture with thumb.

参数:

parent – parent widget.
picture_pointer – the picture background.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.
bar_width – the bar width.

返回:

gui_progressbar_t*.

struct gui_progressbar_t

…

Public Members

gui_obj_t base

gui_canvas_t *c

uint32_t color

uint32_t color_hl

size_t max

float per

float per_history

void (*ctor)(struct gui_progressbar *_this, gui_obj_t *parent, const char *name, int16_t x, int16_t y, int16_t w, int16_t h)

IMG_SOURCE_MODE_TYPE src_mode

uint8_t image_type

uint16_t thumb_width