lv_draw_vector.h

Typedefs

typedef uint8_t lv_vector_fill_t
typedef uint8_t lv_vector_stroke_cap_t
typedef uint8_t lv_vector_stroke_join_t
typedef uint8_t lv_vector_path_quality_t
typedef uint8_t lv_vector_blend_t
typedef uint8_t lv_vector_path_op_t
typedef uint8_t lv_vector_draw_style_t
typedef uint8_t lv_vector_gradient_spread_t
typedef uint8_t lv_vector_gradient_style_t
typedef void (*vector_draw_task_cb)(void *ctx, const lv_vector_path_t *path, const lv_vector_draw_dsc_t *dsc)

Enums

enum [anonymous]

Values:

enumerator LV_VECTOR_FILL_NONZERO
enumerator LV_VECTOR_FILL_EVENODD
enum [anonymous]

Values:

enumerator LV_VECTOR_STROKE_CAP_BUTT
enumerator LV_VECTOR_STROKE_CAP_SQUARE
enumerator LV_VECTOR_STROKE_CAP_ROUND
enum [anonymous]

Values:

enumerator LV_VECTOR_STROKE_JOIN_MITER
enumerator LV_VECTOR_STROKE_JOIN_BEVEL
enumerator LV_VECTOR_STROKE_JOIN_ROUND
enum [anonymous]

Values:

enumerator LV_VECTOR_PATH_QUALITY_MEDIUM
enumerator LV_VECTOR_PATH_QUALITY_HIGH
enumerator LV_VECTOR_PATH_QUALITY_LOW
enum [anonymous]

Values:

enumerator LV_VECTOR_BLEND_SRC_OVER
enumerator LV_VECTOR_BLEND_SRC_IN
enumerator LV_VECTOR_BLEND_DST_OVER
enumerator LV_VECTOR_BLEND_DST_IN
enumerator LV_VECTOR_BLEND_SCREEN
enumerator LV_VECTOR_BLEND_MULTIPLY
enumerator LV_VECTOR_BLEND_NONE
enumerator LV_VECTOR_BLEND_ADDITIVE
enumerator LV_VECTOR_BLEND_SUBTRACTIVE
enum [anonymous]

Values:

enumerator LV_VECTOR_PATH_OP_MOVE_TO
enumerator LV_VECTOR_PATH_OP_LINE_TO
enumerator LV_VECTOR_PATH_OP_QUAD_TO
enumerator LV_VECTOR_PATH_OP_CUBIC_TO
enumerator LV_VECTOR_PATH_OP_CLOSE
enum [anonymous]

Values:

enumerator LV_VECTOR_DRAW_STYLE_SOLID
enumerator LV_VECTOR_DRAW_STYLE_PATTERN
enumerator LV_VECTOR_DRAW_STYLE_GRADIENT
enum [anonymous]

Values:

enumerator LV_VECTOR_GRADIENT_SPREAD_PAD
enumerator LV_VECTOR_GRADIENT_SPREAD_REPEAT
enumerator LV_VECTOR_GRADIENT_SPREAD_REFLECT
enum [anonymous]

Values:

enumerator LV_VECTOR_GRADIENT_STYLE_LINEAR
enumerator LV_VECTOR_GRADIENT_STYLE_RADIAL

Functions

void lv_matrix_identity(lv_matrix_t *matrix)

Set matrix to identity matrix

Parameters:

matrix -- pointer to a matrix

void lv_matrix_translate(lv_matrix_t *matrix, float tx, float ty)

Translate the matrix to new position

Parameters:

  • matrix -- pointer to a matrix

  • tx -- the amount of translate in x direction

  • tx -- the amount of translate in y direction

void lv_matrix_scale(lv_matrix_t *matrix, float scale_x, float scale_y)

Change the scale factor of the matrix

Parameters:

  • matrix -- pointer to a matrix

  • scale_x -- the scale factor for the X direction

  • scale_y -- the scale factor for the Y direction

void lv_matrix_rotate(lv_matrix_t *matrix, float degree)

Rotate the matrix with origin

Parameters:

  • matrix -- pointer to a matrix

  • degree -- angle to rotate

void lv_matrix_skew(lv_matrix_t *matrix, float skew_x, float skew_y)

Change the skew factor of the matrix

Parameters:

  • matrix -- pointer to a matrix

  • skew_x -- the skew factor for x direction

  • skew_y -- the skew factor for y direction

void lv_matrix_multiply(lv_matrix_t *matrix, const lv_matrix_t *matrix2)

Multiply two matrix and store the result to the first one

Parameters:

  • matrix -- pointer to a matrix

  • matrix2 -- pointer to another matrix

