<!--
{
  "availability" : [
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CompositorServices",
  "identifier" : "/documentation/CompositorServices/cp_layer_renderer_set_render_quality",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Compositor Services"
    ],
    "preciseIdentifier" : "c:@F@cp_layer_renderer_set_render_quality"
  },
  "title" : "cp_layer_renderer_set_render_quality"
}
-->

# cp_layer_renderer_set_render_quality

Set the render quality to be used by the drawables.

```
void cp_layer_renderer_set_render_quality(cp_layer_renderer_t layer_renderer, cp_render_quality_t render_quality);
```

## Parameters

`layer_renderer`

The layer on which you’re drawing.

`render_quality`

The value of quality [0, 1].
With 0 being the minimum quality that is supported on the device,
and 1 being the highest quality that is supported on the device.

## 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)