CaptureRequest.ControlSettingsOverride Propiedad

[Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)]
public static Android.Hardware.Camera2.CaptureRequest.Key ControlSettingsOverride { get; }

[<Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)>]
static member ControlSettingsOverride : Android.Hardware.Camera2.CaptureRequest.Key

Valor de propiedad

La configuración de CaptureRequest deseada invalida con la que se aplican determinadas claves anteriormente para que puedan surtir efecto antes.

Atributos

RegisterAttribute

Comentarios

La configuración de CaptureRequest deseada invalida con la que se aplican determinadas claves anteriormente para que puedan surtir efecto antes.

Hay algunas claves CaptureRequest que se pueden aplicar antes que otras cuando los controles de un objeto CaptureRequest no son necesarios para surtir efecto al mismo tiempo. Un ejemplo de este tipo es zoom. El zoom se puede aplicar en una fase posterior de la canalización de la cámara. En cuanto el dispositivo de cámara recibe CaptureRequest, puede aplicar el valor de zoom solicitado a una solicitud anterior que ya está en la canalización, lo que mejora la latencia de zoom.

El valor de esta clave en el resultado de la captura refleja si los controles de esta captura se invalidan "por" una solicitud más reciente. Esto significa que si una solicitud de captura activa la invalidación de la configuración, el resultado de la captura de una solicitud anterior contendrá el valor clave de ZOOM. Por otro lado, si una solicitud de captura tiene activada la invalidación de configuración, pero todas las solicitudes más recientes lo tienen desactivado, el valor de la clave en el resultado de la captura será DESACTIVADO porque esta captura no se invalida mediante una captura más reciente. En los dos ejemplos siguientes, las columnas de resultados de captura muestran los valores settingsOverride en distintos escenarios.

Camera session created
Request 1 (zoom=1.0x, override=ZOOM) ->
Request 2 (zoom=1.2x, override=ZOOM) ->
Request 3 (zoom=1.4x, override=ZOOM) ->  Result 1 (zoom=1.2x, override=ZOOM)
Request 4 (zoom=1.6x, override=ZOOM) ->  Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=ZOOM) ->  Result 3 (zoom=1.6x, override=ZOOM)
                                     ->  Result 4 (zoom=1.8x, override=ZOOM)
                                     ->  Result 5 (zoom=1.8x, override=OFF)

La aplicación puede activar la invalidación de la configuración y usar zoom como normal. En el ejemplo se muestra que los valores de zoom posteriores (1,2x, 1,4x, 1,6x y 1,8x) sobrescriben los valores de zoom (1,0x, 1,2x, 1,4x y 1,8x) de solicitudes anteriores (#1, #2, #3 y #4).

La aplicación debe asegurarse de que la invalidación de configuración no interfiere con los recorridos del usuario que requieren la aplicación simultánea de todos los controles de CaptureRequest en los destinos de salida solicitados. Por ejemplo, si la aplicación toma una captura todavía mediante CameraCaptureSession#capture y la solicitud de repetición establece inmediatamente un valor de zoom diferente mediante invalidación, la captura todavía en la luz podría tener su valor de zoom sobrescrito inesperadamente.

Por lo tanto, se recomienda encarecidamente desactivar la configuraciónOverride cuando se toman capturas de ráfaga y se vuelve a activar cuando solo hay repetición de la solicitud del visor y no hay capturas de ráfaga o desenlace.

Request 1 (zoom=1.0x, override=OFF)
Request 2 (zoom=1.2x, override=OFF)
Request 3 (zoom=1.4x, override=ZOOM)  -> Result 1 (zoom=1.0x, override=OFF)
Request 4 (zoom=1.6x, override=ZOOM)  -> Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=OFF)   -> Result 3 (zoom=1.6x, override=ZOOM)
                                      -> Result 4 (zoom=1.6x, override=OFF)
                                      -> Result 5 (zoom=1.8x, override=OFF)

En este ejemplo se muestra que: la configuración de "rampas en" de la aplicación invalida estableciendo el control en ZOOM. En el ejemplo, request #3 habilita la invalidación de la configuración de zoom. Dado que el dispositivo de cámara puede acelerar la aplicación del zoom en 1 fotograma, las salidas de la solicitud #2 tienen zoom de 1,4x, el valor especificado en la solicitud #3; La aplicación "se quita" de la invalidación de configuración estableciendo el control en OFF. En el ejemplo, la solicitud #5 cambia la invalidación a OFF. Dado que el zoom de la solicitud n.º 4 surte efecto en el resultado n.º 3, el zoom del resultado #4 permanece igual hasta que el nuevo valor surte efecto en el resultado n.º 5

Valores posibles: OFF; ZOOM

Valores disponibles para este dispositivo: android.control.availableSettingsOverrides

Opcional: el valor de esta clave puede ser NULL en algunos dispositivos.

Referencia de Android para android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.