Embedded/lvgl
1
0
Fork 0
mirror of https://github.com/lvgl/lvgl.git synced 2025-01-14 06:42:58 +08:00
Code Issues Projects Releases Wiki Activity
lvgl/scripts/style_props.md
Gabor Kiss-Vamosi fa0c1d1423 docs(objects) update to v8
2021-04-27 15:36:53 +02:00

36 KiB
Raw Blame History

radius

Set the radius on every corner. The value is interpreted in pixel (>= 0) or `LV_RADIUS_CIRCLE` for max. radius
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

clip_corner

Enable to clip the overflowed content on the rounded corner. Can be `true` or `false`.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

transform_width

Make the object wider on both sides with this value. Pixel and percentage (with `lv_pct(x)`) values can be used. Percentage values are relative to the object's width.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

transform_height

Make the object higher on both sides with this value. Pixel and percentage (with `lv_pct(x)`) values can be used. Percentage values are relative to the object's height.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

translate_x

Move the object with this value in X direction. Applied after layouts, aligns and other positionings. Pixel and percentage (with `lv_pct(x)`) values can be used. Percentage values are relative to the object's width.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

translate_y

Move the object with this value in Y direction. Applied after layouts, aligns and other positionings. Pixel and percentage (with `lv_pct(x)`) values can be used. Percentage values are relative to the object's height.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

transform_zoom

Zoom image-like objects. Multiplied with the zoom set on the object. The value 256 (or `LV_IMG_ZOOM_NONE`) maens normal size, 128 half size, 512 double size, and so on
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

transform_angle

Rotate image-like objects. Added to the rotation set on the object. The value is interpreted in 0.1 degree unit. E.g. 45 deg. = 450
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

opa

Scale down all opacity values of the object by this factor. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

color_filter_dsc

Mix a color to all colors of the object.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

color_filter_opa

The intensity of mixing of color filter.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

anim_time

The animation time in milliseconds. It's meaning is widget specific. E.g. blink time of the cursor on the text area or scroll time of a roller. See the widgets' documentation to learn more.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

anim_speed

The animation speed in pixel/sec. It's meaning is widget specific. E.g. scroll speed of label. See the widgets' documentation to learn more.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

transition

An initialized `lv_style_transition_dsc_t` to describe a transition.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

blend_mode

Describes how to blend the colors to the background. The possibel values are `LV_BLEND_MODE_NORMAL/ADDITIVE/SUBTRACTIVE`
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_top

Sets the padding on the top. It makes the content arae smaller in this direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_bottom

Sets the padding on the bottom. It makes the content arae smaller in this direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_left

Sets the padding on the left. It makes the content arae smaller in this direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_right

Sets the padding on the right. It makes the content arae smaller in this direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_row

Sets the padding between the rows. Used by the layouts.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

pad_column

Sets the padding between the columns. Used by the layouts.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

width

Sets the width of object. Pixel, percentage and `LV_SIZE_CONTENT` values can be used. Percentage values are relative to the width of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

min_width

Sets a minimal width. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

max_width

Sets a maximal width. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

height

Sets the height of object. Pixel, percentage and `LV_SIZE_CONTENT` can be used. Percentage values are relative to the height of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

min_height

Sets a minimal height. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

max_height

Sets a maximal height. Pixel and percentage values can be used. Percentage values are relative to the height of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

x

Set the X coordinate of the object considering the set `align`. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

y

Set the Y coordinate of the object considering the set `align`. Pixel and percentage values can be used. Percentage values are relative to the height of the parent's content area.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

align

Set the alignment whcih tells from which point of teh aprent the X and Y coordinates should be interptreted. The possibel values are: `LV_ALIGN_TOP_LEFT/MID/RIGHT`, `LV_ALIGN_BOTTOM_LEFT/MID/RIGHT`, `LV_ALIGN_LEFT/RIGHT_MID`, `LV_ALIGN_CENTER`
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

layout

Set the layout if the object. The children will be repositioned and resized according to the policies set for the layout. For the possible values see the documentation of the layouts.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_color

Set the background color of the object.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_opa

Set the opacity of the bacground. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_grad_color

Set the gradien color of the background. Used only if `grad_dir` is not `LV_GRAD_DIR_NONE`
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_grad_dir

