Switch

Switch is a custom switch button widget, often used to enable or disable certain features or options, allowing the developer to control the behavior of an application by toggling the state of the button.

Usage

Turn On/Off

By using the following APIs, the switch can be turned on or off, and the event (created by gui_obj_add_event_cb) will be triggered. gui_switch_turn_on() and gui_switch_turn_off().

Update On/Off State

If the switch widget has been turned on somehow, the following APIs can be used to update the status to on or off. gui_switch_is_on() and gui_switch_is_off().

Change Switch State

Use gui_switch_change_state() to set the switch widget’s state and change the UI, and there won’t be any event (created by gui_obj_add_event_cb) triggered.

Example

#include "root_image_hongkong/ui_resource.h"
#include "gui_switch.h"
#include "gui_img.h"

static gui_img_t *img;

static void img_animate(gui_img_t *img)
{
    gui_log("%f\n", img->animate->progress_percent);
    if (img->animate->progress_percent < 0.5f)
    {
        GET_BASE(img)->y = img->animate->progress_percent * 2 * 100 - 100;
    }
    else if (img->animate->progress_percent >= 0.5f)
    {
        GET_BASE(img)->y = (1 - img->animate->progress_percent) * 2 * 100 - 100;
    }
    if (img->animate->progress_percent == 1.0f)
    {
        img->animate->current_repeat_count = 0;
        img->base.not_show = true;
    }

}

static void reset_animate()
{
    img->animate->animate = true;
    img->base.not_show = false;
    img->animate->current_frame = 0;
    img->animate->current_repeat_count = 0;
    img->animate->progress_percent = 0;
}

static void callback_disturb_on()
{
    reset_animate();
    img->draw_img->data = WURAOKAI_BIN;
}

static void callback_disturb_off()
{
    reset_animate();
    img->draw_img->data = WURAOGUAN_BIN;
}

static void callback_mute_on()
{
    reset_animate();
    img->draw_img->data = JINGYINKAI_BIN;
}

static void callback_mute_off()
{
    reset_animate();
    img->draw_img->data = JINGYINGUAN_BIN;
}

static void callback_call_on()
{
    reset_animate();
    img->draw_img->data = DIANHUAKAI_BIN;
}

static void callback_call_off()
{
    reset_animate();
    img->draw_img->data = DIANHUAGUAN_BIN;
}

static void callback_bright_on()
{
    reset_animate();
    img->draw_img->data = LIANGDUKAI_BIN;
}

static void callback_bright_off()
{
    reset_animate();
    img->draw_img->data = LIANGDUGUAN_BIN;
}

static void callback_watch_on()
{
    reset_animate();
    img->draw_img->data = SHIZHONGKAI_BIN;
}

static void callback_watch_off()
{
    reset_animate();
    img->draw_img->data = SHIZHONGGUAN_BIN;
}

static void callback_set_on()
{
    reset_animate();
    img->draw_img->data = SHEZHIKAI_BIN;
}

static void callback_set_off()
{
    reset_animate();
    img->draw_img->data = SHEZHIGUAN_BIN;
}

void page_tb_control0(void *parent)
{
    // gui_img_creat_from_mem(parent, "parent", CONTROLMENU_0_BIN, 0, 0, 0, 0);
    gui_switch_t *sw_no_disturb  = gui_switch_create(parent, 10, 108, 169, 98, NO_DISTURB_OFF_BIN,
                                                    NO_DISTURB_ON_BIN);
    gui_switch_t *sw_mute        = gui_switch_create(parent, 190, 108, 169, 98, MUTE_OFF_BIN,
                                                    MUTE_ON_BIN);
    gui_switch_t *sw_call        = gui_switch_create(parent, 10, 220, 169, 98, CALL_OFF_BIN,
                                                    CALL_ON_BIN);
    gui_switch_t *sw_bright      = gui_switch_create(parent, 190, 220, 169, 98, BRIGHT_OFF_BIN,
                                                    BRIGHT_ON_BIN);
    gui_switch_t *sw_watch       = gui_switch_create(parent, 10, 332, 169, 98, WATCH_OFF_BIN,
                                                    WATCH_ON_BIN);
    gui_switch_t *sw_set         = gui_switch_create(parent, 190, 332, 169, 98, SET_OFF_BIN,
                                                    SET_ON_BIN);
    img =  gui_img_create_from_mem(GET_BASE(parent)->parent, 0, WURAOKAI_BIN, 0, 0, 0, 0);
    gui_img_set_animate(img, 1000, 1, img_animate, img);
    img->animate->animate = false;
    img->base.not_show = true;

    gui_obj_add_event_cb(sw_no_disturb, (gui_event_cb_t)callback_disturb_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_no_disturb, (gui_event_cb_t)callback_disturb_off, GUI_EVENT_2, NULL);
    gui_obj_add_event_cb(sw_mute, (gui_event_cb_t)callback_mute_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_mute, (gui_event_cb_t)callback_mute_off, GUI_EVENT_2, NULL);
    gui_obj_add_event_cb(sw_call, (gui_event_cb_t)callback_call_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_call, (gui_event_cb_t)callback_call_off, GUI_EVENT_2, NULL);
    gui_obj_add_event_cb(sw_bright, (gui_event_cb_t)callback_bright_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_bright, (gui_event_cb_t)callback_bright_off, GUI_EVENT_2, NULL);
    gui_obj_add_event_cb(sw_watch, (gui_event_cb_t)callback_watch_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_watch, (gui_event_cb_t)callback_watch_off, GUI_EVENT_2, NULL);
    gui_obj_add_event_cb(sw_set, (gui_event_cb_t)callback_set_on, GUI_EVENT_1, NULL);
    gui_obj_add_event_cb(sw_set, (gui_event_cb_t)callback_set_off, GUI_EVENT_2, NULL);
}

