Camera.Parameters.AutoExposureLock Property

Definition

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.

Applies to

See also