Команда setvideo

Команда setvideo задает значения, связанные с воспроизведением и записью видео. Цифровые видеоустройства и виртуальные машины распознают эту команду.

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

_stprintf_s(
  lpszCommand, 
  TEXT("setvideo %s %s %s"), 
  lpszDeviceID, 
  lpszVideo, 
  lpszFlags
); 

Параметры

lpszDeviceID

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

lpszVideo

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

Значение	Значение	Значение
digitalvideo	алгоритмалгоритма bitsperpel для подсчетаяркости до коэффициентаclocktimecolor, чтобы факторконтрастности с коэффициентомгамма для значенияполутонеинпутка цвета в r:g:bключевого индекса для индексаfonoutput	над длительностьюцвет палитры над индексомв newrgb палитры маркер для обработкичастоты кадров дескриптора качества дескрипторадля скоростизаписи onrecord offsharpness к факторуисточника к значениюисходногономера алгоритмпо-прежнему качество дескриптора потока дескрипторачисел в числовойоттенок к фактору
Видео	offonmonitor для вводазаписи номераtrack_number отслеживанияfrecord	record onrecord track track_number onsource to type number number track track_number offtrack track_number on

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

Значение	Значение
алгоритм алгоритма	Задает алгоритм сжатия видео для последующей команды резервирования или записи . Алгоритмы, поддерживаемые устройством, зависят от конкретного устройства. MCI определяет константы mpeg и h261 для алгоритма. Если указанный алгоритм конфликтует с текущим форматом файла, формат файла изменяется на формат по умолчанию для алгоритма.
bitsperpel для подсчета	Задает число битов на пиксель для сохранения данных с помощью команды записи или записи .
коэффициент яркости	Задает уровень яркости видео.
clocktime	Указывает, что время, указанное в флаге "over", равно миллисекундам. Время является абсолютным и не в ногу с воспроизведением рабочей области.
цвет к фактору	Задает уровень насыщенности цвета.
контрастность к фактору	Задает уровень видеоконтрастности.
гамма в значение	Задает экспоненту гамма-коррекции, умноженную на 1000. Например, чтобы указать экспоненту 2.2, используйте значение 2200. Гамма-значение 1,0 (1000) означает, что гамма-коррекция не применяется. Гамма-коррекция корректирует сопоставление между интенсивностью, закодированной в источнике презентации, и отображаемой яркостью.
Полутонах	Вызывает использование полутоновой палитры вместо палитры по умолчанию. Этот флаг распознается только драйвером цифрового видео MCIAVI.
input	Изменяет флаги "яркость", "цвет", "контрастность", "гамма", "резкость" или "оттенок", чтобы он влиял на входной сигнал и изменял записанные данные. Если это возможно, это значение по умолчанию при мониторинге входных данных.
цвет ключа для r:g:b	Задает цвет ключа. Переменная r:g:b является RGB-значением. Двоеточие (:) разделяют отдельные значения красного, зеленого и синего.
индекс ключа для индексирования	Задает индекс ключа. Переменная индекса является индексом физической палитры.
монитор для вводаномера	Определяет, какие исходные входные данные будут передаваться в выходные данные VCR, не изменяя выбор источника входных данных записи. Тип может быть "output" или один из допустимых источников входных данных. Если "число" не указано, выбирается первый вход этого типа.
offon	Включает или отключает отображение видео. Отключение видео задает сплошной цвет для пикселей в прямоугольнике назначения ( или клиентской области текущего окна по умолчанию). Он не влияет на буфер кадров. Источник видео, будь то рабочая область или внешний вход, может продолжать хранить новые изображения в буфере кадров. Они не отображаются, пока видео не будет включено. Чтобы скрыть окно , можно использовать команду "состояние". Значение по умолчанию — setvideo "on".
output	Изменяет флаги "яркость", "цвет", "контраст", "гамма", "резкость" или "оттенок", чтобы он изменял только отображаемый сигнал, а не то, что записывается. Если это возможно, это значение по умолчанию при мониторинге файла.
в течение длительности	Указывает, сколько времени потребуется для изменения, использующего переменную коэффициента . Единицы длительности имеют текущий формат времени. Изменения происходят по шагам при воспроизведении рабочей области. Если воспроизведение приостановлено, изменение также приостанавливается, пока воспроизведение не продолжится. Если параметр "over" не используется или не поддерживается, изменение происходит немедленно.
цвет палитры по сравнению с индексомnewrgb	Задает новый цвет палитры. Изменяемый цвет и индекс палитры задаются параметрами цвета и индекса ; новый цвет задается параметром newrgb. Этот флаг распознается только драйвером цифрового видео MCIAVI.
Дескриптор палитры для обработки	Указывает дескриптор палитры, который устройство должно использовать для отрисовки. Этот элемент поддерживается только устройствами, используюющими палитры. Если дескриптор равен нулю, используется палитра по умолчанию. Устройства с цифровым видео не должны освобождать палитру, переданную с помощью этой команды. Приложения должны освободить его после закрытия устройства.
дескриптор качества	Указывает характеристики сжатия видео, выполняемого при записи видео в файл. Все устройства поддерживают три дескриптора: low, medium и high. Значение по умолчанию зависит от устройства. Важность этих имен зависит от алгоритма и устройства. Устройства могут определять дополнительные имена дескрипторов. Команда quality может использоваться для определения дополнительных имен дескрипторов. Если флаг "алгоритм" не используется, дескриптор применяется к текущему алгоритму.
запись частоты кадров в частоте	Задает запись для видео движения. Скорость записи указывается в единицах кадров в секунду, умноженных на 1000. Например, частота кадров NTSC 29,97 кадров в секунду представлена как 29970.
запись записи отключена	Включает или отключает запись видеоданных. Запись видеоданных используется по умолчанию.
запись track_number выкл.	Очищает выбор источника видео, чтобы видео не записывалось с помощью следующей команды записи . "Track" позволяет выбирать независимые дорожки. Если параметр track не указан, предполагается значение по умолчанию 1. Перед отключением записи видео может потребоваться сначала выполнить команду set "сбор записи".
запись track_number на	Выбирает источник видео для записи с помощью следующей команды записи . "Track" позволяет выбирать независимые дорожки. Трек 2 соответствует дорожке PCM в Hi8. Если параметр track не указан, предполагается значение по умолчанию 1.
резкость к фактору	Задает уровень резкости видео.
исходное значение в исходное число	Задает источник видеовхода. Обычно это соответствует внешним соединителям. Константы, определенные для источника , включают "rgb", "pal", "ntsc", "svideo" и "secam". Если существует несколько входных данных указанного типа, необязательное значение "число" указывает на требуемые входные данные. Например, setvideo "source to ntsc number 2" указывает второй вход NTSC. Если источник "to" опущен, используется абсолютный источник в соответствии с определением команды list "источник видео".
source для вводаномера	Выбирает источник видео для записи на ленту. Тип должен быть "tuner", "line", "svideo", "aux", "generic", "mute" или "rgb".
алгоритм по-прежнему	Задает алгоритм сжатия неподвижного изображения, используемый командой захвата . Каждое устройство должно поддерживать алгоритм "нет", что означает отсутствие сжатия. Это значение по умолчанию. В этом случае цифровые видеоустройства сохраняют неподвижные изображения как независимые от устройства RGB растровые изображения. Устройства также могут поддерживать список дополнительных алгоритмов для конкретного устройства.
Дескриптор качества по-прежнему	Указывает характеристики сжатия неподвижного изображения, выполняемого при захвате неподвижного изображения. Все устройства поддерживают дескрипторы "low", "medium" и "high". Значение по умолчанию зависит от устройства. Если флаг "алгоритм" не используется, дескриптор применяется к текущему алгоритму. Команду quality можно использовать для определения других имен дескрипторов.
потоковая передача в число	Указывает видеопоток, воспроизводимый из рабочей области. Если поток не указан и поток по умолчанию не определен форматом файла, то воспроизводится первый физически чередующийся видеопоток.
оттенок к фактору	Задает оттенок изображения. Как правило, эта корректировка моделировается после элемента управления оттенком многих цветных телевизоров: 250 означает зеленый, 750 означает красный и 0 (или

lpszFlags

Это может быть "ожидание", "уведомление", "тест" или их сочетание. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

Для устройств VCR использование setvideo с флагом, который отключает отдельную дорожку ("отслеживание track_number выключено"), может привести к тому, что приложение получит сообщение о состоянии, указывающее, что команда не может быть выполнена. Некоторые VCR могут отключать только комбинации дорожек, но не отдельные дорожки; например, первая аудиодорожка и видеодорожка видеокассеты. В этом случае просто используйте setaudio и setvideo, чтобы продолжить отключение других дорожек, составляющих комбинацию. Драйвер отключит дорожки, когда получит команду для отключения последней дорожки в сочетании.

Требования

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

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

MCI

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

Захвата

list

Положить

record

Заповедник

set

setaudio

Окно