Compartilhar via

KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

  • Artigo

A ID da propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL definida na enumeração KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY é usada para obter ou definir as configurações de ROI e aplicar o processamento desejado.

Tabela de resumo de uso

Âmbito Controle Tipo

Versão 1

Filtro

Assíncrono, Cancelável

Para obter as configurações atuais de ROI do driver ou definir as configurações de ROI e aplicar o processamento desejado (3As), o controle de propriedade estendida 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 KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL e, em seguida, por uma ou mais estruturas de conteúdo de controle 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 a seguir 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 ROI estendido.

Membro Descrição

Versão

Isso deve ser 1,

PinId

Isso 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 de ControlCount em seu conteúdo de cabeçalho de controle ISO.

Para qualquer outra chamada 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(focus) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(exposure) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance).

Resultado

Isso indica os resultados do erro da última operação SET. Se nenhuma operação SET tiver ocorrido, ela deverá ser 0. O valor 0 indica que nenhum erro foi detectado para todos os controles ISP configurados.

Capacidade

Este deve ser um OR bit-wise de KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL e KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE.

Sinalizadores

Este é um campo de leitura/gravação que 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 3A ROI enviadas para a câmera são enviadas em relação à janela de saída atual da câmera. Se o campo de exibiçã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 Janela Digital/PTZ) será responsável por mapear as coordenadas fornecidas de volta para o campo de exibição completo do sensor, levando em consideração a janela de saída atual para garantir que o algoritmo 3A da câmera esteja direcionando o local correto. Dependendo de onde ocorre a modificação do campo de exibição, o mapeamento de coordenadas pode precisar ser bidirecional. Por exemplo, se uma câmera usa o DMFT da Plataforma Windows para detecção facial, mas a modificação do campo de exibição é implementada em um componente após o DMFT da Plataforma na cadeia de driver, as coordenadas ROI fornecidas pelo aplicativo precisam ser mapeadas de volta para o campo de exibição completo antes de enviar para a câmera e as coordenadas ROI calculadas no DMFT da Plataforma precisam ser mapeadas para o campo de exibição modificado antes de serem enviadas para a câmera e as coordenadas ROI calculadas no DMFT da Plataforma precisarão ser mapeadas para o campo de exibição modificado antes de serem enviado a um aplicativo solicitando-os.

Requisitos

Cabeçalho

 Ksmedia.h