可缩放矢量图形 (SVG)
可缩放矢量图形可以展示SVG格式的图像。
SVG是一种用于描述二维图形的 XML 标记语言，与位图图像不同，SVG图像以文本形式存储，并且可以缩放到任意大小而不会失真，因为它们基于数学描述而不是像素。
SVG图像可以直接打包到
root文件夹。
用法
创建控件
使用 gui_svg_create_from_mem() 以从内存地址加载图像的方式创建一个SVG控件, 或者使用 gui_svg_create_from_file() 以从文件系统路径加载图像的方式创建一个SVG控件。
其中，w/h 是SVG控件的宽度和高度，而不是要绘制的SVG图像的宽高，size 是必须填写的SVG图像的绘制数据大小。
设置旋转
使用 gui_svg_rotation() 将SVG图像旋转 degree 角度。其中， (c_x, c_y) 是旋转中心。
设置缩放
如果需要更新SVG图像的大小，可以使用 gui_svg_scale()。
设置平移
使用 gui_svg_translate() 平移SVG图像。
设置透明度
使用 gui_svg_set_opacity() 设置SVG图像透明度。
示例
创建一个简单的 SVG
#include "gui_svg.h"
#include "root_image_hongkong/ui_resource.h"
void page_tb_svg(void *parent)
{
gui_svg_t* svg1=gui_svg_create_from_mem(parent,"svg1",ACTIVITY_SVG,5184,0,0,100,100);
}
SVG 旋转
#include "gui_svg.h"
#include "root_image_hongkong/ui_resource.h"
void page_tb_svg(void *parent)
{
gui_svg_t* svg1=gui_svg_create_from_mem(parent,"svg1",ACTIVITY_SVG,5184,0,0,100,100);
gui_svg_rotation(svg1,90,50,50);
}
SVG 缩放
#include "gui_svg.h"
#include "root_image_hongkong/ui_resource.h"
void page_tb_svg(void *parent)
{
gui_svg_t* svg1=gui_svg_create_from_mem(parent,"svg1",ACTIVITY_SVG,5184,0,0,100,100);
gui_svg_scale(svg1,2,1);
}
SVG 平移
#include "gui_svg.h"
#include "root_image_hongkong/ui_resource.h"
void page_tb_svg(void *parent)
{
gui_svg_t* svg1=gui_svg_create_from_mem(parent,"svg1",ACTIVITY_SVG,5184,0,0,100,100);
gui_svg_translate(svg1,100,100);
}
API
Functions
-
gui_svg_t *gui_svg_create_from_file(void *parent, const char *name, const char *filename, int16_t x, int16_t y, int16_t w, int16_t h)
-
Create a svg widget from file, which should display an SVG image.
- 参数:
parent – The father widget nested in.
name – This svg widget’s name.
filename – This svg image’s filename.
x – The X-axis coordinate relative to parent widget.
y – The Y-axis coordinate relative to parent widget.
w – Width.
h – Height.
- 返回:
-
gui_svg_t*
-
gui_svg_t *gui_svg_create_from_mem(void *parent, const char *name, uint8_t *addr, uint32_t size, int16_t x, int16_t y, int16_t w, int16_t h)
-
Create a svg widget from memory, which should display an SVG image.
- 参数:
parent – The father widget nested in.
name – This svg widget’s name.
addr – Change svg address.
size – The size of svg.
x – The X-axis coordinate relative to parent widget.
y – The Y-axis coordinate relative to parent widget.
w – Width.
h – Height.
- 返回:
-
gui_svg_t*
-
void gui_svg_rotation(gui_svg_t *svg, float degrees, float c_x, float c_y)
-
Set svg rotation angle.
- 参数:
svg – The svg widget pointer.
degrees – Rotation angle.
c_x – The X-axis coordinate of the rotation center.
c_y – The Y-axis coordinate of the rotation center.
-
void gui_svg_scale(gui_svg_t *svg, float scale_x, float scale_y)
-
Scale the svg.
- 参数:
svg – The svg widget pointer.
scale_x – Scale in the X-axis direction.
scale_y – Scale in the Y-axis direction.
-
struct gui_svg_t
-
svg structure