void lv_matrix_transform_point(const lv_matrix_t *matrix, lv_fpoint_t *point)

Transform the coordinates of a point using given matrix

Parameters:

  • matrix -- pointer to a matrix

  • point -- pointer to a point

void lv_matrix_transform_path(const lv_matrix_t *matrix, lv_vector_path_t *path)

Transform all the coordinates of a path using given matrix

Parameters:

  • matrix -- pointer to a matrix

  • path -- pointer to a path

lv_vector_path_t *lv_vector_path_create(lv_vector_path_quality_t quality)

Create a vector graphic path object

Parameters:

quality -- the quality hint of path

Returns:

pointer to the created path object

void lv_vector_path_copy(lv_vector_path_t *target_path, const lv_vector_path_t *path)

Copy a path data to another

Parameters:

  • target_path -- pointer to a path

  • path -- pointer to source path

void lv_vector_path_clear(lv_vector_path_t *path)

Clear path data

Parameters:

path -- pointer to a path

void lv_vector_path_delete(lv_vector_path_t *path)

Delete the graphic path object

Parameters:

path -- pointer to a path

void lv_vector_path_move_to(lv_vector_path_t *path, const lv_fpoint_t *p)

Begin a new sub path and set a point to path

Parameters:

  • path -- pointer to a path

  • p -- pointer to a lv_fpoint_t variable

void lv_vector_path_line_to(lv_vector_path_t *path, const lv_fpoint_t *p)

Add a line to the path from last point to the point

Parameters:

  • path -- pointer to a path

  • p -- pointer to a lv_fpoint_t variable

void lv_vector_path_quad_to(lv_vector_path_t *path, const lv_fpoint_t *p1, const lv_fpoint_t *p2)

Add a quadratic bezier line to the path from last point to the point

Parameters:

  • path -- pointer to a path

  • p1 -- pointer to a lv_fpoint_t variable for control point

  • p2 -- pointer to a lv_fpoint_t variable for end point

void lv_vector_path_cubic_to(lv_vector_path_t *path, const lv_fpoint_t *p1, const lv_fpoint_t *p2, const lv_fpoint_t *p3)

Add a cubic bezier line to the path from last point to the point

Parameters:

  • path -- pointer to a path

  • p1 -- pointer to a lv_fpoint_t variable for first control point

  • p2 -- pointer to a lv_fpoint_t variable for second control point

  • p3 -- pointer to a lv_fpoint_t variable for end point

void lv_vector_path_close(lv_vector_path_t *path)

Close the sub path

Parameters:

path -- pointer to a path

void lv_vector_path_get_bounding(const lv_vector_path_t *path, lv_area_t *area)

Get the bounding box of a path

Parameters:

  • path -- pointer to a path

  • area -- pointer to a lv_area_t variable for bounding box

void lv_vector_path_append_rect(lv_vector_path_t *path, const lv_area_t *rect, float rx, float ry)

Add a rectangle to the path

Parameters:

  • path -- pointer to a path

  • rect -- pointer to a lv_area_t variable

  • rx -- the horizontal radius for rounded rectangle

  • ry -- the vertical radius for rounded rectangle

void lv_vector_path_append_circle(lv_vector_path_t *path, const lv_fpoint_t *c, float rx, float ry)

Add a circle to the path

Parameters:

  • path -- pointer to a path

  • c -- pointer to a lv_fpoint_t variable for center of the circle

  • rx -- the horizontal radius for circle

  • ry -- the vertical radius for circle

void lv_vector_path_append_arc(lv_vector_path_t *path, const lv_fpoint_t *c, float radius, float start_angle, float sweep, bool pie)

Add a arc to the path

Parameters:

  • path -- pointer to a path

  • c -- pointer to a lv_fpoint_t variable for center of the circle

  • radius -- the radius for arc

  • start_angle -- the start angle for arc

  • sweep -- the sweep angle for arc, could be negative

  • pie -- true: draw a pie, false: draw a arc

void lv_vector_path_append_path(lv_vector_path_t *path, const lv_vector_path_t *subpath)

Add an sub path to the path

Parameters:

  • path -- pointer to a path

  • subpath -- pointer to another path which will be added

lv_vector_dsc_t *lv_vector_dsc_create(lv_layer_t *layer)

Create a vector graphic descriptor

Parameters:

layer -- pointer to a layer

Returns:

pointer to the created descriptor

void lv_vector_dsc_delete(lv_vector_dsc_t *dsc)

Delete the vector graphic descriptor

Parameters:

dsc -- pointer to a vector graphic descriptor

