Instance Property

flashMode

A setting for whether to fire the flash when capturing photos.

Declaration

@property(nonatomic) AVCaptureFlashMode flashMode;

Discussion

The default value for this setting is AVCaptureFlashModeOff.

Assuming a static scene, using the AVCaptureFlashModeAuto setting is equivalent to testing the AVCapturePhotoOutput isFlashScene property (which indicates whether flash is recommended for the scene currently visible to the camera), and then setting the flashMode property of your photo settings output accordingly before requesting a capture. However, the visible scene can change between when you request a capture and when the camera hardware captures an image—the automatic setting ensures that the flash is enabled or disabled appropriately at the moment of capture. When the capture occurs, your AVCapturePhotoCaptureDelegate methods receive an AVCaptureResolvedPhotoSettings object whose flashEnabled property indicates which flash mode was used for that capture.

When specifying a flash mode, the following requirements apply:

The capture output validates these requirements when you call the capturePhotoWithSettings:delegate: method. If your settings do not meet these requirements, that method raises an exception.

See Also

Configuring Photo Settings

autoRedEyeReductionEnabled

A Boolean value that determines whether to use auto red-eye reduction on flash captures.

highResolutionPhotoEnabled

A Boolean value that specifies whether to capture still images at the highest resolution supported by the active device and format.

cameraCalibrationDataDeliveryEnabled

A Boolean value that determines whether a dual photo capture also delivers camera calibration data.

photoQualityPrioritization

A setting that indicates how to prioritize photo quality against speed of photo delivery.

autoVirtualDeviceFusionEnabled

A Boolean value that specifies whether to use automatic virtual-device image fusion.

virtualDeviceConstituentPhotoDeliveryEnabledDevices

The constituent devices for which the virtual device should deliver photos.

autoStillImageStabilizationEnabled

A Boolean value that specifies whether captures use automatic image stabilization.

Deprecated
autoDualCameraFusionEnabled

A Boolean value that specifies whether captures automatically combine data from a dual camera device.

Deprecated
dualCameraDualPhotoDeliveryEnabled

A Boolean value that determines whether a dual camera device delivers images from both cameras.

Deprecated