# Using Metal performance shaders to create custom postprocess effects Leverage the Metal Performance Shaders framework to create special rendering effects for your RealityKit scenes. ## Overview In iOS 15 and later, and macOS 12 and later, you can apply postprocess effects to a RealityKit scene after RealityKit renders it, but before RealityKit displays it. If you register a postprocess callback function, RealityKit passes that function the complete, rendered frame so you can modify it before the viewer sees it. You can use any image processing or drawing APIs on the rendered frame but, as a practical matter, only APIs that execute on the GPU are fast enough to use every frame and maintain a good framerate. One way to implement postprocess effects is to apply filters from the framework to the rendered scene. You can use apply these filters to an image without writing any custom shader code. Because these filters run on the GPU and operate directly on Metal textures, they’re a good choice for postprocessing effects. If the Metal Performance Shaders framework doesn’t provide an image filter that meets your needs, you can also use Core Image to postprocess frames. Core Image provides a greater selection of image filters, which also run on the GPU, but Core Image requires you to convert the rendered frame into a . For more information, see [Applying core image filters as a postprocess effect](/documentation/RealityKit/applying-core-image-filters-as-a-postprocess-effect). If neither the Metal Performance Shaders framework nor Core Image provide the effect you need, you can also write custom compute functions to implement postprocess effects. For more information, see [Implementing postprocess effects using Metal compute functions](/documentation/RealityKit/implementing-postprocess-effects-using-metal-compute-functions). ### Check the output texture pixel format Some device GPUs require that the output texture be in a specific pixel format. If the device your code is running on doesn’t support , convert the output texture to before using it. For more information, see [Checking the pixel format of a postprocess effect’s output texture](/documentation/RealityKit/checking-the-pixel-format-of-a-postprocess-effect-s-output-texture). ### Create a callback function To create postprocess effects using image filters from the Metal Performance Shaders framework, create a Swift function that takes a single [`ARView.PostProcessContext`](/documentation/RealityKit/ARView/PostProcessContext) parameter. In that method, create and configure an instance of the filter that you want to apply using the [`device`](/documentation/RealityKit/ARView/PostProcessContext/device) property from the context. Once you’ve created an instance of the shader, call its encode method, passing the command buffer, source color texture, and output texture from the context. ```swift func postEffectMPSGaussianBlur(context: ARView.PostProcessContext) { let gaussianBlur = MPSImageGaussianBlur(device: context.device, sigma: 4) gaussianBlur.encode(commandBuffer: context.commandBuffer, sourceTexture: context.sourceColorTexture, destinationTexture: context.compatibleTargetTexture) ``` > Note: The `compatibleTargetTexture` property referenced above is a derived property > based on ``doc://com.apple.RealityKit/documentation/RealityKit/ARView/PostProcessContext/targetColorTexture``. It ensures > that the output texture uses the appropriate pixel format for the current device. > For more information, see . ### Register the callback function To apply the effect, register the function as the [`postProcess`](/documentation/RealityKit/ARView/RenderCallbacks-swift.struct/postProcess) render callback for the [`ARView`](/documentation/RealityKit/ARView). ```swift arView.renderCallbacks.postProcess = postEffectMPSGaussianBlur ``` > Note: For more information on using Metal Performance Shader framework image filters > to create postprocess effects, see the > sample code project. --- Copyright © 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)