Function

CGContextSaveGState

Pushes a copy of the current graphics state onto the graphics state stack for the context.

Declaration

void CGContextSaveGState(CGContextRef c);

Parameters

c

The graphics context whose current graphics state you want to save.

Discussion

Each graphics context maintains a stack of graphics states. Note that not all aspects of the current drawing environment are elements of the graphics state. For example, the current path is not considered part of the graphics state and is therefore not saved when you call this function. The graphics state parameters that are saved are:

  • CTM (current transformation matrix)

  • clip region

  • image interpolation quality

  • line width

  • line join

  • miter limit

  • line cap

  • line dash

  • flatness

  • should anti-alias

  • rendering intent

  • fill color space

  • stroke color space

  • fill color

  • stroke color

  • alpha value

  • font

  • font size

  • character spacing

  • text drawing mode

  • shadow parameters

  • the pattern phase

  • the font smoothing parameter

  • blend mode

To restore your drawing environment to a previously saved state, you can use CGContextRestoreGState.

See Also

Saving and Restoring the Current Graphics State

CGContextRestoreGState

Sets the current graphics state to the state most recently saved.