Instance Method

chromaticityValuesForDeviceWhiteBalanceGains:

Converts device-specific white balance RGB gain values to device-independent chromaticity values.

Declaration

- (AVCaptureWhiteBalanceChromaticityValues)chromaticityValuesForDeviceWhiteBalanceGains:(AVCaptureWhiteBalanceGains)whiteBalanceGains;

Parameters

whiteBalanceGains

The white balance gain values. A value of AVCaptureWhiteBalanceGainsCurrent may not be used.

Return Value

A fully populated AVCaptureWhiteBalanceChromaticityValues structure containing device-independent values.

Discussion

This method may be called on the receiver to convert device-specific white balance RGB gain values to device-independent chromaticity (little x, little y) values.

For each channel in the whiteBalanceGains structure, only values between 1.0 and maxWhiteBalanceGain are supported. This method throws an NSInvalidArgumentException exception if any of the whiteBalanceGains fields are set to unsupported values.

See Also

Managing the White Balance

- isWhiteBalanceModeSupported:

Returns a Boolean value that indicates whether the given white balance mode is supported.

whiteBalanceMode

The current white balance mode.

adjustingWhiteBalance

Indicates whether the devise is currently adjusting the white balance.

deviceWhiteBalanceGains

The current device-specific RGB white balance gain values.

maxWhiteBalanceGain

The maximum supported value to which a channel in the AVCaptureWhiteBalanceGains may be set.

- deviceWhiteBalanceGainsForChromaticityValues:

Converts device-independent chromaticity values to device-specific white balance RGB gain values.

- deviceWhiteBalanceGainsForTemperatureAndTintValues:

Converts device-independent temperature and tint values to device-specific white balance RGB gain values.

grayWorldDeviceWhiteBalanceGains

The current device-specific white balance values required for a neutral gray white point.

- setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:

Sets white balance to locked mode with the specified deviceWhiteBalanceGains values.

- temperatureAndTintValuesForDeviceWhiteBalanceGains:

Converts device-specific white balance RGB gain values to device-independent temperature and tint values.

lockingWhiteBalanceWithCustomDeviceGainsSupported

A Boolean value indicating whether the device supports locking white balance to specific gain values.

AVCaptureWhiteBalanceGainsCurrent

A special constant representing the current white balance setting.

AVCaptureWhiteBalanceGains

Structure containing RGB white balance gain values.

AVCaptureWhiteBalanceChromaticityValues

Structure containing CIE 1931 xy chromaticity values.

AVCaptureWhiteBalanceTemperatureAndTintValues

Structure containing temperature and tint values correlated to a white-balance color.

AVCaptureWhiteBalanceMode

Constants to specify the white balance mode of a capture device.