Partilhar via

KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

  • Artigo

O ID de propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL definido na enumeração KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY é usado para obter ou configurar as configurações de ROI e aplicar o processamento desejado.

Tabela de resumo de uso

Âmbito de aplicação Controlo Tipo

Versão 1

Filtrar

Assíncrono, cancelável

Para obter as configurações atuais de ROI do driver ou para configurar as configurações de ROI e aplicar o processamento desejado (3As), o controle de propriedade estendido KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL é enviado ao driver juntamente com uma estrutura de KSCAMERA_EXTENDEDPROP_HEADER padrão seguida por uma estrutura de KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER seguida por uma estrutura de KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL e, em seguida, por uma ou mais estruturas de controlo de carga útil específicas do ISP correspondentes. A lista a seguir ilustra um layout de estrutura de dados com um ROI de foco e dois ROIs de exposição.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Foco)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Exposição com 2 ROIs)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

A tabela abaixo contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL do controle de ROI estendido.

Membro Descrição

Versão

Este deve ser 1,

PinId

Isto deve ser KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Tamanho

Para a chamada GET inicial (quando nenhuma chamada SET tiver ocorrido), isso deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER). Além disso, o driver deve retornar 0 dentro do ControlCount em sua carga útil do cabeçalho de controle ISO.

Para quaisquer outras chamadas SET ou GET, isso deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount(foco) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(exposição) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance).

Resultado

Isso indica os resultados de erro da última operação SET. Se nenhuma operação SET tiver ocorrido, isso deve ser 0. O valor 0 indica que nenhum erro foi detetado para todos os controles ISP configurados.

Capacidade

Esta deve ser uma OR pouco sábia de KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL e KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE.

Bandeiras

Este é um campo de leitura/gravação Isso pode ser KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION para uma chamada SET. Isso deve ser 0 para uma chamada GET.

Considerações sobre a janela de saída ajustável

As coordenadas ROI 3A enviadas para a câmera são enviadas em relação à janela de saída atual da câmera. Se o campo de visão tiver sido modificado devido ao uso de um controle como Zoom, Pan ou Tilt ou Digital Window, a câmera (ou componente que implementa o controle Digital Window/PTZ) é responsável por mapear as coordenadas fornecidas de volta para o campo de visão completo do sensor, levando em consideração a janela de saída atual para garantir que o algoritmo 3A da câmera esteja visando o local correto. Dependendo de onde a modificação do campo de visão ocorre, o mapeamento de coordenadas pode precisar ser bidirecional. Por exemplo, se uma câmera usa a Plataforma Windows DMFT para deteção de rosto, mas a modificação do campo de visão é implementada em um componente após a Plataforma DMFT na cadeia de drivers, as coordenadas de ROI fornecidas pelo aplicativo precisam ser mapeadas de volta para o campo de visão completo antes de enviar para a câmera e as coordenadas de ROI calculadas na Plataforma DMFT precisam ser mapeadas para o campo de visão modificado antes de serem enviados para um aplicativo solicitando-os.

Requerimentos

Cabeçalho

 Ksmedia.h