lv_draw_vector.h

Typedefs

typedef void (*vector_draw_task_cb)(void *ctx, const lv_vector_path_t *path, const lv_vector_draw_dsc_t *dsc)

Enums

enum lv_vector_fill_t

Values:

enumerator LV_VECTOR_FILL_NONZERO
enumerator LV_VECTOR_FILL_EVENODD
enum lv_vector_stroke_cap_t

Values:

enumerator LV_VECTOR_STROKE_CAP_BUTT
enumerator LV_VECTOR_STROKE_CAP_SQUARE
enumerator LV_VECTOR_STROKE_CAP_ROUND
enum lv_vector_stroke_join_t

Values:

enumerator LV_VECTOR_STROKE_JOIN_MITER
enumerator LV_VECTOR_STROKE_JOIN_BEVEL
enumerator LV_VECTOR_STROKE_JOIN_ROUND
enum lv_vector_path_quality_t

Values:

enumerator LV_VECTOR_PATH_QUALITY_MEDIUM
enumerator LV_VECTOR_PATH_QUALITY_HIGH
enumerator LV_VECTOR_PATH_QUALITY_LOW
enum lv_vector_blend_t

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 lv_vector_path_op_t

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 lv_vector_draw_style_t

Values:

enumerator LV_VECTOR_DRAW_STYLE_SOLID
enumerator LV_VECTOR_DRAW_STYLE_PATTERN
enumerator LV_VECTOR_DRAW_STYLE_GRADIENT
enum lv_vector_gradient_spread_t

Values:

enumerator LV_VECTOR_GRADIENT_SPREAD_PAD
enumerator LV_VECTOR_GRADIENT_SPREAD_REPEAT
enumerator LV_VECTOR_GRADIENT_SPREAD_REFLECT
enum lv_vector_gradient_style_t

Values:

enumerator LV_VECTOR_GRADIENT_STYLE_LINEAR
enumerator LV_VECTOR_GRADIENT_STYLE_RADIAL

Functions

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

struct _lv_fpoint_t

Public Members

float x
float y