Instance Property

highResolutionCaptureEnabled

A Boolean value that specifies whether to configure the capture pipeline for high resolution still image capture.

Declaration

@property(nonatomic, getter=isHighResolutionCaptureEnabled) BOOL highResolutionCaptureEnabled;

Discussion

Some capture formats support output of still images at a resolution higher than the resolution they use for live preview and video capture (see the AVCaptureDeviceFormat highResolutionStillImageDimensions property). Under some conditions, a capture session needs to set up its internal rendering pipeline differently to support high resolution still image capture.

If you intend to take high resolution still images at all, set this property to before calling the AVCaptureSession startRunning method. Changing this property while the session is running requires a lengthy reconfiguration of the capture render pipeline: Live Photo captures in progress will end immediately, unfulfilled photo requests will abort, and video preview will temporarily freeze.

You must enable this option before initiating a photo capture with the highResolutionPhotoEnabled property of your photo settings object set to YES. However, after you’ve enabled this option, you are free to issue photo capture requests with any highResolutionPhotoEnabled setting.