lv_area.h
Defines
-
_LV_COORD_TYPE_SHIFT
-
_LV_COORD_TYPE_MASK
-
_LV_COORD_TYPE(x)
-
_LV_COORD_PLAIN(x)
-
_LV_COORD_TYPE_PX
-
_LV_COORD_TYPE_SPEC
-
_LV_COORD_TYPE_PX_NEG
-
LV_COORD_IS_PX(x)
-
LV_COORD_IS_SPEC(x)
-
LV_COORD_SET_SPEC(x)
-
LV_PCT(x)
-
LV_COORD_IS_PCT(x)
-
LV_COORD_GET_PCT(x)
-
LV_SIZE_CONTENT
-
LV_COORD_MAX
-
LV_COORD_MIN
Enums
-
enum _lv_align_t
Alignments
Values:
-
enumerator LV_ALIGN_DEFAULT
-
enumerator LV_ALIGN_TOP_LEFT
-
enumerator LV_ALIGN_TOP_MID
-
enumerator LV_ALIGN_TOP_RIGHT
-
enumerator LV_ALIGN_BOTTOM_LEFT
-
enumerator LV_ALIGN_BOTTOM_MID
-
enumerator LV_ALIGN_BOTTOM_RIGHT
-
enumerator LV_ALIGN_LEFT_MID
-
enumerator LV_ALIGN_RIGHT_MID
-
enumerator LV_ALIGN_CENTER
-
enumerator LV_ALIGN_OUT_TOP_LEFT
-
enumerator LV_ALIGN_OUT_TOP_MID
-
enumerator LV_ALIGN_OUT_TOP_RIGHT
-
enumerator LV_ALIGN_OUT_BOTTOM_LEFT
-
enumerator LV_ALIGN_OUT_BOTTOM_MID
-
enumerator LV_ALIGN_OUT_BOTTOM_RIGHT
-
enumerator LV_ALIGN_OUT_LEFT_TOP
-
enumerator LV_ALIGN_OUT_LEFT_MID
-
enumerator LV_ALIGN_OUT_LEFT_BOTTOM
-
enumerator LV_ALIGN_OUT_RIGHT_TOP
-
enumerator LV_ALIGN_OUT_RIGHT_MID
-
enumerator LV_ALIGN_OUT_RIGHT_BOTTOM
-
enumerator LV_ALIGN_DEFAULT
Functions
-
void lv_area_set(lv_area_t *area_p, lv_coord_t x1, lv_coord_t y1, lv_coord_t x2, lv_coord_t y2)
Initialize an area
- Parameters:
area_p -- pointer to an area
x1 -- left coordinate of the area
y1 -- top coordinate of the area
x2 -- right coordinate of the area
y2 -- bottom coordinate of the area
-
static inline void lv_area_copy(lv_area_t *dest, const lv_area_t *src)
Copy an area
- Parameters:
dest -- pointer to the destination area
src -- pointer to the source area
-
static inline lv_coord_t lv_area_get_width(const lv_area_t *area_p)
Get the width of an area
- Parameters:
area_p -- pointer to an area
- Returns:
the width of the area (if x1 == x2 -> width = 1)
-
static inline lv_coord_t lv_area_get_height(const lv_area_t *area_p)
Get the height of an area
- Parameters:
area_p -- pointer to an area
- Returns:
the height of the area (if y1 == y2 -> height = 1)
-
void lv_area_set_width(lv_area_t *area_p, lv_coord_t w)
Set the width of an area
- Parameters:
area_p -- pointer to an area
w -- the new width of the area (w == 1 makes x1 == x2)
-
void lv_area_set_height(lv_area_t *area_p, lv_coord_t h)
Set the height of an area
- Parameters:
area_p -- pointer to an area
h -- the new height of the area (h == 1 makes y1 == y2)
-
void _lv_area_set_pos(lv_area_t *area_p, lv_coord_t x, lv_coord_t y)
Set the position of an area (width and height will be kept)
- Parameters:
area_p -- pointer to an area
x -- the new x coordinate of the area
y -- the new y coordinate of the area
-
uint32_t lv_area_get_size(const lv_area_t *area_p)
Return with area of an area (x * y)
- Parameters:
area_p -- pointer to an area
- Returns:
size of area
-
void lv_area_increase(lv_area_t *area, lv_coord_t w_extra, lv_coord_t h_extra)
-
void lv_area_move(lv_area_t *area, lv_coord_t x_ofs, lv_coord_t y_ofs)
-
bool _lv_area_intersect(lv_area_t *res_p, const lv_area_t *a1_p, const lv_area_t *a2_p)
Get the common parts of two areas
- Parameters:
res_p -- pointer to an area, the result will be stored her
a1_p -- pointer to the first area
a2_p -- pointer to the second area
- Returns:
false: the two area has NO common parts, res_p is invalid
-
int8_t _lv_area_diff(lv_area_t res_p[], const lv_area_t *a1_p, const lv_area_t *a2_p)
Get resulting sub areas after removing the common parts of two areas from the first area
- Parameters:
res_p -- pointer to an array of areas with a count of 4, the resulting areas will be stored here
a1_p -- pointer to the first area
a2_p -- pointer to the second area
- Returns:
number of results (max 4) or -1 if no intersect
-
void _lv_area_join(lv_area_t *a_res_p, const lv_area_t *a1_p, const lv_area_t *a2_p)
Join two areas into a third which involves the other two
- Parameters:
a_res_p -- pointer to an area, the result will be stored here
a1_p -- pointer to the first area
a2_p -- pointer to the second area
-
bool _lv_area_is_point_on(const lv_area_t *a_p, const lv_point_t *p_p, lv_coord_t radius)
Check if a point is on an area
- Parameters:
a_p -- pointer to an area
p_p -- pointer to a point
radius -- radius of area (e.g. for rounded rectangle)
- Returns:
false:the point is out of the area
-
bool _lv_area_is_on(const lv_area_t *a1_p, const lv_area_t *a2_p)
Check if two area has common parts
- Parameters:
a1_p -- pointer to an area.
a2_p -- pointer to an other area
- Returns:
false: a1_p and a2_p has no common parts
-
bool _lv_area_is_in(const lv_area_t *ain_p, const lv_area_t *aholder_p, lv_coord_t radius)
Check if an area is fully on an other
- Parameters:
ain_p -- pointer to an area which could be in 'aholder_p'
aholder_p -- pointer to an area which could involve 'ain_p'
radius -- radius of
aholder_p(e.g. for rounded rectangle)
- Returns:
true:
ain_pis fully insideaholder_p
-
bool _lv_area_is_out(const lv_area_t *aout_p, const lv_area_t *aholder_p, lv_coord_t radius)
Check if an area is fully out of an other
- Parameters:
aout_p -- pointer to an area which could be in 'aholder_p'
aholder_p -- pointer to an area which could involve 'ain_p'
radius -- radius of
aholder_p(e.g. for rounded rectangle)
- Returns:
true:
aout_pis fully outsideaholder_p
-
bool _lv_area_is_equal(const lv_area_t *a, const lv_area_t *b)
Check if 2 area is the same
- Parameters:
a -- pointer to an area
b -- pointer to another area
-
void lv_area_align(const lv_area_t *base, lv_area_t *to_align, lv_align_t align, lv_coord_t ofs_x, lv_coord_t ofs_y)
Align an area to an other
- Parameters:
base -- an area where the other will be aligned
to_align -- the area to align
align --
LV_ALIGN_...ofs_x -- X offset
ofs_y -- Y offset
-
void lv_point_transform(lv_point_t *p, int32_t angle, int32_t zoom_x, int32_t zoom_y, const lv_point_t *pivot, bool zoom_first)
-
static inline lv_coord_t lv_pct(lv_coord_t x)
Convert a percentage value to
lv_coord_t. Percentage values are stored in special range- Parameters:
x -- the percentage (0..1000)
- Returns:
a coordinate that stores the percentage
-
static inline lv_coord_t lv_pct_to_px(lv_coord_t v, lv_coord_t base)
-
struct lv_point_t
- #include <lv_area.h>
Represents a point on the screen.
-
struct lv_area_t
- #include <lv_area.h>
Represents an area of the screen.
-
struct lv_area_transform_cache_t