CaptureRequest.FlashStrengthLevel Property
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.
Flash strength level to be used when manual flash control is active.
[Android.Runtime.Register("FLASH_STRENGTH_LEVEL", ApiSince=35)]
public static Android.Hardware.Camera2.CaptureRequest.Key FlashStrengthLevel { get; }[<Android.Runtime.Register("FLASH_STRENGTH_LEVEL", ApiSince=35)>]
static member FlashStrengthLevel : Android.Hardware.Camera2.CaptureRequest.KeyProperty Value
Flash strength level to be used when manual flash control is active.
- Attributes
Remarks
Flash strength level to be used when manual flash control is active.
Flash strength level to use in capture mode i.e. when the applications control flash with either SINGLE or TORCH mode.
Use android.flash.singleStrengthMaxLevel and android.flash.torchStrengthMaxLevel to check whether the device supports flash strength control or not. If the values of android.flash.singleStrengthMaxLevel and android.flash.torchStrengthMaxLevel are greater than 1, then the device supports manual flash strength control.
If the android.flash.mode == TORCH the value must be >= 1 and <= android.flash.torchStrengthMaxLevel. If the application doesn't set the key and android.flash.torchStrengthMaxLevel > 1, then the flash will be fired at the default level set by HAL in android.flash.torchStrengthDefaultLevel. If the android.flash.mode == SINGLE, then the value must be >= 1 and <= android.flash.singleStrengthMaxLevel. If the application does not set this key and android.flash.singleStrengthMaxLevel > 1, then the flash will be fired at the default level set by HAL in android.flash.singleStrengthDefaultLevel. If android.control.aeMode is set to any of ON_AUTO_FLASH, ON_ALWAYS_FLASH, ON_AUTO_FLASH_REDEYE, ON_EXTERNAL_FLASH values, then the strengthLevel will be ignored.
When AE mode is ON and flash mode is TORCH or SINGLE, the application should make sure the AE mode, flash mode, and flash strength level remain the same between precapture trigger request and final capture request. The flash strength level being set during precapture sequence is used by the camera device as a reference. The actual strength may be less, and the auto-exposure routine makes sure proper conversions of sensor exposure time and sensitivities between precapture and final capture for the specified strength level.
Range of valid values: [1-android.flash.torchStrengthMaxLevel] when the android.flash.mode is set to TORCH; [1-android.flash.singleStrengthMaxLevel] when the android.flash.mode is set to SINGLE
This key is available on all devices.
Android reference for android.hardware.camera2.CaptureRequest.FLASH_STRENGTH_LEVEL.
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.