# lv_snapshot.h (/api/draw/snapshot/lv_snapshot_h)
Functions [#functions]
lv_snapshot_take [#lv_snapshot_take]
Take snapshot for object with its children, create the draw buffer as needed.
```c title=" " lineNumbers=1
lv_draw_buf_t * lv_snapshot_take(lv_obj_t *obj, lv_color_format_t cf)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | --------------------------------- |
| `obj` | | the object to generate snapshot. |
| `cf` | | color format for generated image. |
**Returns:** — a pointer to an draw buffer containing snapshot image, or NULL if failed.
lv_snapshot_create_draw_buf [#lv_snapshot_create_draw_buf]
Create a draw buffer to store the snapshot image for object.
```c title=" " lineNumbers=1
lv_draw_buf_t * lv_snapshot_create_draw_buf(lv_obj_t *obj, lv_color_format_t cf)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | --------------------------------- |
| `obj` | | the object to generate snapshot. |
| `cf` | | color format for generated image. |
**Returns:** — a pointer to an draw buffer ready for taking snapshot, or NULL if failed.
lv_snapshot_reshape_draw_buf [#lv_snapshot_reshape_draw_buf]
Reshape the draw buffer to prepare for taking snapshot for obj. This is usually used to check if the existing draw buffer is enough for obj snapshot. If return LV\_RESULT\_INVALID, you should create a new one.
```c title=" " lineNumbers=1
lv_result_t lv_snapshot_reshape_draw_buf(lv_obj_t *obj, lv_draw_buf_t *draw_buf)
```
Parameters
| Name | Type | Description |
| ---------- | ---------------------------------------------------------- | -------------------------------- |
| `obj` | | the object to generate snapshot. |
| `draw_buf` | | the draw buffer to reshape. |
lv_snapshot_take_to_draw_buf [#lv_snapshot_take_to_draw_buf]
Take snapshot for object with its children, save image info to provided buffer.
```c title=" " lineNumbers=1
lv_result_t lv_snapshot_take_to_draw_buf(lv_obj_t *obj, lv_color_format_t cf, lv_draw_buf_t *draw_buf)
```
Parameters
| Name | Type | Description |
| ---------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `obj` | | the object to generate snapshot. |
| `cf` | | color format for new snapshot image. It could differ with cf of `draw_buf` as long as the new cf will fit in. |
| `draw_buf` | | the draw buffer to store the image result. It's reshaped automatically. |
**Returns:** — LV\_RESULT\_OK on success, LV\_RESULT\_INVALID on error.
lv_snapshot_free [#lv_snapshot_free]
\> **Deprecated:** Use `lv_draw_buf_destroy` instead.
Free the snapshot image returned by
```c title=" " lineNumbers=1
void lv_snapshot_free(lv_image_dsc_t *dsc)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------------------ | ----------------------------------------------------- |
| `dsc` | | the image descriptor generated by lv\_snapshot\_take. |
lv_snapshot_take_to_buf [#lv_snapshot_take_to_buf]
Take snapshot for object with its children, save image info to provided buffer.
\> **Deprecated:** Use lv\_snapshot\_take\_to\_draw\_buf instead.
```c title=" " lineNumbers=1
lv_result_t lv_snapshot_take_to_buf(lv_obj_t *obj, lv_color_format_t cf, lv_image_dsc_t *dsc, void *buf, uint32_t buf_size)
```
Parameters
| Name | Type | Description |
| ---------- | ------------------------------------------------------------ | --------------------------------------------------------------- |
| `obj` | | the object to generate snapshot. |
| `cf` | | color format for generated image. |
| `dsc` | | image descriptor to store the image result. |
| `buf` | `void *` | the buffer to store image data. It must meet align requirement. |
| `buf_size` | | provided buffer size in bytes. |
**Returns:** — LV\_RESULT\_OK on success, LV\_RESULT\_INVALID on error.
Dependencies [#dependencies]