Instance Property

torchMode

The current torch mode.

Declaration

@property(nonatomic) AVCaptureTorchMode torchMode;

Discussion

Setting the value of this property also sets the torch level to its maximum current value.

Before setting the value of this property, call the isTorchModeSupported: method to make sure the device supports the desired mode. Setting the device to an unsupported torch mode results in the raising of an exception. For a list of possible values for this property, see AVCaptureTorchMode.

Before changing the value of this property, you must call lockForConfiguration: to acquire exclusive access to the device’s configuration properties. Otherwise, setting the value of this property raises an exception. When you finish configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.

You can observe changes to the value of this property using Key-value observing.

See Also

Managing Torch Settings

hasTorch

A Boolean value that specifies whether the capture device has a torch.

torchAvailable

Indicates whether the torch is currently available for use.

torchActive

A Boolean value indicating whether the device’s torch is currently active.

torchLevel

The current torch brightness level.

AVCaptureTorchMode

Constants to specify the capture device’s torch mode.

- isTorchModeSupported:

Returns a Boolean value that indicates whether the device supports the specified torch mode.

- setTorchModeOnWithLevel:error:

Sets the illumination level when in torch mode.