setvideo, commande

Article
06/13/2023

La commande setvideo définit les valeurs associées à la lecture et à la capture vidéo. Les appareils de vidéo numérique et de magnétoscope reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

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

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszVideo

Indicateur pour la lecture et la capture vidéo. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande setvideo et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	algorithmebitsperpel pour compterla luminosité à factorclocktimecolor pour factorcontrast to factorgamma to valuehalftoneinputkey color to r:g:bkey index to indexoffonoutput	couleur de couleur de la palette sur la duréesur l’indexpour newrgb palette handle pour gérerla fréquence d’images de l’enregistrement de descripteurde qualité pour évaluerl’enregistrement sur l’offsharpness de factorsource à la valeurde numéro sourcetoujours algorithme algorithmetoujours qualité flux de descripteurà numéroteinte à facteur
Magnétoscope	offonmonitor pour taper number recordoffrecord track track_number off	enregistrer sur la piste d’enregistrement track_number onsource pour taper la piste numérotrack_number hors piste track_number sur

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszVideo et leurs significations.

Valeur	Signification
algorithme	Spécifie un algorithme de compression vidéo à utiliser par une commande de réserve ou d’enregistrement ultérieure. Les algorithmes pris en charge par un appareil sont spécifiques à l’appareil. MCI définit les constantes « mpeg » et « h261 » pour l’algorithme. Si l’algorithme spécifié est en conflit avec le format de fichier actuel, le format de fichier est remplacé par le format par défaut de l’algorithme.
bitsperpel à compter	Définit le nombre de bits par pixel pour l’enregistrement des données avec la commande de capture ou d’enregistrement .
luminosité à factoriser	Définit le niveau de luminosité vidéo.
heure de l’horloge	Indique que l’heure spécifiée dans l’indicateur « over » est en millisecondes. Le temps est absolu et n’est pas en phase avec le jeu de l’espace de travail.
couleur à factoriser	Définit le niveau de saturation des couleurs.
contrast to factor	Définit le niveau de contraste vidéo.
gamma à value	Spécifie l’exposant de correction gamma multiplié par 1000. Par exemple, pour spécifier un exposant de 2.2, utilisez 2200 comme valeur. Une valeur gamma de 1,0 (1000) indique qu’aucune correction gamma n’est appliquée. La correction gamma ajuste le mappage entre l’intensité encodée dans la source de présentation et la luminosité affichée.
Demi-teintes	Entraîne l’utilisation de la palette de demi-tons à la place de la palette par défaut. Cet indicateur est reconnu uniquement par le pilote de vidéo numérique MCIAVI.
entrée	Modifie l’indicateur « luminosité », « couleur », « contraste », « gamma », « netteté » ou « teinte » afin qu’il affecte le signal d’entrée et modifie ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance de l’entrée.
couleur de clé pour r:g:b	Définit la couleur de la clé. La variable r:g:b est une valeur RVB. Deux-points (:) séparent les valeurs individuelles rouges, vertes et bleues.
index de clé à indexer	Définit l’index de clé. La variable d’index est un index de palette physique.
monitor to type number number	Contrôle l’entrée source qui sera passée à la sortie VCR, sans modifier la sélection de l’entrée de la source d’enregistrement. Le type peut être « output » ou l’une des sources d’entrée valides. Si « number » n’est pas spécifié, la première entrée de ce type est choisie.
offon	Active ou désactive l’affichage de la vidéo. La désactivation de la vidéo définit les pixels du rectangle « destination » (ou sa valeur par défaut, la région cliente de la fenêtre active) sur une couleur unie. Elle n’a aucun effet sur la mémoire tampon de trame. La source vidéo, qu’il s’agisse de l’espace de travail ou d’une entrée externe, peut continuer à stocker de nouvelles images dans la mémoire tampon d’images. Ils ne sont pas affichés tant que la vidéo n’est pas activée. Vous pouvez utiliser la commande « state » de la fenêtre pour masquer la fenêtre. La valeur par défaut est définievideo « on ».
sortie	Modifie l’indicateur « luminosité », « couleur », « contraste », « gamma », « netteté » ou « teinte » afin qu’il modifie uniquement le signal affiché et non ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance d’un fichier.
sur la durée	Spécifie le temps nécessaire pour apporter une modification qui utilise une variable de facteur . Les unités de durée sont au format d’heure actuel. Les modifications se produisent en phase avec la lecture de l’espace de travail. Lorsque la lecture est suspendue, la modification est également suspendue jusqu’à ce que la lecture se poursuive. Si « over » n’est pas utilisé ou non pris en charge, la modification se produit immédiatement.
couleur de la palette sur l’index sur newrgb	Définit une nouvelle couleur de palette. La couleur et l’index de palette à modifier sont spécifiés par les paramètres de couleur et d’index ; la nouvelle couleur est spécifiée par newrgb. Cet indicateur est reconnu uniquement par le pilote de vidéo numérique MCIAVI.
poignée de palette à gérer	Spécifie le handle d’une palette que l’appareil doit utiliser pour le rendu. Cet élément est pris en charge uniquement par les appareils qui utilisent des palettes. Si handle est égal à zéro, la palette par défaut est utilisée. Les appareils vidéo numériques ne doivent pas libérer la palette passée avec cette commande. Les applications doivent le libérer après avoir fermé l’appareil.
descripteur de qualité	Spécifie les caractéristiques de la compression vidéo effectuée lorsque la vidéo est enregistrée dans un fichier. Tous les appareils prennent en charge les trois descripteurs : « faible », « moyen » et « élevé ». La valeur par défaut est spécifique à l’appareil. La signification de ces noms dépend de l’algorithme et de l’appareil. Les appareils peuvent définir des noms de descripteurs supplémentaires. La commande de qualité peut être utilisée pour définir des noms de descripteurs supplémentaires. Si l’indicateur « algorithme » n’est pas utilisé, le descripteur s’applique à l’algorithme actuel.
enregistrer la fréquence d’images à la fréquence	Définit l’enregistrement pour la vidéo de mouvement. La vitesse d’enregistrement est spécifiée en unités d’images par seconde multipliées par 1 000. Par exemple, la fréquence d’images NTSC de 29,97 images par seconde est représentée par 29970.
enregistrer surenregistrement désactivé	Active ou désactive l’enregistrement des données vidéo. L’enregistrement de données vidéo est la valeur par défaut.
enregistrer les track_number hors piste	Efface la sélection de la source vidéo afin qu’aucune vidéo ne soit enregistrée avec la commande d’enregistrement suivante. « Track » permet la sélection de piste indépendante. Si « track » n’est pas spécifié, une valeur par défaut de 1 est supposée. Il peut être nécessaire d’émettre d’abord une commande set « assembler l’enregistrement désactivé » avant que l’enregistrement vidéo puisse être désactivé.
enregistrer les track_number sur	Sélectionne la source vidéo à enregistrer avec la commande d’enregistrement suivante. « Track » permet la sélection de piste indépendante. La piste 2 correspond à la piste PCM dans Hi8. Si « track » n’est pas spécifié, la valeur par défaut est 1.
netteté à factoriser	Définit le niveau de netteté de la vidéo.
valeur du numéro de source à la source	Définit la source de l’entrée vidéo. Cela correspond généralement à des connecteurs externes. Les constantes définies pour la source incluent « rgb », « pal », « ntsc », « svideo » et « secam ». S’il existe plusieurs entrées du type spécifié, la valeur facultative « nombre » indique l’entrée souhaitée. Par exemple, setvideo « source to ntsc number 2 » spécifie la deuxième entrée NTSC. Si la source « to » est omise, la source absolue est utilisée comme défini par la commande list « video source ».
source à tapernuméro	Sélectionne la source vidéo à enregistrer sur la bande. Le type doit être « tuner », « line », « svideo », « aux », « generic », « mute » ou « rgb ».
algorithme still	Spécifie l’algorithme de compression d’images fixes utilisé par la commande de capture . Chaque appareil doit prendre en charge un algorithme « none », ce qui signifie aucune compression. Il s’agit de la valeur par défaut. Dans ce cas, les appareils vidéo numériques enregistrent des images fixes en tant que bitmaps indépendantes de l’appareil RVB. Les appareils peuvent également prendre en charge une liste d’algorithmes supplémentaires spécifiques à l’appareil.
descripteur de qualité still	Spécifie les caractéristiques de la compression d’image fixe effectuée lors de la capture d’une image fixe. Tous les appareils prennent en charge les descripteurs « low », « medium » et « high ». La valeur par défaut est spécifique à l’appareil. Si l’indicateur « algorithme » n’est pas utilisé, le descripteur s’applique à l’algorithme actuel. La commande quality peut être utilisée pour définir d’autres noms de descripteurs.
stream to number	Spécifie le flux vidéo lu à partir de l’espace de travail. Si le flux n’est pas spécifié et qu’aucun flux par défaut n’est défini par le format de fichier, le premier flux vidéo physiquement entrelacé est lu.
teinte à factoriser	Définit la teinte de l’image. En règle générale, cet ajustement est modélisé d’après le contrôle de la teinte de nombreux téléviseurs couleur, 250 signifiant vert, 750 signifiant rouge et 0 (ou

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Notes

Pour les appareils vcr, l’utilisation de setvideo avec un indicateur qui désactive une piste individuelle (« suivre track_number désactivé ») peut faire en sorte que votre application reçoive un message status indiquant que la commande n’a pas pu être exécutée. Certains magnétoscopes ne peuvent désactiver que des combinaisons de pistes, et non des pistes individuelles; par exemple, la première piste audio et une piste vidéo d’une cassette vidéo. Dans ce cas, utilisez simplement setaudio et setvideo pour continuer à désactiver les autres pistes qui composent la combinaison. Le pilote désactive les pistes lorsqu’il reçoit la commande pour désactiver la dernière piste de la combinaison.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI
Chaînes de commande MCI
Capture
list
Mettre
enregistrement
Réserve
set
setaudio
Fenêtre