Contents

saveGState()

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

Declaration

func saveGState()

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 restoreGState().

See Also

Saving and Restoring Graphics State