Instance Property

shutterOpenInterval

The duration, in seconds, for which the camera’s simulated shutter is open during each frame.

Declaration

var shutterOpenInterval: TimeInterval { get set }

Discussion

In a real-world camera, the shutter speed determines both the amount of light reaching the imaging surface (film or sensor) and the severity of effects such as motion blur. Shutter time is not the same as frame rate—for example, in a cinema camera running at 24 frames per second, the shutter is open for half of each frame’s duration, so the corresponding shutter time is 1/48 second.

Because shutter time is related to visual effects, not other time-based aspects of rendering a scene, a renderer should treat this property as constant even when those other aspects (such as animation frame rate or frame processing time) vary.

See Also

Modeling a Physical Lens

var barrelDistortion: Float

The first coefficient for determining the radial distortion applied to pixels rendered using the camera.

var fisheyeDistortion: Float

The second coefficient for determining the radial distortion applied to pixels rendered using the camera.

var opticalVignetting: Float

The amount of radial light attenuation around the edges of an image rendered using the camera.

var chromaticAberration: Float

The amount of radial color shift around the edges of an image rendered using the camera.

var focalLength: Float

The focal length, in millimeters, of the camera’s simulated lens.

var fStop: Float

The relative aperture ratio of the camera’s simulated lens.

var apertureBladeCount: Int

The number of blades in the camera’s simulated aperture.

func bokehKernel(withSize: vector_int2) -> MDLTexture

Creates and returns a texture, based on the camera’s aperture blade count, to be used in rendering out-of-focus highlights in a scene.

var maximumCircleOfConfusion: Float

The maximum diameter, in millimeters on the imaging plane, at which light from a point source should appear in an image rendered using the camera.

var focusDistance: Float

The distance, in meters, at which the lens is focused.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software