1TICKIT_RENDERBUFFER_SAVE(3)Library Functions ManualTICKIT_RENDERBUFFER_SAVE(3)
2
3
4
6 tickit_renderbuffer_save, tickit_renderbuffer_restore, tickit_render‐
7 buffer_savepen - save and restore auxiliary state
8
10 #include <tickit.h>
11
12 void tickit_renderbuffer_save(TickitRenderBuffer *rb);
13 void tickit_renderbuffer_restore(TickitRenderBuffer *rb);
14 void tickit_renderbuffer_savepen(TickitRenderBuffer *rb);
15
16 Link with -ltickit.
17
19 tickit_renderbuffer_save() pushes a new entry to the buffer's saved
20 state stack. This will capture the current values of the auxiliary
21 state, which can be later restored using tickit_renderbuffer_restore().
22
23 tickit_renderbuffer_restore() pops the most recent entry on the buf‐
24 fer's saved state stack and reverts the values of the auxiliary state
25 back to the saved values.
26
27 tickit_renderbuffer_savepen() pushes a new entry to the stack contain‐
28 ing just the current pen value. When it is restored, it will only
29 restore the pen; the other attributes will be unaffected.
30
32 The state saved and restored by these functions is:
33
34 * the virtual cursor position
35
36 * the translation offset
37
38 * the clipping rectangle
39
40 * the current pen
41
42 * the set of masked regions
43
44 The pending content is not part of the state stack. It is intended that
45 the state stack be used to help implement recursive drawing operations
46 within the application, by dividing it into separate independent areas;
47 allowing the state to be saved and restored between component parts.
48
50 None of these functions return a value.
51
53 tickit_renderbuffer_new(3), tickit_renderbuffer_reset(3), tickit_ren‐
54 derbuffer(7), tickit(7)
55
56
57
58 TICKIT_RENDERBUFFER_SAVE(3)