Comando setvideo

O comando setvideo define valores associados à reprodução e captura de vídeo. Os dispositivos de vídeo digital e VCR reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

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

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszVideo

Sinalizador para reprodução e captura de vídeo. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando setvideo e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
digitalvideo	bitsperpel do algoritmo de algoritmopara contaro brilho para fatorarclocktimecolor para fatoraro contraste com ofator gama para valorda cor halftoneinputkey para r:g:bíndice de chave para indexaroffonoutput	sobre a cor da paleta de duraçãosobre o identificadorde paleta de índice para newrgb para lidar coma taxa de quadros de registro do descritor dequalidade para classificaro registro onrecord offsharpness para fatoraro valorda origem para o valor do número de origemainda algoritmode algoritmo ainda fluxo de descritor dequalidade para tonalidade de númeropara fator
Videocassete	offonmonitor para digitar o registro numéricode faixa de registro track_number desativado	registrar a faixa de registro track_number onsource para digitara faixanumérica track_number track_number offtrack em

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszVideo e seus significados.

Valor	Significado
algoritmo de algoritmo	Especifica um algoritmo de compactação de vídeo para uso por um comando de reserva ou registro subsequente. Algoritmos compatíveis com um dispositivo são específicos do dispositivo. O MCI define as constantes "mpeg" e "h261" para o algoritmo. Se o algoritmo especificado entrar em conflito com o formato de arquivo atual, o formato do arquivo será alterado para o formato padrão do algoritmo.
bitsperpel para contar	Define o número de bits por pixel para salvar dados com o comando de captura ou registro .
brilho ao fatorar	Define o nível de brilho do vídeo.
clocktime	Indica que o tempo especificado no sinalizador "over" está em milissegundos. O tempo é absoluto e não está em etapas com a reprodução do workspace.
cor a fator	Define o nível de saturação de cor.
contraste com o fator	Define o nível de contraste de vídeo.
gama para valor	Especifica o expoente de correção gama multiplicado por 1000. Por exemplo, para especificar um expoente 2.2, use 2200 para valor. Um valor gama de 1,0 (1000) indica que nenhuma correção gama é aplicada. A correção gama ajusta o mapeamento entre a intensidade codificada na origem da apresentação e o brilho exibido.
Halftone	Faz com que a paleta de meio-tom seja usada em vez da paleta padrão. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI.
input	Modifica o sinalizador "brilho", "cor", "contraste", "gama", "nitidez" ou "tonalidade" para que ele afete o sinal de entrada e modifique o que é registrado. Se possível, esse é o padrão ao monitorar a entrada.
cor da chave para r:g:b	Define a cor da chave. A variável r:g:b é um valor RGB. Dois-pontos (:) separe os valores vermelhos, verdes e azuis individuais.
índice de chave a indexar	Define o índice de chave. A variável de índice é um índice de paleta física.
monitorar para digitarnúmero	Controla qual entrada de origem será passada para a saída do VCR, sem alterar a seleção de entrada de origem de gravação. O tipo pode ser "output" ou uma das fontes de entrada válidas. Se "number" não for especificado, a primeira entrada desse tipo será escolhida.
offon	Habilita ou desabilita a exibição de vídeo. Desabilitar o vídeo define os pixels no retângulo put "destination" (ou seu padrão, a região do cliente da janela atual) como uma cor sólida. Ele não tem efeito no buffer de quadros. A origem do vídeo, seja o workspace ou uma entrada externa, pode continuar a armazenar novas imagens no buffer de quadros. Eles não são exibidos até que o vídeo esteja habilitado. Você pode usar o comando "state" da janela para ocultar a janela. O padrão é setvideo "on".
output	Modifica o sinalizador "brilho", "cor", "contraste", "gama", "nitidez" ou "tonalidade" para que ele modifique apenas o sinal exibido e não o que é gravado. Se possível, esse é o padrão ao monitorar um arquivo.
durante a duração	Especifica quanto tempo deve levar para fazer uma alteração que usa uma variável de fator . As unidades de duração estão no formato de hora atual. As alterações ocorrem em etapa com a reprodução do workspace. Quando o jogo é suspenso, a alteração também é suspensa até que a peça continue. Se "over" não for usado ou não tiver suporte, a alteração ocorrerá imediatamente.
cor da paleta sobre o índice para newrgb	Define uma nova cor de paleta. O índice de cor e paleta a ser alterado é especificado pelos parâmetros de cor e índice ; a nova cor é especificada por newrgb. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI.
identificador de paleta a ser manipulado	Especifica o identificador para uma paleta que o dispositivo deve usar para renderização. Esse item tem suporte apenas para dispositivos que usam paletas. Se handle for zero, a paleta padrão será usada. Os dispositivos de vídeo digital não devem liberar a paleta passada com esse comando. Os aplicativos devem liberá-lo depois de fecharem o dispositivo.
descritor de qualidade	Especifica as características da compactação de vídeo executada quando o vídeo é gravado em um arquivo. Todos os dispositivos dão suporte aos três descritores: "baixo", "médio" e "alto". O padrão é específico do dispositivo. O significado desses nomes depende do algoritmo e do dispositivo. Os dispositivos podem definir nomes de descritores adicionais. O comando de qualidade pode ser usado para definir nomes de descritores adicionais. Se o sinalizador "algoritmo" não for usado, o descritor se aplicará ao algoritmo atual.
taxa de quadros de registro para taxa	Define a gravação do vídeo em movimento. A taxa de gravação é especificada em unidades de quadros por segundo multiplicada por 1000. Por exemplo, a taxa de quadros NTSC de 29,97 quadros por segundo é representada como 29970.
gravar onrecord off	Habilita ou desabilita a gravação de dados de vídeo. A gravação de dados de vídeo é o padrão.
faixa de registro track_number desativada	Limpa a seleção de fonte de vídeo para que nenhum vídeo seja gravado com o próximo comando de registro . "Track" permite a seleção de faixa independente. Se "track" não for especificado, um valor padrão de 1 será assumido. Talvez seja necessário primeiro emitir um comando "assemble record off" definido antes que a gravação de vídeo possa ser desativada.
faixa de registro track_number em	Seleciona a fonte de vídeo a ser gravada com o próximo comando de registro . "Track" permite a seleção de faixa independente. A faixa 2 corresponde à faixa pcm em Hi8. Se "track" não for especificado, um padrão de 1 será assumido.
nitidez ao fatorar	Define o nível de nitidez do vídeo.
origem para o valor do número de origem	Define a origem da entrada de vídeo. Isso geralmente corresponde a conectores externos. As constantes definidas para a origem incluem "rgb", "pal", "ntsc", "svideo" e "secam". Se houver mais de uma entrada do tipo especificado, o valor opcional "number" indicará a entrada desejada. Por exemplo, setvideo "source to ntsc number 2" especifica a segunda entrada NTSC. Se a origem "to" for omitida, a fonte absoluta será usada conforme definido pelo comando "fonte de vídeo" da lista .
origem para digitarnúmero de número	Seleciona a fonte de vídeo a ser gravada na fita. O tipo deve ser "tuner", "line", "svideo", "aux", "generic", "mute" ou "rgb".
algoritmo still	Especifica o algoritmo de compactação de imagem ainda usado pelo comando de captura . Cada dispositivo deve dar suporte a um algoritmo de "nenhum", o que significa que não há compactação. Esse é o padrão. Nesse caso, os dispositivos de vídeo digital salvam imagens paradas como bitmaps independentes de dispositivo RGB. Os dispositivos também podem dar suporte a uma lista específica do dispositivo de algoritmos adicionais.
descritor de qualidade ainda	Especifica as características da compactação de imagem parada executada durante a captura de uma imagem parada. Todos os dispositivos dão suporte aos descritores "baixo", "médio" e "alto". O padrão é específico do dispositivo. Se o sinalizador "algoritmo" não for usado, o descritor se aplicará ao algoritmo atual. O comando de qualidade pode ser usado para definir outros nomes de descritor.
transmitir para número	Especifica o fluxo de vídeo reproduzido do workspace. Se o fluxo não for especificado e um fluxo padrão não for definido pelo formato de arquivo, o primeiro fluxo de vídeo intercalado fisicamente será reproduzido.
tonalidade para fator	Define a tonalidade da imagem. Normalmente, esse ajuste é modelado após o controle de tonalidade de muitos conjuntos de televisão coloridos, com 250 significando verde, 750 significando vermelho e 0 (ou

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação deles. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Para dispositivos VCR, usar setvideo com um sinalizador que desativa uma faixa individual ("rastrear track_number desativado") pode fazer com que seu aplicativo receba uma mensagem status indicando que o comando não pôde ser executado. Alguns VCRs podem desativar apenas combinações de faixas, não faixas individuais; por exemplo, a primeira faixa de áudio e uma faixa de vídeo de um cassete de vídeo. Nesse caso, basta usar setaudio e setvideo para continuar a desativar as outras faixas que compõem a combinação. O driver desativará as faixas quando receber o comando para desativar a última faixa na combinação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI

Capturar

list

put

record

reserve

set

Setaudio

Janela