The current device-specific white balance values required for a neutral gray white point.
SDKs
- iOS 8.0+
- Mac Catalyst 13.0+
Framework
- AVFoundation
Declaration
@property(nonatomic, readonly) AVCapture White Balance Gains grayWorldDeviceWhiteBalanceGains;
Discussion
This property specifies the current red, green, and blue gain values derived from the current scene to deliver a neutral (or gray world) white point for white balance.
Gray world values assume a neutral subject (for example, a gray card) has been placed in the middle of the subject area and fills the center 50% of the frame. Clients can read these values and apply them to the device using set
.
For each channel, only values between 1
and max
are supported. The value can be read at any time, regardless of white balance mode.
You can observe changes to the value of this property using Key-value observing.