void lv_vector_dsc_set_transform(lv_vector_dsc_t *dsc, const lv_matrix_t *matrix)

Set a matrix to current transformation matrix

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • matrix -- pointer to a matrix

void lv_vector_dsc_set_blend_mode(lv_vector_dsc_t *dsc, lv_vector_blend_t blend)

Set blend mode for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • blend -- the blend mode to be set in lv_vector_blend_t

void lv_vector_dsc_set_fill_color32(lv_vector_dsc_t *dsc, lv_color32_t color)

Set fill color for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • color -- the color to be set in lv_color32_t format

void lv_vector_dsc_set_fill_color(lv_vector_dsc_t *dsc, lv_color_t color)

Set fill color for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • color -- the color to be set in lv_color_t format

void lv_vector_dsc_set_fill_opa(lv_vector_dsc_t *dsc, lv_opa_t opa)

Set fill opacity for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • opa -- the opacity to be set in lv_opa_t format

void lv_vector_dsc_set_fill_rule(lv_vector_dsc_t *dsc, lv_vector_fill_t rule)

Set fill rule for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • rule -- the fill rule to be set in lv_vector_fill_t format

void lv_vector_dsc_set_fill_image(lv_vector_dsc_t *dsc, const lv_draw_image_dsc_t *img_dsc)

Set fill image for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • img_dsc -- pointer to a lv_draw_image_dsc_t variable

void lv_vector_dsc_set_fill_linear_gradient(lv_vector_dsc_t *dsc, float x1, float y1, float x2, float y2)

Set fill linear gradient for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • x1 -- the x for start point

  • y1 -- the y for start point

  • x2 -- the x for end point

  • y2 -- the y for end point

void lv_vector_dsc_set_fill_radial_gradient(lv_vector_dsc_t *dsc, float cx, float cy, float radius)

Set fill radial gradient radius for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • cx -- the x for center of the circle

  • cy -- the y for center of the circle

  • radius -- the radius for circle

void lv_vector_dsc_set_fill_gradient_spread(lv_vector_dsc_t *dsc, lv_vector_gradient_spread_t spread)

Set fill radial gradient spread for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • spread -- the gradient spread to be set in lv_vector_gradient_spread_t format

void lv_vector_dsc_set_fill_gradient_color_stops(lv_vector_dsc_t *dsc, const lv_gradient_stop_t *stops, uint16_t count)

Set fill gradient color stops for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • stops -- an array of lv_gradient_stop_t variables

  • count -- the number of stops in the array, range: 0..LV_GRADIENT_MAX_STOPS

void lv_vector_dsc_set_fill_transform(lv_vector_dsc_t *dsc, const lv_matrix_t *matrix)

Set a matrix to current fill transformation matrix

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • matrix -- pointer to a matrix

void lv_vector_dsc_set_stroke_color32(lv_vector_dsc_t *dsc, lv_color32_t color)

Set stroke color for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • color -- the color to be set in lv_color32_t format

void lv_vector_dsc_set_stroke_color(lv_vector_dsc_t *dsc, lv_color_t color)

Set stroke color for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • color -- the color to be set in lv_color_t format

void lv_vector_dsc_set_stroke_opa(lv_vector_dsc_t *dsc, lv_opa_t opa)

Set stroke opacity for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • opa -- the opacity to be set in lv_opa_t format

void lv_vector_dsc_set_stroke_width(lv_vector_dsc_t *dsc, float width)

Set stroke line width for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • width -- the stroke line width

void lv_vector_dsc_set_stroke_dash(lv_vector_dsc_t *dsc, float *dash_pattern, uint16_t dash_count)

Set stroke line dash pattern for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • dash_pattern -- an array of values that specify the segments of dash line

  • dash_count -- the length of dash pattern array

void lv_vector_dsc_set_stroke_cap(lv_vector_dsc_t *dsc, lv_vector_stroke_cap_t cap)

Set stroke line cap style for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • cap -- the line cap to be set in lv_vector_stroke_cap_t format

void lv_vector_dsc_set_stroke_join(lv_vector_dsc_t *dsc, lv_vector_stroke_join_t join)

Set stroke line join style for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • join -- the line join to be set in lv_vector_stroke_join_t format

void lv_vector_dsc_set_stroke_miter_limit(lv_vector_dsc_t *dsc, uint16_t miter_limit)

Set stroke miter limit for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • miter_limit -- the stroke miter_limit

void lv_vector_dsc_set_stroke_linear_gradient(lv_vector_dsc_t *dsc, float x1, float y1, float x2, float y2)

Set stroke linear gradient for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • x1 -- the x for start point

  • y1 -- the y for start point

  • x2 -- the x for end point

  • y2 -- the y for end point

