CaptureRequest.ControlSettingsOverride Proprietà

[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

Valore della proprietà

Le impostazioni CaptureRequest desiderate sostituiscono con le quali alcune chiavi vengono applicate in precedenza in modo che possano essere applicate prima.

Attributi

RegisterAttribute

Commenti

Le impostazioni CaptureRequest desiderate sostituiscono con le quali alcune chiavi vengono applicate in precedenza in modo che possano essere applicate prima.

Esistono alcune chiavi CaptureRequest che possono essere applicate prima di altre quando i controlli all'interno di captureRequest non devono essere applicati contemporaneamente. Uno di questi esempi è lo zoom. Lo zoom può essere applicato in una fase successiva della pipeline della fotocamera. Non appena il dispositivo fotocamera riceve CaptureRequest, può applicare il valore di zoom richiesto a una richiesta precedente già presente nella pipeline, migliorando così la latenza di zoom.

Il valore di questa chiave nel risultato dell'acquisizione riflette se i controlli per questa acquisizione vengono sottoposti a override da una richiesta più recente. Ciò significa che se una richiesta di acquisizione attiva l'override delle impostazioni, il risultato dell'acquisizione di una richiesta precedente conterrà il valore della chiave zoom. D'altra parte, se una richiesta di acquisizione ha l'override delle impostazioni è attivata, ma tutte le richieste più recenti lo hanno disattivato, il valore della chiave nel risultato dell'acquisizione sarà DISATTIVATo perché questa acquisizione non viene sottoposta a override da un'acquisizione più recente. Nei due esempi seguenti le colonne dei risultati di acquisizione illustrano i valori settingsOverride in scenari diversi.

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'applicazione può attivare l'override delle impostazioni e usare lo zoom come di consueto. L'esempio mostra che i valori di zoom successivi (1,2x, 1,4x, 1,6x e 1,8x) sovrascrivono i valori di zoom (1,0x, 1,2x, 1,4x e 1,8x) delle richieste precedenti (#1, 2, #3 e #4).

L'applicazione deve assicurarsi che l'override delle impostazioni non interferisca con i percorsi utente che richiedono l'applicazione simultanea di tutti i controlli in CaptureRequest nelle destinazioni di output richieste. Ad esempio, se l'applicazione acquisisce ancora un'acquisizione usando CameraCaptureSession#capture e la richiesta ripetuta imposta immediatamente un valore di zoom diverso tramite override, l'acquisizione in corso potrebbe comunque sovrascrivere in modo imprevisto il valore di zoom.

È quindi consigliabile disattivare le impostazioniOverride durante l'acquisizione di ancora/burst e riattivarla quando è presente solo una richiesta di viewfinder ripetuta e nessuna acquisizione in corso/burst.

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)

Questo esempio mostra che: le impostazioni "rampe in" dell'applicazione vengono sostituite impostando il controllo su ZOOM. Nell'esempio, la richiesta n. 3 abilita l'override delle impostazioni di zoom. Poiché il dispositivo fotocamera può velocizzare l'applicazione dello zoom di 1 fotogramma, gli output della richiesta n. 2 hanno zoom 1,4x, il valore specificato nella richiesta n. 3; L'applicazione "aumenta" le impostazioni sostituiscono impostando il controllo su OFF. Nell'esempio, la richiesta n. 5 modifica l'override su OFF. Poiché lo zoom della richiesta n. 4 diventa effettivo nel risultato #3, lo zoom del risultato n. 4 rimane invariato finché il nuovo valore non diventa effettivo nel risultato 5

Valori possibili: OFF; ZOOM

Valori disponibili per questo dispositivo: android.control.availableSettingsOverrides

Facoltativo: il valore di questa chiave può essere Null in alcuni dispositivi.

Informazioni di riferimento su Android per android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.