API

Defines

SWITCH_HIGHLIGHT_ARRAY

Enums

enum T_GUI_SWITCH_EVENT

Values:

enumerator SWITCH_EVENT_PRESSED

enumerator SWITCH_EVENT_RELEASED

Functions

gui_switch_t *gui_switch_create(void *parent, int16_t x, int16_t y, int16_t w, int16_t h, void *off_pic, void *on_pic)

create a switch widget, file source is memory address.

Parameters:

parent – the father widget it nested in.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.
w – the width of the widget.
h – the hight of the widget.
off_pic – off status image memory address.
on_pic – on status image memory address.

Returns:

return the widget object pointer.

gui_switch_t *gui_switch_create_from_fs(void *parent, int16_t x, int16_t y, int16_t w, int16_t h, void *off_pic, void *on_pic)

create a switch widget, file source is filesystem.

Parameters:

parent – the father widget it nested in.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.
w – the width of the widget.
h – the hight of the widget.
off_pic – off status image filepath.
on_pic – on status image filepath.

Returns:

return the widget object pointer.

gui_switch_t *gui_switch_create_from_ftl(void *parent, int16_t x, int16_t y, int16_t w, int16_t h, void *off_pic, void *on_pic)

create a switch widget, file source is memory address.

Parameters:

parent – the father widget it nested in.
x – the X-axis coordinate of the widget.
y – the Y-axis coordinate of the widget.
w – the width of the widget.
h – the hight of the widget.
off_pic – off status image filepath.
on_pic – on status image filepath.

Returns:

return the widget object pointer.

void gui_switch_turn_on(gui_switch_t*)

turn on the switch, event will be triggered.

Parameters:: this – widget object pointer.

void gui_switch_turn_off(gui_switch_t*)

turn off the switch, event will be triggered.

Parameters:: this – widget object pointer.

void gui_switch_is_on(gui_switch_t*)

if the switch has been turned on somehow, it can upadte the status to on status.

Parameters:: this – widget object pointer.

void gui_switch_is_off(gui_switch_t*)

if the switch has been turned off somehow, it can upadte the status to off status.

Parameters:: this – widget object pointer.

void gui_switch_change_state(gui_switch_t*, bool ifon)

set sw state and change ui, NO event will be trigered.

Parameters:

this – widget object pointer.
ifon – set sw state.

Variables

_gui_api_gui_switch_t _gui_api_for_gui_switch_t

struct gui_switch

Public Members

gui_obj_t base

gui_img_t *switch_picture

void *on_pic_addr

void *off_pic_addr

void *on_hl_pic_addr

void *off_hl_pic_addr

void *long_touch_state_pic_addr

void *long_touch_state_hl_pic_addr

void *data

gui_animate_t *animate: can set animation

IMG_SOURCE_MODE_TYPE src_mode

char style

uint32_t ifon

uint32_t long_touch_state

uint32_t long_touch_enable

uint32_t press_flag

uint32_t long_flag

uint32_t release_flag

uint32_t touch_disable

uint32_t checksum

struct _gui_api_gui_switch_t

Public Members

void (*turn_off)(gui_switch_t *sw)

void (*turn_on)(gui_switch_t *sw)

void (*on_turn_on)(gui_switch_t*, gui_event_cb_t cb, void *p)

void (*on_turn_off)(gui_switch_t*, gui_event_cb_t cb, void *p)

void (*on_press)(gui_switch_t*, gui_event_cb_t event_cb, void *parameter)

void (*on_release)(gui_switch_t*, gui_event_cb_t event_cb, void *parameter)

void (*ctor)(gui_switch_t*, gui_obj_t *parent, int16_t x, int16_t y, int16_t w, int16_t h, void *off_pic, void *on_pic)

void (*animate)(gui_switch_t*, uint32_t dur, int repeat_count, void *callback, void *p)

void (*turn_off_no_event)(gui_switch_t *sw)

void (*turn_on_no_event)(gui_switch_t *sw)

Switch

Usage

Create Widget

Turn On/Off

Update On/Off State

Change Switch State

Example

API