Camera.Parameters.AutoExposureLock 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.
Caution
deprecated
Gets the state of the auto-exposure lock. -or- Sets the auto-exposure lock state.
[System.Obsolete("deprecated")]
public virtual bool AutoExposureLock { [Android.Runtime.Register("getAutoExposureLock", "()Z", "GetGetAutoExposureLockHandler")] get; [Android.Runtime.Register("setAutoExposureLock", "(Z)V", "GetSetAutoExposureLock_ZHandler")] set; }
[<System.Obsolete("deprecated")>]
[<get: Android.Runtime.Register("getAutoExposureLock", "()Z", "GetGetAutoExposureLockHandler")>]
[<set: Android.Runtime.Register("setAutoExposureLock", "(Z)V", "GetSetAutoExposureLock_ZHandler")>]
member this.AutoExposureLock : bool with get, set
Property Value
State of the auto-exposure lock. Returns true if auto-exposure is currently locked, and false otherwise.
- Attributes
Remarks
Property getter documentation:
Gets the state of the auto-exposure lock. Applications should check #isAutoExposureLockSupported
before using this method. See #setAutoExposureLock
for details about the lock.
Java documentation for android.hardware.Camera.Parameters.getAutoExposureLock()
.
Property setter documentation:
Sets the auto-exposure lock state. Applications should check #isAutoExposureLockSupported
before using this method.
If set to true, the camera auto-exposure routine will immediately pause until the lock is set to false. Exposure compensation settings changes will still take effect while auto-exposure is locked.
If auto-exposure is already locked, setting this to true again has no effect (the driver will not recalculate exposure values).
Stopping preview with #stopPreview()
, or triggering still image capture with #takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback)
, will not change the lock.
Exposure compensation, auto-exposure lock, and auto-white balance lock can be used to capture an exposure-bracketed burst of images, for example.
Auto-exposure state, including the lock state, will not be maintained after camera #release()
is called. Locking auto-exposure after #open()
but before the first call to #startPreview()
will not allow the auto-exposure routine to run at all, and may result in severely over- or under-exposed images.
Java documentation for android.hardware.Camera.Parameters.setAutoExposureLock(boolean)
.
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.