Compartilhar via


KSPROPERTY_CAMERACONTROL_PAN

Os clientes no modo de usuário usam a propriedade KSPROPERTY_CAMERACONTROL_PAN para obter ou definir a configuração de panorâmica 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 panorâmica de uma câmera. Esse valor é expresso em graus.

Valores positivos indicam que a câmera é girada no sentido horário. Valores negativos indicam que a câmera é girada no sentido anti-horário, conforme mostrado na ilustração a seguir.

ilustração mostrando valores de panorâmica da câmera.

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 para o dispositivo deve ser -180 a +180. O valor padrão deve ser 0.

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 panorâmica e valores de etapa personalizados que podem não ser baseados em unidades típicas. Os drivers podem implementar o controle de panorâmica física ou digitalmente.

Comentários

O membro Value da estrutura KSPROPERTY_CAMERACONTROL_S especifica a configuração do painel.

Para câmeras que usam a Plataforma DMFT para 3A baseada em face, o controle Pan 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 Pan. 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