<!--
{
  "availability" : [
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CompositorServices",
  "identifier" : "/documentation/CompositorServices/LayerRenderer/renderQuality-swift.property",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Compositor Services",
      "CompositorServices"
    ],
    "preciseIdentifier" : "c:@F@cp_layer_renderer_get_render_quality"
  },
  "title" : "renderQuality"
}
-->

# renderQuality

Get the render quality to be used by the drawables.

```
var renderQuality: LayerRenderer.RenderQuality { get set }
```

## Discussion

The render quality will increase the resolution at which rendering happens.
This value cannot exceed the quality specified on the layer renderer configuration
see [`cp_layer_renderer_configuration_set_max_render_quality`](/documentation/CompositorServices/cp_layer_renderer_configuration_set_max_render_quality).
The quality will be changed to the target render quality over a set duration to hide
the transition of quality from the user.

The renderer should monitor its frame rate to determine whether its making the frames
on time. If it is unable to maintain proper frame rate, the app should reduce the render
quality, reduce the scene complexity, or increase the frame repeat count see
[`cp_layer_renderer_set_minimum_frame_repeat_count`](/documentation/CompositorServices/cp_layer_renderer_set_minimum_frame_repeat_count).
It is generally preferable to reduce anything else before increasing the frame repeat count.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)