# lv_eve.h (/api/draw/eve/lv_eve_h)



<ApiSummary functions="19" enums="1" structs="2" />

Functions [#functions]

<ApiMember kind="function" name="lv_eve_save_context" file="draw/eve/lv_eve.h" line="81" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L81">
  lv_eve_save_context [#lv_eve_save_context]

  ```c title=" " lineNumbers=1
  void lv_eve_save_context(void)
  ```
</ApiMember>

<ApiMember kind="function" name="lv_eve_restore_context" file="draw/eve/lv_eve.h" line="82" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L82">
  lv_eve_restore_context [#lv_eve_restore_context]

  ```c title=" " lineNumbers=1
  void lv_eve_restore_context(void)
  ```
</ApiMember>

<ApiMember kind="function" name="lv_eve_scissor" file="draw/eve/lv_eve.h" line="83" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L83">
  lv_eve_scissor [#lv_eve_scissor]

  ```c title=" " lineNumbers=1
  void lv_eve_scissor(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name | Type                        |
  | ---- | --------------------------- |
  | `x1` | <ApiLink name="uint16_t" /> |
  | `y1` | <ApiLink name="uint16_t" /> |
  | `x2` | <ApiLink name="uint16_t" /> |
  | `y2` | <ApiLink name="uint16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_primitive" file="draw/eve/lv_eve.h" line="84" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L84">
  lv_eve_primitive [#lv_eve_primitive]

  ```c title=" " lineNumbers=1
  void lv_eve_primitive(uint8_t context)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name      | Type                       |
  | --------- | -------------------------- |
  | `context` | <ApiLink name="uint8_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_color" file="draw/eve/lv_eve.h" line="85" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L85">
  lv_eve_color [#lv_eve_color]

  ```c title=" " lineNumbers=1
  void lv_eve_color(lv_color_t color)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name    | Type                          |
  | ------- | ----------------------------- |
  | `color` | <ApiLink name="lv_color_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_color_opa" file="draw/eve/lv_eve.h" line="86" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L86">
  lv_eve_color_opa [#lv_eve_color_opa]

  ```c title=" " lineNumbers=1
  void lv_eve_color_opa(lv_opa_t opa)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name  | Type                        |
  | ----- | --------------------------- |
  | `opa` | <ApiLink name="lv_opa_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_line_width" file="draw/eve/lv_eve.h" line="87" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L87">
  lv_eve_line_width [#lv_eve_line_width]

  ```c title=" " lineNumbers=1
  void lv_eve_line_width(int32_t width)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name    | Type                       |
  | ------- | -------------------------- |
  | `width` | <ApiLink name="int32_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_point_size" file="draw/eve/lv_eve.h" line="88" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L88">
  lv_eve_point_size [#lv_eve_point_size]

  ```c title=" " lineNumbers=1
  void lv_eve_point_size(uint16_t radius)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name     | Type                        |
  | -------- | --------------------------- |
  | `radius` | <ApiLink name="uint16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_vertex_2f" file="draw/eve/lv_eve.h" line="89" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L89">
  lv_eve_vertex_2f [#lv_eve_vertex_2f]

  ```c title=" " lineNumbers=1
  void lv_eve_vertex_2f(int16_t x, int16_t y)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name | Type                       |
  | ---- | -------------------------- |
  | `x`  | <ApiLink name="int16_t" /> |
  | `y`  | <ApiLink name="int16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_color_mask" file="draw/eve/lv_eve.h" line="90" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L90">
  lv_eve_color_mask [#lv_eve_color_mask]

  ```c title=" " lineNumbers=1
  void lv_eve_color_mask(uint8_t r, uint8_t g, uint8_t b, uint8_t a)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name | Type                       |
  | ---- | -------------------------- |
  | `r`  | <ApiLink name="uint8_t" /> |
  | `g`  | <ApiLink name="uint8_t" /> |
  | `b`  | <ApiLink name="uint8_t" /> |
  | `a`  | <ApiLink name="uint8_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_stencil_func" file="draw/eve/lv_eve.h" line="91" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L91">
  lv_eve_stencil_func [#lv_eve_stencil_func]

  ```c title=" " lineNumbers=1
  void lv_eve_stencil_func(uint8_t func, uint8_t ref, uint8_t mask)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name   | Type                       |
  | ------ | -------------------------- |
  | `func` | <ApiLink name="uint8_t" /> |
  | `ref`  | <ApiLink name="uint8_t" /> |
  | `mask` | <ApiLink name="uint8_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_stencil_op" file="draw/eve/lv_eve.h" line="92" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L92">
  lv_eve_stencil_op [#lv_eve_stencil_op]

  ```c title=" " lineNumbers=1
  void lv_eve_stencil_op(uint8_t sfail, uint8_t spass)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name    | Type                       |
  | ------- | -------------------------- |
  | `sfail` | <ApiLink name="uint8_t" /> |
  | `spass` | <ApiLink name="uint8_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_blend_func" file="draw/eve/lv_eve.h" line="93" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L93">
  lv_eve_blend_func [#lv_eve_blend_func]

  ```c title=" " lineNumbers=1
  void lv_eve_blend_func(uint8_t src, uint8_t dst)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name  | Type                       |
  | ----- | -------------------------- |
  | `src` | <ApiLink name="uint8_t" /> |
  | `dst` | <ApiLink name="uint8_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_draw_circle_simple" file="draw/eve/lv_eve.h" line="95" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L95">
  lv_eve_draw_circle_simple [#lv_eve_draw_circle_simple]

  ```c title=" " lineNumbers=1
  void lv_eve_draw_circle_simple(int16_t coord_x1, int16_t coord_y1, uint16_t radius_t)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name       | Type                        |
  | ---------- | --------------------------- |
  | `coord_x1` | <ApiLink name="int16_t" />  |
  | `coord_y1` | <ApiLink name="int16_t" />  |
  | `radius_t` | <ApiLink name="uint16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_draw_rect_simple" file="draw/eve/lv_eve.h" line="96" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L96">
  lv_eve_draw_rect_simple [#lv_eve_draw_rect_simple]

  ```c title=" " lineNumbers=1
  void lv_eve_draw_rect_simple(int16_t coord_x1, int16_t coord_y1, int16_t coord_x2, int16_t coord_y2, uint16_t radius)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name       | Type                        |
  | ---------- | --------------------------- |
  | `coord_x1` | <ApiLink name="int16_t" />  |
  | `coord_y1` | <ApiLink name="int16_t" />  |
  | `coord_x2` | <ApiLink name="int16_t" />  |
  | `coord_y2` | <ApiLink name="int16_t" />  |
  | `radius`   | <ApiLink name="uint16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_mask_round" file="draw/eve/lv_eve.h" line="98" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L98">
  lv_eve_mask_round [#lv_eve_mask_round]

  ```c title=" " lineNumbers=1
  void lv_eve_mask_round(int16_t coord_x1, int16_t coord_y1, int16_t coord_x2, int16_t coord_y2, int16_t radius)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name       | Type                       |
  | ---------- | -------------------------- |
  | `coord_x1` | <ApiLink name="int16_t" /> |
  | `coord_y1` | <ApiLink name="int16_t" /> |
  | `coord_x2` | <ApiLink name="int16_t" /> |
  | `coord_y2` | <ApiLink name="int16_t" /> |
  | `radius`   | <ApiLink name="int16_t" /> |
</ApiMember>

<ApiMember kind="function" name="lv_eve_bitmap_source" file="draw/eve/lv_eve.h" line="105" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L105">
  lv_eve_bitmap_source [#lv_eve_bitmap_source]

  Set the bitmap source to `addr`. SPI transmission will occur unless it is already set to this value. The bitmap source is not part of the saved and restored context.

  ```c title=" " lineNumbers=1
  void lv_eve_bitmap_source(uint32_t addr)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name   | Type                        | Description                                               |
  | ------ | --------------------------- | --------------------------------------------------------- |
  | `addr` | <ApiLink name="uint32_t" /> | the remote EVE memory address to set as the bitmap source |
</ApiMember>

<ApiMember kind="function" name="lv_eve_bitmap_size" file="draw/eve/lv_eve.h" line="116" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L116">
  lv_eve_bitmap_size [#lv_eve_bitmap_size]

  Set the bitmap size and sampling parameters. SPI transmission will occur unless the currently set parameters are already these. The bitmap size is not part of the saved and restored context.

  ```c title=" " lineNumbers=1
  void lv_eve_bitmap_size(uint8_t filter, uint8_t wrapx, uint8_t wrapy, uint16_t width, uint16_t height)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name     | Type                        | Description                                                                               |
  | -------- | --------------------------- | ----------------------------------------------------------------------------------------- |
  | `filter` | <ApiLink name="uint8_t" />  | the sampling method. Either EVE\_NEAREST or EVE\_BILINEAR                                 |
  | `wrapx`  | <ApiLink name="uint8_t" />  | the out of bounds sampling behavior in the X direction. Either EVE\_BORDER or EVE\_REPEAT |
  | `wrapy`  | <ApiLink name="uint8_t" />  | the out of bounds sampling behavior in the Y direction. Either EVE\_BORDER or EVE\_REPEAT |
  | `width`  | <ApiLink name="uint16_t" /> | the width of the bitmap in pixels                                                         |
  | `height` | <ApiLink name="uint16_t" /> | the height of the bitmap in pixels                                                        |
</ApiMember>

<ApiMember kind="function" name="lv_eve_bitmap_layout" file="draw/eve/lv_eve.h" line="125" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L125">
  lv_eve_bitmap_layout [#lv_eve_bitmap_layout]

  Set the bitmap format/layout parameters. SPI transmission will occur unless the currently set parameters are already these. The bitmap layout is not part of the saved and restored context.

  ```c title=" " lineNumbers=1
  void lv_eve_bitmap_layout(uint8_t format, uint16_t linestride, uint16_t height)
  ```

  <span className="sr-only">
    Parameters
  </span>

  | Name         | Type                        | Description                                |
  | ------------ | --------------------------- | ------------------------------------------ |
  | `format`     | <ApiLink name="uint8_t" />  | an eve color format value like EVE\_RGB565 |
  | `linestride` | <ApiLink name="uint16_t" /> | the stride of the bitmap rows in bytes     |
  | `height`     | <ApiLink name="uint16_t" /> | the number of rows in the bitmap           |
</ApiMember>

Enums [#enums]

<ApiMember kind="enum" name="lv_eve_primitive_t" file="draw/eve/lv_eve.h" line="38" url="https://github.com/lvgl/lvgl/tree/a7b95c5b0839ce901c09c205610bc2c77cc3345d/src/draw/eve/lv_eve.h#L38">
  lv_eve_primitive_t [#lv_eve_primitive_t]

  | Name                            | Value |
  | ------------------------------- | ----- |
  | `LV_EVE_PRIMITIVE_ZERO_VALUE`   |       |
  | `LV_EVE_PRIMITIVE_BITMAPS`      | `1UL` |
  | `LV_EVE_PRIMITIVE_POINTS`       | `2UL` |
  | `LV_EVE_PRIMITIVE_LINES`        | `3UL` |
  | `LV_EVE_PRIMITIVE_LINE_STRIP`   | `4UL` |
  | `LV_EVE_PRIMITIVE_EDGE_STRIP_R` | `5UL` |
  | `LV_EVE_PRIMITIVE_EDGE_STRIP_L` | `6UL` |
  | `LV_EVE_PRIMITIVE_EDGE_STRIP_A` | `7UL` |
  | `LV_EVE_PRIMITIVE_EDGE_STRIP_B` | `8UL` |
  | `LV_EVE_PRIMITIVE_RECTS`        | `9UL` |
</ApiMember>

Structs [#structs]

<ApiMember kind="struct" name="lv_eve_drawing_context_t">
  lv_eve_drawing_context_t [#lv_eve_drawing_context_t]

  | Member         | Type                                  | Description |
  | -------------- | ------------------------------------- | ----------- |
  | `primitive`    | <ApiLink name="lv_eve_primitive_t" /> |             |
  | `color`        | <ApiLink name="lv_color_t" />         |             |
  | `opa`          | <ApiLink name="lv_opa_t" />           |             |
  | `line_width`   | <ApiLink name="int32_t" />            |             |
  | `point_size`   | <ApiLink name="uint16_t" />           |             |
  | `color_mask`   | `uint8_t[4]`                          |             |
  | `stencil_func` | `uint8_t[3]`                          |             |
  | `stencil_op`   | `uint8_t[2]`                          |             |
  | `blend_func`   | `uint8_t[2]`                          |             |
  | `scx`          | <ApiLink name="uint16_t" />           |             |
  | `scy`          | <ApiLink name="uint16_t" />           |             |
</ApiMember>

<ApiMember kind="struct" name="lv_eve_drawing_state_t">
  lv_eve_drawing_state_t [#lv_eve_drawing_state_t]

  | Member            | Type                        | Description |
  | ----------------- | --------------------------- | ----------- |
  | `bitmap_source`   | <ApiLink name="uint32_t" /> |             |
  | `bitmap_size`     | <ApiLink name="uint32_t" /> |             |
  | `bitmap_size_h`   | <ApiLink name="uint32_t" /> |             |
  | `bitmap_layout`   | <ApiLink name="uint32_t" /> |             |
  | `bitmap_layout_h` | <ApiLink name="uint32_t" /> |             |
</ApiMember>

Dependencies [#dependencies]

<FileIncludes includes="[&#x22;lv_draw_eve.h&#x22;, &#x22;lv_types.h&#x22;, &#x22;lv_color.h&#x22;, &#x22;EVE.h&#x22;]" transitiveIncludes="[&#x22;lv_assert.h&#x22;, &#x22;lv_color_op.h&#x22;, &#x22;lv_conf_internal.h&#x22;, &#x22;lv_conf_kconfig.h&#x22;, &#x22;lv_draw_eve_target.h&#x22;, &#x22;lv_log.h&#x22;, &#x22;lv_math.h&#x22;, &#x22;lv_mem.h&#x22;, &#x22;lv_palette.h&#x22;, &#x22;lv_string.h&#x22;]" />
