Método Zoom

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Observação

Esse componente está disponível para uso nos sistemas operacionais Microsoft Windows 2000, Windows XP e Windows Server 2003. Ele poderá ser alterado ou ficar indisponível em versões subsequentes.

 

O Zoom método amplia ou reduz a exibição de vídeo, centralizada em um determinado conjunto de coordenadas de tela.

MSWebDVD.Zoom(iXPos, iYPos, iZoomRatio)

Parâmetros

iXPos

Especifica a coordenada x no centro da área de zoom retangular como um Inteiro.

iYPos

Especifica a coordenada y no centro do retângulo a ser ampliado como um inteiro.

iZoomRatio

Especifica o fator de ampliação aplicado ao valor de zoom atual como um Inteiro. O valor máximo total depende do suporte à sobreposição de hardware; normalmente, esse é um fator de 32 a 64 vezes o tamanho original.

Valor Retornado

Sem valor de retorno.

Comentários

A nova taxa de zoom permanece em vigor até ser restaurada para o tamanho original ou alterada novamente. Em outras palavras, duas chamadas para esse método especificando um iZoomRatio de dois resultarão em uma taxa de zoom quatro vezes maior que o tamanho original do vídeo. Se o usuário tentar ampliar além do que o hardware pode dar suporte, esse método terá êxito, mas não fará nada.

O método SetClipVideoRect é outra maneira de ampliar; a única diferença entre os dois métodos é a maneira como o retângulo de zoom é especificado.