CameraMetadata.ControlAeModeOnLowLightBoostBrightnessPriority Field
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
This constant will be removed in the future version. Use Android.Hardware.Camera2.ControlAEMode enum directly instead of this field.
Like 'ON' but applies additional brightness boost in low light scenes.
[Android.Runtime.Register("CONTROL_AE_MODE_ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY", ApiSince=35)]
[System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.ControlAEMode enum directly instead of this field.", true)]
public const Android.Hardware.Camera2.ControlAEMode ControlAeModeOnLowLightBoostBrightnessPriority = 6;[<Android.Runtime.Register("CONTROL_AE_MODE_ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY", ApiSince=35)>]
[<System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.ControlAEMode enum directly instead of this field.", true)>]
val mutable ControlAeModeOnLowLightBoostBrightnessPriority : Android.Hardware.Camera2.ControlAEModeField Value
Value = 6- Attributes
Remarks
Like 'ON' but applies additional brightness boost in low light scenes.
When the scene lighting conditions are within the range defined by CameraCharacteristics#CONTROL_LOW_LIGHT_BOOST_INFO_LUMINANCE_RANGE android.control.lowLightBoostInfoLuminanceRange this mode will apply additional brightness boost.
This mode will automatically adjust the intensity of low light boost applied according to the scene lighting conditions. A darker scene will receive more boost while a brighter scene will receive less boost.
This mode can ignore the set target frame rate to allow more light to be captured which can result in choppier motion. The frame rate can extend to lower than the CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES android.control.aeAvailableTargetFpsRanges but will not go below 10 FPS. This mode can also increase the sensor sensitivity gain which can result in increased luma and chroma noise. The sensor sensitivity gain can extend to higher values beyond CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE android.sensor.info.sensitivityRange. This mode may also apply additional processing to recover details in dark and bright areas of the image,and noise reduction at high sensitivity gain settings to manage the trade-off between light sensitivity and capture noise.
This mode is restricted to two output surfaces. One output surface type can either be SurfaceView or TextureView. Another output surface type can either be MediaCodec or MediaRecorder. This mode cannot be used with a target FPS range higher than 30 FPS.
If the session configuration is not supported, the AE mode reported in the CaptureResult will be 'ON' instead of 'ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY'.
When this AE mode is enabled, the CaptureResult field CaptureResult#CONTROL_LOW_LIGHT_BOOST_STATE android.control.lowLightBoostState will be present and not null. Otherwise, the CaptureResult#CONTROL_LOW_LIGHT_BOOST_STATE android.control.lowLightBoostState field will not be present in the CaptureResult.
The application can observe the CaptureResult field CaptureResult#CONTROL_LOW_LIGHT_BOOST_STATE android.control.lowLightBoostState to determine when low light boost is 'ACTIVE' or 'INACTIVE'.
The low light boost is 'ACTIVE' once the scene lighting condition is less than the upper bound lux value defined by CameraCharacteristics#CONTROL_LOW_LIGHT_BOOST_INFO_LUMINANCE_RANGE android.control.lowLightBoostInfoLuminanceRange. This mode will be 'INACTIVE' once the scene lighting condition is greater than the upper bound lux value defined by CameraCharacteristics#CONTROL_LOW_LIGHT_BOOST_INFO_LUMINANCE_RANGE android.control.lowLightBoostInfoLuminanceRange.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.