Set the direction of the gradient of the background. The possible values are `LV_GRAD_DIR_NONE/HOR/VER`.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_main_stop

Set the point from which the backround color should start for gradients. 0 means to top/left side, 255 the bottom/right side, 128 the center, and so on
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_grad_stop

Set the point from which the backround's gradient color should start. 0 means to top/left side, 255 the bottom/right side, 128 the center, and so on
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_img_src

Set a background image. Can be a pointer to `lv_img_dsc_t`, a path to a file or an `LV_SYMBOL_...`
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_img_opa

Set the opacity of the background image. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_img_recolor

Set a color to mix to the background image.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_img_recolor_opa

Set the intensity of background image recoloring. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means no mixing, 256, `LV_OPA_100` or `LV_OPA_COVER` means full recoloring, other values or LV_OPA_10, LV_OPA_20, etc are interpreted proportinally.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

bg_img_tiled

If enbaled the background image will be tiled. The possible values are `ture` or `false`.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

border_color

Set the color of the border
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

border_opa

Set the opcitiy of the border. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

border_width

Set hte width of the border. Only pixel values can be used.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

border_side

Set ony which side(s) the border should be drawn. The possible values are `LV_BORDER_SIDE_NONE/TOP/BOTTOM/LEFT/RIGHT/INTERNAL`. OR-ed calues an be used as well, e.g. `LV_BORDER_SIDE_TOP | LV_BORDER_SIDE_LEFT`.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

border_post

Sets wheter the the border should be drawn before or after the children ar drawn. `true`: after children, `false`: before children
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_color

Sets the color of the text.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_opa

Set the opícity of the text. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_font

Set the font of the text (a pointer `lv_font_t *`).
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_letter_space

Set the letter space in pixels
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_line_space

Set the line space in pixels.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_decor

Set decoration for the text. The possible values are `LV_TEXT_DECOR_NONE/UNDERLINE/STRIKETHROUGH`. OR-ed values can be used as well.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

text_align

Set how to align the lines of the text. Note that it doesn't align the object itself, only the lines inside the obejct. The possibel values are `LV_TEXT_ALIGN_LEFT/CENTER/RIGHT/AUTO`. `LV_TEXT_ALIGN_AUTO` detect the text base direction and uses left or right alignment accordingly
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

img_opa

Set the opacity of an image. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

img_recolor

Set color to mixt to the image.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

img_recolor_opa

Set the intensity of the color mixing. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

outline_width

Set the width of the outline in pixels.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

outline_color

Set the color of the outline.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

outline_opa

Set the opacity of the outline. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

outline_pad

Set the padding of the outline, i.e. the gap between object and the outline.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_width

Set the width of the shadow in pixels. The value should be >= 0.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_ofs_x

Set an offset on the shadow in pixels in X direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_ofs_y

Set an offset on the shadow in pixels in Y direction.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_spread

Make the shadow calcuation to use a larger or smaller rectangle as base. The value can be in pixel t make the area larger/smaller
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_color

Set the color of the shadow
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

shadow_opa

Set the opacity of the shadow. Value 0, `LV_OPA_0` or `LV_OPA_TRANSP` means fully transparent, 256, `LV_OPA_100` or `LV_OPA_COVER` means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_width

Set the width of the lines in pixel.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_dash_width

Set the width of dashes in pixel. Note that dash works only on horizontal and vertical lines
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_dash_gap

Set the gap between dashes in pixel. Note that dash works only on horizontal and vertical lines
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_rounded

Make the end points of the lines rounded. `true`: rounded, `false`: perpadicular line ending
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_color

Set the color fo the lines.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

line_opa

Set the opacity of the lines.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

arc_width

Set the width (ticjkness) of the arcs in pixel.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

arc_rounded

Make the end points of the arcs rounded. `true`: rounded, `false`: perpadicular line ending
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

arc_color

Set the color of the arc.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

arc_opa

Set the opacity of the arcs.
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No

arc_img_src

Set an image from which the arc will be masked out. It's useful to display complex exxects on the arcs. Can be a pointer to `lv_img_dsc_t` or a path to a file
  • Default 0
  • Inherited No
  • Layout No
  • Ext. draw No