Cinematic lets you read, edit, and render Cinematic-mode video captured with focus decisions, detection tracks, and depth-based rack focus. You load a movie's composition through CNAssetInfo and CNCompositionInfo, then inspect and modify its CNScript of focus CNDecision values over CNDetection results carried by CNDetectionTrack, CNFixedDetectionTrack, and CNCustomDetectionTrack, identifying subjects by CNDetectionID, CNDetectionGroupID, and CNDetectionType. You track subjects with CNObjectTracker and CNBoundsPrediction, and render frames or sessions using CNImageRenderingSession and CNRenderingSession with configurable CNRenderingQuality and spatial-audio options described by CNAssetSpatialAudioInfo, CNSpatialAudioRenderingStyle, and CNSpatialAudioContentType.
Loading Cinematic Assets 4
Access the composition, focus script, and spatial-audio details of a Cinematic-mode movie.
- ClCNAssetInfoiOS 17.0+An object that provides access to the Cinematic-mode information carried by a movie asset.
- ClCNCompositionInfoiOS 17.0+An object that exposes the composition of a Cinematic movie for inspection and editing.
- ClCNScriptiOS 17.0+Database of focus decisions with methods to change them.
- ClCNAssetSpatialAudioInfoiOS 26.0+An object that describes the spatial-audio characteristics of a Cinematic movie asset.
Focus Decisions 1
Inspect and modify the focus decisions that drive a Cinematic video's depth-based rack focus.
- StCNDecisioniOS 17.0+Represents a decision to focus on a specific detectionID or groupID; optionally strong.
Subject Detections 4
Work with the detected subjects and detection results that the focus script reasons over.
- StCNDetectioniOS 17.0+A cinematic detection of a subject.
- StCNDetectionIDA value that uniquely identifies an individual detection in a Cinematic video.
- StCNDetectionGroupIDA value that uniquely identifies a group of related detections in a Cinematic video.
- EnCNDetectionTypemacOS 14.0+The type of object that was detected.
Detection Tracks 3
Carry detection results over time using built-in, fixed, and custom track implementations.
- ClCNDetectionTrackiOS 17.0+An object that carries a sequence of detection results over the duration of a Cinematic video.
- ClCNFixedDetectionTrackiOS 17.0+A detection track whose detection results remain fixed across the video's timeline.
- ClCNCustomDetectionTrackiOS 17.0+The original detection upon which this fixed detection track was based.
Object Tracking 2
Track subjects across frames and predict their bounds for custom detection.
- ClCNObjectTrackeriOS 17.0+Converts a normalized point or rectangle into a detection track that tracks an object over time.
- StCNBoundsPredictioniOS 17.0+A value that predicts the bounds of a tracked subject in an upcoming frame.
Rendering 4
Render individual frames or full editing sessions with configurable quality.
- ClCNImageRenderingSessionmacOS 27.0+A session for rendering a shallow depth-of-field (SDoF) effect onto still images using Metal.
- ClCNImageRenderingSessionConfigurationmacOS 27.0+Configuration for a CNImageRenderingSession, specifying the rendering quality and algorithm version.
- ClCNRenderingSessioniOS 17.0+An object that renders an editing session of a Cinematic video.
- EnCNRenderingQualitymacOS 14.0+Constants that specify the quality level used when rendering Cinematic video.
Spatial Audio 2
Describe the rendering style and content type of a movie's spatial audio.
- EnCNSpatialAudioRenderingStylemacOS 26.0+@enum CNSpatialAudioRenderingStyle
- EnCNSpatialAudioContentTypemacOS 26.0+@enum CNSpatialAudioContentType
Errors 1
Handle errors raised by Cinematic operations.
- StCNCinematicErrormacOS 14.0+A structure that describes errors raised by Cinematic operations.