comando put

O comando put define a área da imagem de origem e da janela de destino usada para exibição. Os dispositivos de sobreposição de vídeo digital e vídeo 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("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszRegions

Sinalizador para definir a área. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando put e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
digitalvideo	destino no quadro de retângulono retângulofonte de origem no retângulo	vídeo na janela da janela do retângulono cliente da janela do cliente da janela do retângulono retângulo
overlay	destino de destino no quadro de retângulono retângulo	fonte de origem em vídeo retânguloem retângulo

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

Valor	Significado
destino	Seleciona toda a área do cliente da janela de destino para exibir os dados.
destino no retângulo	Seleciona uma parte da área do cliente da janela de destino usada para exibir a imagem. Quando uma área da janela de exibição é especificada e o dispositivo dá suporte ao alongamento, a imagem de origem é estendida até o deslocamento e a extensão de destino.
frame	Seleciona todo o buffer de quadros para receber as imagens de vídeo de entrada.
frame no retângulo	Seleciona uma parte do buffer de quadros para receber as imagens de vídeo de entrada.
source	Seleciona a imagem inteira para exibição na janela de destino.
fonte no retângulo	Seleciona uma parte da imagem a ser exibida na janela de destino. Quando uma área da imagem de origem é especificada e o dispositivo dá suporte ao alongamento, a imagem de origem é estendida até o deslocamento e a extensão de destino.
video	Seleciona toda a imagem de vídeo de entrada a ser capturada no buffer de quadros.
vídeo no retângulo	Seleciona uma parte da imagem de vídeo de entrada a ser capturada no buffer de quadros.
janela	Restaura o tamanho da janela inicial na tela. Esse comando também exibe a janela.
janela no retângulo	Altera o tamanho e o local da janela de exibição. O retângulo especificado é relativo à janela pai da janela de exibição (geralmente a área de trabalho) se o sinalizador "filho de estilo" tiver sido usado para o comando open . Para alterar o local da janela sem alterar sua altura ou largura, especifique zero para a altura e a largura.
cliente de janela	Restaura a área do cliente da janela.
cliente window no retângulo	Altera o tamanho e o local da área do cliente da janela. O retângulo especificado é relativo à janela pai da janela do cliente. Para alterar o local da janela sem alterar sua altura ou largura, especifique zero para a altura e a largura.

Quando um sinalizador inclui um retângulo, as coordenadas do retângulo são relativas à origem da janela ou à origem da imagem, conforme apropriado, e são especificadas como X1 Y1 X2 Y2. As coordenadas X1Y1 especificam o canto superior esquerdo e as coordenadas X2Y2 especificam a largura e a altura do retângulo.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, o "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

O comando put define um ou mais dos seguintes retângulos ao trabalhar com dispositivos de sobreposição de vídeo:

• O retângulo de vídeo define a região da imagem de vídeo de entrada a ser capturada.
• O retângulo de quadro define a região do buffer de quadro que recebe a imagem de vídeo de entrada.
• O retângulo de origem define qual região do buffer de quadro é copiada para o retângulo de destino.
• O retângulo de destino define a região da área do cliente da janela de exibição que recebe a imagem de vídeo.

O retângulo de vídeo está relacionado ao retângulo de quadro da mesma forma que o retângulo de origem está relacionado ao retângulo de destino. O alongamento pode ocorrer do retângulo de vídeo para o retângulo de quadro e do retângulo de origem para o retângulo de destino. Nem todos os dispositivos dão suporte a alongamento e o alongamento deve ser habilitado (usando o comando set ).

O comando a seguir define três regiões para o vídeo, o quadro e a origem.

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

As regiões neste exemplo são definidas da seguinte maneira:

• Uma região de 200 por 200 pixels dos dados de vídeo de entrada, começando em uma origem a 120 pixels do canto superior esquerdo, será capturada no buffer de quadros.
• Os dados de vídeo serão colocados em uma região de 200 por 200 pixels no canto superior esquerdo do buffer de quadros.
• As transferências são feitas da região de 200 por 200 pixels no canto superior esquerdo do buffer de quadros para a janela de destino.

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

open

set