Instance Method

setExposureTargetBias:completionHandler:

Sets the bias to be applied to the target exposure value.

Declaration

- (void)setExposureTargetBias:(float)bias completionHandler:(void (^)(CMTime syncTime))handler;

Parameters

bias

The bias to be applied to the exposure target value.

handler

A block to be called when the exposureTargetBias property has been set to the value specified.

The block receives a timestamp that matches that of the first buffer to which the setting has been applied. The timestamp is synchronized to the device clock, and thus must be converted to the master clock before comparison with the timestamps of buffers delivered via an AVCaptureVideoDataOutput instance.

The client may pass nil for the handler parameter if knowledge of the operation's completion is not required.

Discussion

This method is the only way to set the exposureTargetBias property.

This method throws an NSInvalidArgumentException exception if exposureTargetBias is set to an unsupported level. A NSGenericException exception is thrown if this method is invoked without first obtaining exclusive access to the receiver using lockForConfiguration:.

See Also

Managing Image Exposure

exposureDuration

The length of time over which exposure takes place.

- setExposureModeCustomWithDuration:ISO:completionHandler:

Locks the exposure duration and ISO at the specified values.

exposureTargetOffset

The metered exposure level's offset from the target exposure value, in EV units.

exposureTargetBias

Bias applied to the target exposure value, in EV units.

minExposureTargetBias

The minimum supported exposure bias, in EV units.

maxExposureTargetBias

The maximum supported exposure bias, in EV units.

activeMaxExposureDuration

The maximum exposure duration, in seconds, defined in the auto-exposure algorithm.

AVCaptureExposureTargetBiasCurrent

A special constant representing the current exposure bias value.

AVCaptureExposureDurationCurrent

A special constant representing the current exposure duration setting.