---
title: CNImageRenderingSession
framework: Cinematic
role: symbol
role_heading: Class
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+]
path: cinematic/cnimagerenderingsession
---

# CNImageRenderingSession

A session for rendering a shallow depth-of-field (SDoF) effect onto still images using Metal.

## Declaration

```swift
class CNImageRenderingSession
```

## Overview

Overview Use CNImageRenderingSession to apply a cinematic, lens-simulated bokeh effect to an image given a disparity map. For large images, prefer the tiled API to avoid excessive GPU memory usage. A single session may be reused across multiple render calls. It is not thread-safe.

## Topics

### Initializers

- [init(configuration:)](cinematic/cnimagerenderingsession/init(configuration:).md)

### Instance Properties

- [configuration](cinematic/cnimagerenderingsession/configuration.md)

### Instance Methods

- [encodeRender(to:sourceRGBA:sourceDisparity:destinationRGBA:fNumber:focusDisparity:)](cinematic/cnimagerenderingsession/encoderender(to:sourcergba:sourcedisparity:destinationrgba:fnumber:focusdisparity:).md)
- [encodeTileRender(to:sourceTileRGBA:sourceDisparity:destinationTileRGBA:fNumber:focusDisparity:sourceRGBASize:tileOffset:tileExtendOffset:)](cinematic/cnimagerenderingsession/encodetilerender(to:sourcetilergba:sourcedisparity:destinationtilergba:fnumber:focusdisparity:sourcergbasize:tileoffset:tileextendoffset:).md)

### Type Methods

- [minimumTileExtendRect(forTileRect:sourceRGBASize:)](cinematic/cnimagerenderingsession/minimumtileextendrect(fortilerect:sourcergbasize:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)