Compartilhar via


KSPROPERTY_CAMERACONTROL_ZOOM

Os clientes no modo de usuário usam a propriedade KSPROPERTY_CAMERACONTROL_ZOOM para obter ou definir a configuração de zoom de uma câmera. Essa propriedade é opcional.

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade
Sim Sim Filtro ou nó KSPROPERTY_CAMERACONTROL_S ou KSPROPERTY_CAMERACONTROL_NODE_S LONG

O valor da propriedade (dados de operação) é um LONG que especifica a configuração de zoom de uma câmera. Esse valor é expresso em milímetros.

Cuidado

Ao escrever ou testar um aplicativo, você deve estar ciente de que, na prática, alguns drivers definem um intervalo personalizado de valores de zoom e valores de etapa personalizados que podem não ser baseados em unidades típicas. Os drivers podem implementar o controle de zoom física ou digitalmente.

Comentários

O membro Value da estrutura KSPROPERTY_CAMERACONTROL_S especifica o zoom.

Cada minidriver de captura de vídeo que dá suporte a essa propriedade deve definir um intervalo e um valor padrão para essa propriedade. O intervalo do dispositivo deve ser de 10 a 600. O valor padrão deve ser 10.

Para câmeras que usam a Plataforma DMFT para 3A baseada em face, o controle Zoom afeta a janela de saída da câmera. As coordenadas faciais produzidas pela Plataforma DMFT serão relativas a essa janela de saída modificada, portanto, a câmera é responsável por remapear as coordenadas ROI para o campo de exibição completo da câmera quando o campo de exibição atual é modificado pelo controle Zoom. Dependendo de onde o campo de modificação de exibição ocorre, o mapeamento de coordenadas pode precisar ser bidirecional. Por exemplo, se o campo de modificação de exibição for implementado em um componente após a Plataforma DMFT na cadeia de driver, as coordenadas ROI fornecidas pelo aplicativo precisarão 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 precisarão ser mapeadas para o campo de exibição modificado antes de serem enviadas para um aplicativo que as solicita.

Requisitos

Cabeçalho: ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY

KSPROPERTY_CAMERACONTROL_S