Поделиться через


Метод Zoom

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Примечание

Этот компонент доступен для использования в операционных системах Microsoft Windows 2000, Windows XP и Windows Server 2003. В последующих версиях он может быть изменен или недоступен.

 

Метод Zoom увеличивает или масштабирует видеоэкран по заданному набору экранных координат.

MSWebDVD.Zoom(iXPos, iYPos, iZoomRatio)

Параметры

iXPos

Задает координату X в центре прямоугольной области масштабирования в виде целого числа.

iYPos

Указывает координату Y в центре прямоугольника, масштабизуемую как целое число.

iZoomRatio

Задает коэффициент увеличения, применяемый к текущему значению масштаба в виде целого числа. Общее максимальное значение зависит от того, что может поддерживать аппаратное наложение; обычно это коэффициент в 32–64 раза больше исходного размера.

Возвращаемое значение

Нет возвращаемого значения.

Комментарии

Новое соотношение масштаба остается в силе до тех пор, пока не будет восстановлен исходный размер или снова не изменится. Другими словами, два вызова этого метода, указывающие iZoomRatio из двух, приведут к увеличению масштаба, в четыре раза превышающего исходный размер видео. Если пользователь попытается увеличить масштаб, превышающий то, что поддерживает оборудование, этот метод будет успешным, но ничего не делает.

Метод SetClipVideoRect — еще один способ увеличения масштаба; единственное различие между двумя методами заключается в том, как задается прямоугольник масштабирования.