Команда put

  • Статья

Команда put определяет область исходного изображения и окна назначения, используемые для отображения. Устройства цифрового видео и наложения видео распознают эту команду.

Чтобы отправить эту команду, вызовите функцию mciSendString с заданным параметром lpszCommand , как показано ниже.

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
);

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszRegions

Флаг для определения области. В следующей таблице перечислены типы устройств, которые распознают команду put, и флаги, используемые каждым типом.

Значение Значение Значение
digitalvideo назначение в кадре прямоугольникав источнике источника прямоугольникав прямоугольнике видео в окне окна прямоугольникав клиенте клиентского окна прямоугольникав прямоугольнике
overlay назначение назначения в прямоугольнойрамке кадра в прямоугольнике источник источника видео в прямоугольникевидео на прямоугольнике

В следующей таблице перечислены флаги, которые можно указать в параметре lpszRegions , и их значения.

Значение Значение
ресурс destination Выбирает всю клиентную область окна назначения для отображения данных.
назначение в прямоугольнике Выбирает часть клиентской области окна назначения, которая используется для отображения изображения. Если указана область окна отображения и устройство поддерживает растяжение, исходное изображение растягивается до целевого смещения и экстента.
frame Выбирает весь буфер кадров для получения входящих видеоизобращений.
рамка в прямоугольнике Выбирает часть буфера кадров для получения входящих видеоизов.
source Выбирает все изображение для отображения в окне назначения.
источник в прямоугольнике Выбирает часть изображения для отображения в окне назначения. Если указана область исходного образа и устройство поддерживает растяжение, исходный образ растягивается до целевого смещения и экстента.
видео Выбирает все входящее видеоизобращение для записи в буфер кадров.
видео на прямоугольнике Выбирает часть входящего видеоизобращения для записи в буфер кадров.
window Восстанавливает начальный размер окна на дисплее. Эта команда также отображает окно .
окно в прямоугольнике Изменяет размер и расположение окна отображения. Указанный прямоугольник относится к родительскому окну окна отображения (обычно рабочего стола), если для открытой команды использовался флаг "стиль дочернего элемента". Чтобы изменить расположение окна, не изменяя его высоту или ширину, укажите ноль для высоты и ширины.
клиент window Восстанавливает клиентную область окна.
клиент окна в прямоугольнике Изменяет размер и расположение клиентской области окна. Указанный прямоугольник относится к родительскому окну клиентского окна. Чтобы изменить расположение окна, не изменяя его высоту или ширину, укажите ноль для высоты и ширины.

Если флаг включает прямоугольник, координаты прямоугольника соответствуют источнику окна или источнику изображения соответственно и указываются как X1 Y1 X2 Y2 Y2. Координаты X1Y1 указывают левый верхний угол, а координаты X2Y2 — ширину и высоту прямоугольника.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

Возвращает ноль при успешном выполнении или ошибке в противном случае.

Комментарии

Команда put определяет один или несколько из следующих прямоугольников при работе с устройствами наложения видео:

  • Прямоугольник видео определяет область входящего видеоизущего изображения для захвата.
  • Прямоугольник кадра определяет область буфера кадров, который получает входящее видео.
  • Исходный прямоугольник определяет, какая область буфера кадров копируется в целевой прямоугольник.
  • Прямоугольник назначения определяет область клиентской области окна отображения, которая получает видеоизу.

Прямоугольник видео связан с прямоугольником кадра так же, как исходный прямоугольник связан с прямоугольником назначения. Растяжение может происходить от прямоугольника видео до прямоугольника кадра и от исходного прямоугольника до прямоугольника назначения. Не все устройства поддерживают растяжение, и растяжение должно быть включено (с помощью команды set ).

Следующая команда определяет три области для видео, кадра и источника.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

Регионы в этом примере определяются следующим образом:

  • Область входящих видеоданных размером 200 х 200 пикселей, начиная с 120 пикселей от верхнего левого угла, будет записана в буфер кадров.
  • Видеоданные будут помещены в область размером 200 на 200 пикселей в левом верхнем углу буфера кадров.
  • Передача выполняется из области размером 200 на 200 пикселей в левом верхнем углу буфера кадров в целевое окно.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]

См. также раздел

MCI

Командные строки MCI

open

set