void lv_vector_dsc_set_stroke_radial_gradient(lv_vector_dsc_t *dsc, float cx, float cy, float radius)

Set stroke radial gradient for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • cx -- the x for center of the circle

  • cy -- the y for center of the circle

  • radius -- the radius for circle

void lv_vector_dsc_set_stroke_gradient_spread(lv_vector_dsc_t *dsc, lv_vector_gradient_spread_t spread)

Set stroke color stops for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • spread -- the gradient spread to be set in lv_vector_gradient_spread_t format

void lv_vector_dsc_set_stroke_gradient_color_stops(lv_vector_dsc_t *dsc, const lv_gradient_stop_t *stops, uint16_t count)

Set stroke color stops for descriptor

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • stops -- an array of lv_gradient_stop_t variables

  • count -- the number of stops in the array

void lv_vector_dsc_set_stroke_transform(lv_vector_dsc_t *dsc, const lv_matrix_t *matrix)

Set a matrix to current stroke transformation matrix

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • matrix -- pointer to a matrix

void lv_vector_dsc_identity(lv_vector_dsc_t *dsc)

Set current transformation matrix to identity matrix

Parameters:

dsc -- pointer to a vector graphic descriptor

void lv_vector_dsc_scale(lv_vector_dsc_t *dsc, float scale_x, float scale_y)

Change the scale factor of current transformation matrix

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • scale_x -- the scale factor for the X direction

  • scale_y -- the scale factor for the Y direction

void lv_vector_dsc_rotate(lv_vector_dsc_t *dsc, float degree)

Rotate current transformation matrix with origin

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • degree -- angle to rotate

void lv_vector_dsc_translate(lv_vector_dsc_t *dsc, float tx, float ty)

Translate current transformation matrix to new position

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • tx -- the amount of translate in x direction

  • tx -- the amount of translate in y direction

void lv_vector_dsc_skew(lv_vector_dsc_t *dsc, float skew_x, float skew_y)

Change the skew factor of current transformation matrix

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • skew_x -- the skew factor for x direction

  • skew_y -- the skew factor for y direction

void lv_vector_dsc_add_path(lv_vector_dsc_t *dsc, const lv_vector_path_t *path)

Add a graphic path to the draw list

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • path -- pointer to a path

void lv_vector_clear_area(lv_vector_dsc_t *dsc, const lv_area_t *rect)

Clear a rectangle area use current fill color

Parameters:

  • dsc -- pointer to a vector graphic descriptor

  • rect -- the area to clear in the buffer

void lv_draw_vector(lv_vector_dsc_t *dsc)

Draw all the vector graphic paths

Parameters:

dsc -- pointer to a vector graphic descriptor

void _lv_vector_for_each_destroy_tasks(lv_ll_t *task_list, vector_draw_task_cb cb, void *data)
struct lv_fpoint_t

Public Members

float x
float y
struct lv_matrix_t

Public Members

float m[3][3]
struct lv_vector_path_t

Public Members

lv_vector_path_quality_t quality
lv_array_t ops
lv_array_t points
struct lv_vector_gradient_t

Public Members

lv_vector_gradient_style_t style
lv_gradient_stop_t stops[2]

A gradient stop array

uint16_t stops_count

The number of used stops in the array

float x1
float y1
float x2
float y2
float cx
float cy
float cr
lv_vector_gradient_spread_t spread
struct lv_vector_fill_dsc_t

Public Members

lv_vector_draw_style_t style
lv_color32_t color
lv_opa_t opa
lv_vector_fill_t fill_rule
lv_draw_image_dsc_t img_dsc
lv_vector_gradient_t gradient
lv_matrix_t matrix
struct lv_vector_stroke_dsc_t

Public Members

lv_vector_draw_style_t style
lv_color32_t color
lv_opa_t opa
float width
lv_array_t dash_pattern
lv_vector_stroke_cap_t cap
lv_vector_stroke_join_t join
uint16_t miter_limit
lv_vector_gradient_t gradient
lv_matrix_t matrix
struct lv_vector_draw_dsc_t

Public Members

lv_vector_fill_dsc_t fill_dsc
lv_vector_stroke_dsc_t stroke_dsc
lv_matrix_t matrix
lv_vector_blend_t blend_mode
lv_area_t scissor_area
struct lv_draw_vector_task_dsc_t

Public Members

lv_draw_dsc_base_t base
lv_ll_t *task_list
struct lv_vector_dsc_t

Public Members

lv_layer_t *layer
lv_vector_draw_dsc_t current_dsc
lv_draw_vector_task_dsc_t tasks