CaptureRequest.ControlSettingsOverride Propriété

[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

Valeur de propriété

Les paramètres CaptureRequest souhaités remplacent par lesquels certaines clés sont appliquées précédemment afin qu’elles puissent prendre effet plus tôt.

Attributs

RegisterAttribute

Remarques

Les paramètres CaptureRequest souhaités remplacent par lesquels certaines clés sont appliquées précédemment afin qu’elles puissent prendre effet plus tôt.

Il existe certaines clés CaptureRequest qui peuvent être appliquées plus tôt que d’autres lorsque les contrôles d’une captureRequest ne sont pas nécessaires pour prendre effet en même temps. L’un de ces exemples est le zoom. Le zoom peut être appliqué à une étape ultérieure du pipeline de caméra. Dès que l’appareil photo reçoit captureRequest, il peut appliquer la valeur de zoom demandée à une demande antérieure déjà présente dans le pipeline, ce qui améliore la latence de zoom.

La valeur de cette clé dans le résultat de la capture indique si les contrôles de cette capture sont remplacés par une demande plus récente. Cela signifie que si une demande de capture active les paramètres de remplacement, le résultat de capture d’une requête antérieure contient la valeur clé de ZOOM. En revanche, si une demande de capture a un remplacement des paramètres activé, mais que toutes les demandes plus récentes l’ont désactivée, la valeur de la clé dans le résultat de la capture est désactivée, car cette capture n’est pas remplacée par une capture plus récente. Dans les deux exemples ci-dessous, les colonnes de résultats de capture illustrent les valeurs settingsOverride dans différents scénarios.

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)

L’application peut activer les paramètres de remplacement et utiliser le zoom comme normal. L’exemple montre que les valeurs de zoom ultérieures (1.2x, 1.4x, 1.6x et 1.8x) remplacent les valeurs de zoom (1.0x, 1.2x, 1.4x et 1.8x) des requêtes antérieures (#1, #2, #3 et #4).

L’application doit s’assurer que le remplacement des paramètres n’interfère pas avec les parcours utilisateur nécessitant l’application simultanée de tous les contrôles dans CaptureRequest sur les cibles de sortie demandées. Par exemple, si l’application prend une capture continue à l’aide de CameraCaptureSession#capture, et que la demande répétée définit immédiatement une autre valeur de zoom à l’aide d’un remplacement, la capture inflérante peut avoir sa valeur de zoom remplacée de manière inattendue.

Par conséquent, l’application est fortement recommandée pour désactiver les paramètresOverride lors de la prise de captures toujours/rafales, et la réactiver lorsqu’il n’y a que la demande de viseur répétitif et qu’aucune capture en rafale n’est toujours en cours.

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)

Cet exemple montre que : les paramètres « ramps in » de l’application sont substitué en définissant le contrôle sur ZOOM. Dans l’exemple, la requête n° 3 active le remplacement des paramètres de zoom. Étant donné que l’appareil photo peut accélérer l’application du zoom par 1 image, les sorties de la requête #2 ont un zoom 1.4x, la valeur spécifiée dans la requête #3 ; L’application « descend » des paramètres substitue en définissant le contrôle sur OFF. Dans l’exemple, la demande #5 modifie le remplacement par OFF. Étant donné que le zoom de la requête #4 prend effet dans le résultat #3, le zoom du résultat #4 reste le même jusqu’à ce que la nouvelle valeur prenne effet dans le résultat #5

Valeurs possibles : OFF ; ZOOM

Valeurs disponibles pour cet appareil : android.control.availableSettingsOverrides

Facultatif : la valeur de cette clé peut être null sur certains appareils.

Référence Android pour android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.