---
title: saveGState()
framework: coregraphics
role: symbol
role_heading: Instance Method
path: coregraphics/cgcontext/savegstate()
---

# saveGState()

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

## Declaration

```swift
func saveGState()
```

## Discussion

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

- [restoreGState()](coregraphics/cgcontext/restoregstate().md)
