Skip to content

cf_draw_list_begin

Category: draw
GitHub: cute_draw.h

Starts recording draw calls into a list, replacing its previous contents.

void cf_draw_list_begin(CF_DrawList list);

Remarks

Recording happens in list-local space: the camera resets to identity for the duration, and cf_draw_list composes the then-current transform onto the recording at replay. Layers are list-local too: they record relative to the layer that is current when recording begins, and replay offsets them onto the then-current layer. The render state follows closure rules: one pushed inside the recording (cf_draw_push_render_state, or cf_draw3d_push_render_state for meshes) records frozen, even when equal to the current one; draws recorded without one bind the render state that is pushed when cf_draw_list replays them. Text records a static snapshot (animated text effects freeze at record time). Canvas blits (cf_draw_canvas) cannot be recorded. End with cf_draw_list_end.

CF_DrawList
cf_make_draw_list
cf_destroy_draw_list
cf_draw_list_end
cf_draw_list