# lv_nanovg_image_cache.h (/api/private/draw/nanovg/lv_nanovg_image_cache_h)



<ApiSummary functions="4" />

Functions [#functions]

<ApiTabs items="[&#x22;Getters (1)&#x22;,&#x22;Other (3)&#x22;]">
  <ApiTab value="Getters (1)">
    <ApiMember kind="function" name="lv_nanovg_image_cache_get_handle" file="private/draw/nanovg/lv_nanovg_image_cache.h" line="59" url="https://github.com/lvgl/lvgl/tree/e1a0ad863f29742359bc680d6a7d973448ec2285/src/draw/nanovg/lv_nanovg_image_cache.h#L59">
      lv_nanovg_image_cache_get_handle [#lv_nanovg_image_cache_get_handle]

      Get the image handle from the cache, create a new one if not found.

      ```c title=" " lineNumbers=1
      int lv_nanovg_image_cache_get_handle(struct _lv_draw_nanovg_unit_t *u, const void *src, int image_flags, lv_image_header_t *header)
      ```

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

      | Name          | Type                                                                                | Description                            |
      | ------------- | ----------------------------------------------------------------------------------- | -------------------------------------- |
      | `u`           | <ApiLink name="_lv_draw_nanovg_unit_t" display="struct _lv_draw_nanovg_unit_t *" /> | pointer to the nanovg unit             |
      | `src`         | `const void *`                                                                      | the source image data                  |
      | `image_flags` | `int`                                                                               | the image flags                        |
      | `header`      | <ApiLink name="lv_image_header_t" display="lv_image_header_t *" />                  | the image header to fill (can be NULL) |

      **Returns:** `int` — the image handle, or -1 on failure

      <Callout type="info">
        Modifiable sources (canvas/snapshot/lottie) are detected via the decoded buffer flags and are not cached, so callers don't need to decide.
      </Callout>
    </ApiMember>
  </ApiTab>

  <ApiTab value="Other (3)">
    <ApiMember kind="function" name="lv_nanovg_image_cache_init" file="private/draw/nanovg/lv_nanovg_image_cache.h" line="41" url="https://github.com/lvgl/lvgl/tree/e1a0ad863f29742359bc680d6a7d973448ec2285/src/draw/nanovg/lv_nanovg_image_cache.h#L41">
      lv_nanovg_image_cache_init [#lv_nanovg_image_cache_init]

      Initialize the image cache.

      ```c title=" " lineNumbers=1
      void lv_nanovg_image_cache_init(struct _lv_draw_nanovg_unit_t *u)
      ```

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

      | Name | Type                                                                                | Description                |
      | ---- | ----------------------------------------------------------------------------------- | -------------------------- |
      | `u`  | <ApiLink name="_lv_draw_nanovg_unit_t" display="struct _lv_draw_nanovg_unit_t *" /> | pointer to the nanovg unit |
    </ApiMember>

    <ApiMember kind="function" name="lv_nanovg_image_cache_deinit" file="private/draw/nanovg/lv_nanovg_image_cache.h" line="47" url="https://github.com/lvgl/lvgl/tree/e1a0ad863f29742359bc680d6a7d973448ec2285/src/draw/nanovg/lv_nanovg_image_cache.h#L47">
      lv_nanovg_image_cache_deinit [#lv_nanovg_image_cache_deinit]

      Deinitialize the image cache.

      ```c title=" " lineNumbers=1
      void lv_nanovg_image_cache_deinit(struct _lv_draw_nanovg_unit_t *u)
      ```

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

      | Name | Type                                                                                | Description                |
      | ---- | ----------------------------------------------------------------------------------- | -------------------------- |
      | `u`  | <ApiLink name="_lv_draw_nanovg_unit_t" display="struct _lv_draw_nanovg_unit_t *" /> | pointer to the nanovg unit |
    </ApiMember>

    <ApiMember kind="function" name="lv_nanovg_image_cache_drop" file="private/draw/nanovg/lv_nanovg_image_cache.h" line="69" url="https://github.com/lvgl/lvgl/tree/e1a0ad863f29742359bc680d6a7d973448ec2285/src/draw/nanovg/lv_nanovg_image_cache.h#L69">
      lv_nanovg_image_cache_drop [#lv_nanovg_image_cache_drop]

      Drop the image from the cache.

      ```c title=" " lineNumbers=1
      void lv_nanovg_image_cache_drop(struct _lv_draw_nanovg_unit_t *u, const void *src)
      ```

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

      | Name  | Type                                                                                | Description                |
      | ----- | ----------------------------------------------------------------------------------- | -------------------------- |
      | `u`   | <ApiLink name="_lv_draw_nanovg_unit_t" display="struct _lv_draw_nanovg_unit_t *" /> | pointer to the nanovg unit |
      | `src` | `const void *`                                                                      | the source image data      |
    </ApiMember>
  </ApiTab>
</ApiTabs>

Dependencies [#dependencies]

<FileIncludes includes="[&#x22;lvgl_public.h&#x22;, &#x22;lv_draw_image_private.h&#x22;]" includedBy="[&#x22;lvgl_private.h&#x22;]" />