CaptureRequest.ControlSettingsOverride Propriedade

[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 da propriedade

As configurações de CaptureRequest desejadas substituem com as quais determinadas chaves são aplicadas anteriormente para que possam entrar em vigor mais cedo.

Atributos

RegisterAttribute

Comentários

As configurações de CaptureRequest desejadas substituem com as quais determinadas chaves são aplicadas anteriormente para que possam entrar em vigor mais cedo.

Há algumas chaves CaptureRequest que podem ser aplicadas anteriormente a outras quando os controles em um CaptureRequest não são necessários para entrar em vigor ao mesmo tempo. Um desses exemplos é o zoom. O zoom pode ser aplicado em um estágio posterior do pipeline da câmera. Assim que o dispositivo de câmera recebe o CaptureRequest, ele pode aplicar o valor de zoom solicitado a uma solicitação anterior que já está no pipeline, melhorando assim a latência de zoom.

O valor dessa chave no resultado da captura reflete se os controles dessa captura são substituídos "por" uma solicitação mais recente. Isso significa que, se uma solicitação de captura ativar a substituição de configurações, o resultado da captura de uma solicitação anterior conterá o valor da chave do ZOOM. Por outro lado, se uma solicitação de captura tiver a substituição de configurações ativada, mas todas as solicitações mais recentes a tiverem desativada, o valor da chave no resultado da captura será OFF porque essa captura não é substituída por uma captura mais recente. Nos dois exemplos abaixo, as colunas de resultados da captura ilustram os valores settingsOverride em cenários diferentes.

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)

O aplicativo pode ativar a substituição de configurações e usar o zoom normalmente. O exemplo mostra que os valores de zoom posteriores (1,2x, 1,4x, 1,6x e 1,8x) substituem os valores de zoom (1,0x, 1,2x, 1,4x e 1,8x) de solicitações anteriores (nº 1, nº 2, #3 e 4).

O aplicativo deve garantir que a substituição de configurações não interfira nos percursos do usuário que exigem a aplicação simultânea de todos os controles no CaptureRequest nos destinos de saída solicitados. Por exemplo, se o aplicativo fizer uma captura ainda usando CameraCaptureSession#capture e a solicitação repetida definir imediatamente um valor de zoom diferente usando substituição, a captura ainda em vôo poderá ter seu valor de zoom substituído inesperadamente.

Portanto, o aplicativo é altamente recomendável para desativar settingsOverride ao realizar capturas de imagens de intermitência/intermitência e ativá-lo novamente quando houver apenas solicitação de visor recorrente e nenhuma captura de inflight still/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)

Este exemplo mostra que: as configurações de aplicativo "rampas" substituem definindo o controle como ZOOM. No exemplo, a solicitação nº 3 habilita a substituição das configurações de zoom. Como o dispositivo de câmera pode acelerar a aplicação de zoom em 1 quadro, as saídas da solicitação nº 2 têm zoom de 1,4x, o valor especificado na solicitação nº 3; O aplicativo "sai" das configurações substituídas definindo o controle como OFF. No exemplo, a solicitação nº 5 altera a substituição para OFF. Como o zoom da solicitação nº 4 entra em vigor no resultado nº 3, o zoom de #4 do resultado permanece o mesmo até que o novo valor entre em vigor no resultado nº 5

Valores possíveis: OFF; ZOOM

Valores disponíveis para este dispositivo: android.control.availableSettingsOverrides

Opcional – o valor dessa chave pode ser nulo em alguns dispositivos.

Referência do Android para android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.