Instance Property

wantsHDR

A Boolean value that determines whether SceneKit applies High Dynamic Range (HDR) postprocessing effects to a scene.

Declaration

@property(nonatomic) BOOL wantsHDR;

Discussion

When this property’s value is NO (the default), SceneKit performs lighting calculations in a color space whose brightness range is similar to that of the output display. This approach limits the ability to perform realistic rendering of scenes with fine details in brightness levels.

When you enable HDR rendering for a camera, SceneKit calculates lighting in a much deeper color space, preserving fine details in contrast regardless of brightness, then applies a post-processing effect called tone mapping to translate luminance values from that space to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve (including the exposure level) from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties along with a measure of scene luminance. The wantsExposureAdaptation property determines whether tone mapping effects are static or dynamically respond when the luminance visible to the camera changes.

The default value is NO.

See Also

Adding High Dynamic Range Effects

exposureOffset

A logarithmic bias that adjusts the results of SceneKit’s tone mapping operation, brightening or darkening the visible scene.

averageGray

The luminance level to use as the midpoint of a tone mapping curve.

whitePoint

The luminance level to use as the upper end of a tone mapping curve.

minimumExposure

The minimum exposure value to use in tone mapping.

maximumExposure

The minimum exposure value to use in tone mapping.