KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
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
| Escopo | Control | Tipo |
|---|---|---|
Versão 1 |
Filtrar |
Assíncrono, Cancelável |
Para obter as configurações de ROI atuais do driver ou definir as configurações de ROI e aplicar o processamento desejado (3As), o KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL controle de propriedade estendida é enviado ao driver juntamente com uma estrutura de KSCAMERA_EXTENDEDPROP_HEADER padrão seguida por uma estrutura de KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER seguida por um KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL estrutura 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, 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). |
Result |
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. |
Funcionalidade |
Isso deve ser um OR um pouco sábio de KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL e KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE. |
Flags |
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 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, Panorâmica ou Inclinação ou Janela Digital, 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 a janela de saída atual em consideração para garantir que o algoritmo 3A da câmera esteja direcionando o local correto. Dependendo de onde o campo de modificação de exibição ocorre, o mapeamento de coordenadas pode precisar ser bidirecional. Por exemplo, se uma câmera usa a DMFT da Plataforma Windows para detecção facial, mas o campo de modificação de exibição é implementado em um componente após a Plataforma DMFT 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 na plataforma DMFT precisam ser mapeadas para o campo de exibição modificado antes de serem enviado a um aplicativo solicitando-os.
Requisitos
parâmetro |
Ksmedia.h |