2.5D足球 (2.5D Soccer)

2.5D足球由12个顶点和20个面组成，这些顶点和面可以构成一个近似3D效果的球形。其中，顶点定义了球体的形状和位置，面是由多个顶点连接而成的平面，用于填充球的表面。

用法

创建控件

使用 gui_soccer_create() 创建一个2.5D足球控件。其中 addr 是用于填充足球白色面片的图像。

设置大小

足球顶点之间的默认距离是100，可以通过 gui_soccer_set_size() 改变顶点之间的距离，从而改变足球控件大小。

设置中心

足球控件的默认中心是 ((dc->fb_width - this->scsize) / 2.0f)，其中 this->scsize 为足球顶点距离。使用 gui_soccer_set_center() 可以改变足球的中心坐标。

设置图像模式

足球控件的默认图像混合模式是 IMG_SRC_OVER_MODE，可以通过 gui_soccer_set_mode() 来改变图像混合模式。

设置图像透明度

可以通过 gui_soccer_set_opacity() 来改变图像的透明度。

设置足球面片图像

可以通过 gui_soccer_set_img() 来设置足球的面片图像。

示例

#include "gui_app.h"
#include "gui_soccer.h"
#include "ui_resource.h"

uint32_t *gui_soccer_array[] =
{
   SOCCER_P0001_CALL_BIN,
   SOCCER_P0002_SPORTS_BIN,
   SOCCER_P0003_HEARTRATE_BIN,
   SOCCER_P0004_SLEEP_BIN,
   SOCCER_P0005_WEATHER_BIN,
   SOCCER_P0006_ACTIVITIES_BIN,
   SOCCER_P0007_STRESS_BIN,
   SOCCER_P0008_SPO2_BIN,
   SOCCER_P0009_MUSIC_BIN,
   SOCCER_P0010_VOICE_BIN,
   SOCCER_P0011_NOTIFICATION_BIN,
   SOCCER_P0012_SETTINGS_BIN,
   SOCCER_P0013_SPORT_CORECD_BIN,
   SOCCER_P0014_MEASURE_BIN,
   SOCCER_P0015_MOOD_BIN,
   SOCCER_P0016_BREATHE_BIN,
   SOCCER_P0017_ALARM_BIN,
   SOCCER_P0018_PERIOD_BIN,
   SOCCER_P0019_HOME_BIN,
   SOCCER_P0020_MORE_BIN,
};
static void app_call_ui_design(gui_app_t *app);
static gui_app_t app_call =
{
   .screen =
   {
      .name = "app_call",
      .x    = 0,
      .y    = 0,
   },
   .ui_design = app_call_ui_design,
   .active_ms = 1000 * 5,
};

gui_app_t *get_call_app(void)
{
   return &app_call;
}
static void app_call_ui_design(gui_app_t *app)
{
   gui_img_create_from_mem(&(app->screen), "call", SOCCER_P0001_CALL_BIN, 100, 100, 100, 100);
}
static void app_soccer_cb(void *obj, gui_event_t e, void *param)
{
   gui_soccer_t *soccer = (gui_soccer_t *)obj;
   int index = soccer->press_face;
   switch (soccer->press_face)
   {
   case 0:
      gui_switch_app(gui_current_app(), get_call_app());
      break;
   default:
      break;
   }
}
GUI_APP_ENTRY(APP_SOCCER)
{
   gui_soccer_t *soccer = gui_soccer_create(&(app->screen), "soccer", gui_soccer_array, 0, 0);
   gui_soccer_set_center(soccer, 227, 227);
   gui_soccer_on_click(soccer, app_soccer_cb, NULL);

   gui_return_create(GUI_APP_ROOT_SCREEN, gui_app_return_array,
                     sizeof(gui_app_return_array) / sizeof(uint32_t *), win_cb, (void *)0);
}

API

Defines

RAD(d): angle to rad

PHI

Functions

