---
title: CGShadingRetain
framework: coregraphics
role: symbol
role_heading: Function
path: coregraphics/cgshadingretain
---

# CGShadingRetain

Increments the retain count of a shading object.

## Declaration

```occ
extern CGShadingRefCGShadingRetain(CGShadingRef shading);
```

## Parameters

- `shading`: The shading object to retain.

## Return Value

Return Value The same shading object you passed in as the shading parameter.

## Discussion

Discussion This function is equivalent to CFRetain, except that it does not cause an error if the shading parameter is NULL.

## See Also

### Retaining and Releasing Shading Objects

- [CGShadingRelease](coregraphics/cgshadingrelease.md)