Comando setvideo

El comando setvideo establece los valores asociados a la reproducción y captura de vídeo. Los dispositivos de vídeo digital y VCR reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

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

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszVideo

Marca para la reproducción y captura de vídeo. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando setvideo y las marcas usadas por cada tipo.

Valor	Significado	Significado
digitalvideo	bits del algoritmo algorithmperpelpara contarel brillo en factorclocktimecolor para factorcontrastar con factorgamma al valorhalftoneinputkey color to r:g:bkey index to indexoffonoutput	sobre elcolor de la paleta de duración sobre el índiceal identificador de paleta newrgb para controlarla velocidad de fotogramas del registro deregistro de calidad para la offsharpness de registro de velocidadpara factorizarel origen delorigen al valor de númerode origen, el algoritmode algoritmo sigue siendo secuencia de descriptorde calidad al tono numéricoa factor
Vcr	offonmonitor to typenumber numberrecord offrecord track track_number off	record onrecord track track_number onsource to typenumber number track track_number offtrack track_number on

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszVideo y sus significados.

Valor	Significado
algoritmo de algoritmo	Especifica un algoritmo de compresión de vídeo para que lo use un comando de reserva o registro posterior. Los algoritmos admitidos por un dispositivo son específicos del dispositivo. MCI define las constantes "mpeg" y "h261" para el algoritmo. Si el algoritmo especificado entra en conflicto con el formato de archivo actual, el formato de archivo se cambia al formato predeterminado para el algoritmo.
bitsperpel para contar	Establece el número de bits por píxel para guardar datos con el comando capture o record .
brillo a factor	Establece el nivel de brillo del vídeo.
clocktime	Indica que la hora especificada en la marca "over" está en milisegundos. El tiempo es absoluto y no está en paso con la reproducción del área de trabajo.
color a factor	Establece el nivel de saturación de color.
contraste con factor	Establece el nivel de contraste de vídeo.
gamma a value	Especifica el exponente de corrección gamma multiplicado por 1000. Por ejemplo, para especificar un exponente de 2.2, use 2200 para value. Un valor gamma de 1,0 (1000) indica que no se aplica ninguna corrección gamma. La corrección gamma ajusta la asignación entre la intensidad codificada en la fuente de presentación y el brillo mostrado.
Semitonos	Hace que se use la paleta de tonos medio en lugar de la paleta predeterminada. Este indicador solo lo reconoce el controlador mciavi digital-video.
input	Modifica la marca "brillo", "color", "contraste", "gamma", "nitidez" o "tono" para que afecte a la señal de entrada y modifique lo que se registra. Si es posible, este es el valor predeterminado al supervisar la entrada.
color de clave en r:g:b	Establece el color de la clave. La variable r:g:b es un valor RGB. Dos puntos (:) separe los valores rojos, verdes y azules individuales.
índice de clave que se va a indexar	Establece el índice de clave. La variable de índice es un índice de paleta física.
supervisión al número de númerode tipo	Controla qué entrada de origen se pasará a la salida de VCR, sin cambiar la selección de entrada de origen de grabación. El tipo puede ser "output" o uno de los orígenes de entrada válidos. Si no se especifica "number", se elige la primera entrada de ese tipo.
offon	Habilita o deshabilita la visualización del vídeo. Al deshabilitar el vídeo, los píxeles del rectángulo put "destination" (o su valor predeterminado, la región cliente de la ventana actual) se establece en un color sólido. No tiene ningún efecto en el búfer de fotogramas. El origen de vídeo, ya sea el área de trabajo o una entrada externa, podría seguir almacenando nuevas imágenes en el búfer de fotogramas. No se muestran hasta que el vídeo está habilitado. Puede usar el comando "state" de la ventana para ocultar la ventana. El valor predeterminado es setvideo "on".
output	Modifica la marca "brillo", "color", "contraste", "gamma", "nitidez" o "tono" para que modifique solo la señal mostrada y no lo que se registra. Si es posible, este es el valor predeterminado al supervisar un archivo.
sobre duración	Especifica cuánto tiempo debe tardar en realizar un cambio que use una variable de factor . Las unidades de duración están en el formato de hora actual. Los cambios se producen en el paso con la reproducción del área de trabajo. Cuando se suspende la reproducción, el cambio también se suspende hasta que la reproducción continúa. Si no se usa "over" o no se admite, el cambio se produce inmediatamente.
color de paleta sobre índice a newrgb	Establece un nuevo color de paleta. El color y el índice de paleta que se van a cambiar se especifican mediante los parámetros de color e índice ; Newrgb especifica el nuevo color. Este indicador solo lo reconoce el controlador mciavi digital-video.
identificador de paleta para controlar	Especifica el identificador de una paleta que el dispositivo debe usar para la representación. Este elemento solo es compatible con dispositivos que usan paletas. Si handle es cero, se usa la paleta predeterminada. Los dispositivos de vídeo digital no deben liberar la paleta pasada con este comando. Las aplicaciones deben liberarla después de cerrar el dispositivo.
descriptor de calidad	Especifica las características de la compresión de vídeo realizada cuando el vídeo se graba en un archivo. Todos los dispositivos admiten los tres descriptores: "bajo", "medio" y "alto". El valor predeterminado es específico del dispositivo. La importancia de estos nombres depende del algoritmo y del dispositivo. Los dispositivos pueden definir nombres de descriptor adicionales. El comando de calidad se puede usar para definir nombres de descriptor adicionales. Si no se usa la marca "algorithm", el descriptor se aplica al algoritmo actual.
velocidad de fotogramas de registro a velocidad	Establece la grabación del vídeo de movimiento. La velocidad de grabación se especifica en unidades de fotogramas por segundo multiplicadas por 1000. Por ejemplo, la velocidad de fotogramas NTSC de 29,97 fotogramas por segundo se representa como 29970.
record onrecord off	Habilita o deshabilita la grabación de datos de vídeo. La grabación de datos de vídeo es el valor predeterminado.
track_number de pista de registro desactivado	Borra la selección del origen de vídeo para que no se grabe ningún vídeo con el siguiente comando de grabación . "Track" permite la selección de pista independiente. Si no se especifica "track", se supone un valor predeterminado de 1. Es posible que sea necesario emitir primero un comando set "assemble record off" antes de que se pueda desactivar la grabación de vídeo.
registro de track_number de pista en	Selecciona el origen de vídeo que se va a grabar con el siguiente comando de grabación . "Track" permite la selección de pista independiente. La pista 2 corresponde a la pista PCM en Hi8. Si no se especifica "track", se supone un valor predeterminado de 1.
nitidez en factor	Establece el nivel de nitidez del vídeo.
origen al valor del número de origen	Establece el origen de la entrada de vídeo. Esto normalmente corresponde a conectores externos. Las constantes definidas para el origen incluyen "rgb", "pal", "ntsc", "svideo" y "secam". Si existe más de una entrada del tipo especificado, el valor opcional "number" indica la entrada deseada. Por ejemplo, setvideo "source to ntsc number 2" especifica la segunda entrada NTSC. Si se omite el origen "to", el origen absoluto se usa según lo definido por el comando de lista "origen de vídeo".
origen al número de número detipo	Selecciona el origen de vídeo que se va a grabar en la cinta. El tipo debe ser "tuner", "line", "svideo", "aux", "generic", "mute" o "rgb".
algoritmo de algoritmos inmódmicos	Especifica el algoritmo de compresión de imágenes que usa el comando capture . Cada dispositivo debe admitir un algoritmo de "none", lo que significa que no hay compresión. Este es el valor predeterminado. En este caso, los dispositivos de vídeo digital guardan imágenes fijas como mapas de bits independientes del dispositivo RGB. Los dispositivos también pueden admitir una lista específica del dispositivo de algoritmos adicionales.
descriptor de calidad	Especifica las características de la compresión de imagen fija realizada al capturar una imagen fija. Todos los dispositivos admiten los descriptores "bajo", "medio" y "alto". El valor predeterminado es específico del dispositivo. Si no se usa la marca "algorithm", el descriptor se aplica al algoritmo actual. El comando quality se puede usar para definir otros nombres de descriptor.
secuencia al número	Especifica la secuencia de vídeo reproducida desde el área de trabajo. Si no se especifica la secuencia y el formato de archivo no define una secuencia predeterminada, se reproduce la secuencia de vídeo intercalada físicamente.
tono a factor	Establece el tono de la imagen. Normalmente, este ajuste se modela después del control de tono de muchos televisores de color, con 250 significado verde, 750 significado rojo y 0 (o

lpszFlags

Puede ser "wait", "notify", "test" o una combinación de estos. Para obtener más información sobre estas marcas, vea Las marcas de espera, notificación y prueba.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Observaciones

En el caso de los dispositivos VCR, el uso de setvideo con una marca que desactive una pista individual ("seguimiento track_number desactivado") podría hacer que la aplicación reciba un mensaje de estado que indica que no se pudo realizar el comando. Algunos VCR pueden desactivar solo combinaciones de pistas, no pistas individuales; por ejemplo, la primera pista de audio y una pista de vídeo de un casesette de vídeo. En este caso, simplemente use setaudio y setvideo para continuar desactivando las otras pistas que componen la combinación. El controlador apagará las pistas cuando reciba el comando para desactivar la última pista de la combinación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]

Vea también

MCI

Cadenas de comandos de MCI

capturar

list

put

record

reserva

set

setaudio

Ventana