cf_canvas_readback¶
Category: graphics
GitHub: cute_graphics.h
Initiates an async GPU-to-CPU copy of pixel data from a canvas.
| Parameters | Description |
|---|---|
canvas |
The canvas to read back pixel data from. |
Return Value¶
Returns a CF_Readback handle. Returns a zero handle on failure, such as a target format the backend can't read back.
Remarks¶
Works on every backend: SDL_GPU, WebGPU, and GLES3/WebGL2. Ends any active render pass silently. Each readback uses its own command buffer and fence.
For screen readback, use cf_canvas_readback(cf_app_get_canvas()).
Related Pages¶
CF_Readback
cf_readback_ready
cf_readback_data
cf_readback_size
cf_destroy_readback