gui_soccer_t *gui_soccer_create(void *parent, const char *name, uint32_t *frame_array[], int16_t x, int16_t y)

soccer create, images can be loaded from filesystem or memory address

Example usage

{
    gui_soccer_imgfile_t imgfile =
    {
        .flg_fs = true,
        .img_path.img_path_front = "Activity.bin",
        .img_path.img_path_back = "Weather.bin",
        .img_path.img_path_up = "HeartRate.bin",
        .img_path.img_path_down = "Clockn.bin",
        .img_path.img_path_left = "Music.bin",
        .img_path.img_path_right = "QuickCard.bin"
    };

    gui_soccer_t *soccer4 = gui_soccer_create(parent, "soccer", &imgfile, 0, 0);
    gui_soccer_set_size(soccer4, 100);
    gui_soccer_set_center(soccer4, 200, 200);
}

参数:

parent – parent widget
name – widget name
addr – the image file data
x – left
y – top

返回:

gui_soccer_t* widget pointer

BLEND_MODE_TYPE gui_soccer_get_mode(gui_soccer_t *soccer)

get the soccer image’s blend mode

参数:: soccer – the soccer widget pointer
返回:: the soccer image’s blend mode

void gui_soccer_set_mode(gui_soccer_t *soccer, BLEND_MODE_TYPE mode)

set the soccer image’s blend mode

参数:

soccer – the soccer widget pointer
mode – the enumeration value of the mode is BLEND_MODE_TYPE

uint8_t gui_soccer_get_opacity(gui_soccer_t *soccer)

get the soccer image’s opacity

参数:: soccer – the cube widget pointer
返回:: the soccer image’s opacity

void gui_soccer_set_opacity(gui_soccer_t *soccer, uint8_t opacity)

set the soccer image’s opacity

参数:

soccer – the soccer widget pointer
opacity – the soccer image’s opacity

void gui_soccer_set_img(gui_soccer_t *soccer, uint32_t *frame_array[])

set soccer image

参数:

cube – the soccer widget pointer
addr – the image file data

void gui_soccer_set_center(gui_soccer_t *this, float c_x, float c_y)

set center

参数:

this – widget pointer
c_x – center x
c_y – center y

void gui_soccer_set_size(gui_soccer_t *this, float size)

set size

参数:

this – widget pointer
size – scale size

void gui_soccer_set_slide_range(gui_soccer_t *this, float range)

set slide range

参数:

this – widget pointer
range – slide range

void gui_soccer_on_click(gui_soccer_t *this, void *callback, void *parameter)

set on_click event

参数:

this – widget pointer
callback – callback function
parameter – callback function parameter

gui_soccer_t *gui_soccer_create_ftl(void *parent, const char *name, uint32_t *frame_array[], int16_t x, int16_t y)

Creates and initializes a new GUI soccer instance (ftl address mode).

This function sets up a new soccer GUI widget. It initializes the necessary components and prepares it for display.

参数:

parent – Pointer to the parent GUI component. This is typically a window or a container that will hold the soccer game widget.
name – A string representing the name of the GUI soccer widget. This can be used for identification purposes within the parent.
frame_array – Array of pointers to uint32_t, representing the frames of the soccer game animation or graphics (ftl address mode).
x – The x-coordinate where the soccer widget will be placed within the parent component’s coordinate system.
y – The y-coordinate where the soccer widget will be placed within the parent component’s coordinate system.

返回:

A pointer to the newly created gui_soccer_t instance, or NULL if the creation fails due to memory allocation issues or invalid parameters.

struct gui_quaternion_t

Public Members

float w

float x

float y

float z

struct gui_soccer_t

SOCCER widget structure.

Public Members

gui_obj_t base: base structure

draw_img_t draw_img[20]

float xrot

float yrot

float zrot

float c_x

float c_y

float scsize

int press_face

gui_vertex_t normal[20]

gui_quaternion_t rotation

float slide_range