setvideo-Befehl
Der Befehl setvideo legt Werte fest, die der Videowiedergabe und -erfassung zugeordnet sind. DigitalVideo- und VCR-Geräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("setvideo %s %s %s"),
lpszDeviceID,
lpszVideo,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszVideo
-
Flag für Videowiedergabe und -erfassung. Die folgende Tabelle enthält Gerätetypen, die den setvideo-Befehl und die von den einzelnen Typen verwendeten Flags erkennen.
Wert Bedeutung Bedeutung digitalvideo algorithmus algorithm bitsperpel to count brightness to factor clocktimecolor to factor contrast to factor gamma to value halftoneinputkey color to r:g:b key index to index offonoutput Farbfarbe der Überdauerpalette über Index zu Newrgb Palettenhandle, um die Bildrate des Qualitätsdeskriptors für Aufzeichnungsdatensätze zu verarbeiten, um die Offsharpness des Datensatzes zu bewerten, um die Quelle auf den Wert der Quellzahl zu berücksichtigen. Algorithmus dennoch Qualitätsdeskriptorstream zu Anzahltonung zu Faktor Vcr offonmonitor zum Eingeben von Number Number Record offrecord track _ number off record onrecord track number onsource to type number track number track _ number offtrack track _ _ number on Die folgende Tabelle enthält die Flags, die im lpszVideo-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung Algorithmusalgorithmus Gibt einen Videokomprimierungsalgorithmus für die Verwendung durch einen nachfolgenden Reserve- oder Aufzeichnungsbefehl an. Von einem Gerät unterstützte Algorithmen sind gerätespezifisch. MCI definiert die Konstanten "mpeg" und "h261" für den Algorithmus. Wenn der angegebene Algorithmus mit dem aktuellen Dateiformat in Konflikt steht, wird das Dateiformat in das Standardformat für den Algorithmus geändert. bitsperpel to count Legt die Anzahl der Bits pro Pixel zum Speichern von Daten mit dem Befehl capture oder record fest. Helligkeit nach Faktor Legt die Helligkeitsstufe des Videos fest. clocktime Gibt an, dass die im Flag "over" angegebene Zeit in Millisekunden liegt. Die Zeit ist absolut und nicht schrittweise mit der Wiedergabe des Arbeitsbereichs. Zu berücksichtigende Farbe Legt den Farbsättigungsgrad fest. Contrast to Factor Legt die Videokontrastebene fest. Gamma in Wert Gibt den Exponenten für die Gammakorrektur multipliziert mit 1000 an. Um beispielsweise einen Exponenten von 2.2 anzugeben, verwenden Sie 2200 als Wert. Ein Gammawert von 1,0 (1000) gibt an, dass keine Gammakorrektur angewendet wird. Die Gammakorrektur passt die Zuordnung zwischen der in der Präsentationsquelle codierten Intensität und der angezeigten Helligkeit an. Halbton Bewirkt, dass die Halbtonpalette anstelle der Standardpalette verwendet wird. Dieses Flag wird nur vom MCIAVI-Treiber für digitale Videos erkannt. input Ändert das Flag "Helligkeit", "Farbe", "Kontrast", "Gamma", "Schärfe" oder "Tönung", sodass es sich auf das Eingabesignal auswirkt und ändert, was aufgezeichnet wird. Wenn möglich, ist dies die Standardeinstellung beim Überwachen der Eingabe. Schlüsselfarbe für r:g:b Legt die Schlüsselfarbe fest. Die Variable r:g:b ist ein RGB-Wert. Doppelpunkte (:) trennen Sie die einzelnen Werte für Rot, Grün und Blau. Schlüsselindex, der indiziert werden soll Legt den Schlüsselindex fest. Die Indexvariable ist ein physischer Palettenindex. überwachen, um Die Nummer einzugeben Steuert, welche Quelleingabe an die VCR-Ausgabe übergeben wird, ohne die Eingabeauswahl der Aufzeichnungsquelle zu ändern. Der Typ kann "output" oder eine der gültigen Eingabequellen sein. Wenn "number" nicht angegeben ist, wird die erste Eingabe dieses Typs ausgewählt. offon Aktiviert oder deaktiviert die Anzeige von Videos. Durch das Deaktivieren des Videos werden die Pixel im Put-Rechteck "Ziel" (oder dessen Standard, der Clientbereich des aktuellen Fensters) auf eine Volltonfarbe festgelegt. Sie hat keine Auswirkungen auf den Framepuffer. Die Videoquelle, unabhängig davon, ob der Arbeitsbereich oder eine externe Eingabe, speichert möglicherweise weiterhin neue Bilder im Framepuffer. Sie werden erst angezeigt, wenn das Video aktiviert ist. Sie können den Befehl "state" des Fensters verwenden, um das Fenster auszublenden. Der Standardwert ist setvideo "on". output Ändert das Flag "Helligkeit", "Farbe", "Kontrast", "Gamma", "Schärfe" oder "Tönung", sodass nur das angezeigte Signal und nicht das aufgezeichnete Geändert wird. Wenn möglich, ist dies die Standardeinstellung bei der Überwachung einer Datei. over duration Gibt an, wie lange es dauern soll, eine Änderung vorzunehmen, die eine Faktorvariable verwendet. Die Einheiten für die Dauer liegen im aktuellen Zeitformat vor. Änderungen treten im Schritt beim Wiedergeben des Arbeitsbereichs auf. Wenn die Wiedergabe angehalten wird, wird die Änderung auch angehalten, bis die Wiedergabe fortgesetzt wird. Wenn "over" nicht verwendet oder nicht unterstützt wird, erfolgt die Änderung sofort. Farbpalettenfarbe über Index in newrgb Legt eine neue Palettenfarbe fest. Die zu ändernde Farbe und der Palettenindex werden durch die Farb- und Indexparameter angegeben. die neue Farbe wird von newrgb angegeben. Dieses Flag wird nur vom MCIAVI-Treiber für digitale Videos erkannt. Zu behandelnde Palettenhandle Gibt das Handle für eine Palette an, die das Gerät für das Rendering verwenden muss. Dieses Element wird nur von Geräten unterstützt, die Paletten verwenden. Wenn handle 0 (null) ist, wird die Standardpalette verwendet. Digitale Videogeräte sollten die mit diesem Befehl übergebene Palette nicht freigeben. Anwendungen sollten es freigeben, nachdem sie das Gerät geschlossen haben. Qualitätsbeschreibung Gibt die Merkmale der Videokomprimierung an, die ausgeführt wird, wenn das Video in einer Datei aufgezeichnet wird. Alle Geräte unterstützen die drei Deskriptoren "low", "medium" und "high". Der Standardwert ist gerätespezifisch. Die Bedeutung dieser Namen hängt vom Algorithmus und dem Gerät ab. Geräte können zusätzliche Deskriptornamen definieren. Der Quality-Befehl kann verwendet werden, um zusätzliche Deskriptornamen zu definieren. Wenn das Flag "algorithm" nicht verwendet wird, gilt der Deskriptor für den aktuellen Algorithmus. Aufzeichnen der Bildfrequenz zur Rate Legt die Aufzeichnung für Bewegungsvideos fest. Die Aufzeichnungsrate wird in Einheiten von Frames pro Sekunde multipliziert mit 1000 angegeben. Beispielsweise wird die NTSC-Bildfrequenz von 29,97 Frames pro Sekunde als 29970 dargestellt. datensatz onrecord off Aktiviert oder deaktiviert die Aufzeichnung von Videodaten. Die Standardeinstellung ist das Aufzeichnen von Videodaten. Record Track Track _ Number off Clears the video-source selection so that no video will be recorded with the next record command. "Track" ermöglicht eine unabhängige Trackauswahl. Wenn "track" nicht angegeben ist, wird der Standardwert 1 angenommen. Möglicherweise ist es erforderlich, zuerst einen satz "assemble record off"-Befehl aus auszuführen, bevor die Videoaufzeichnung deaktiviert werden kann. Record Track Track _ Number on Wählt die Videoquelle aus, die mit dem nächsten Datensatzbefehl aufgezeichnet werden soll. "Track" ermöglicht eine unabhängige Trackauswahl. Track 2 entspricht der PCM-Spur in Hi8. Wenn "track" nicht angegeben ist, wird der Standardwert 1 angenommen. Schärfe zum Faktor Legt die Videoschärfestufe fest. Source-to-Source-Zahlenwert Legt die Quelle der Videoeingabe fest. Dies entspricht in der Regel externen Connectors. Die für die Quelle definierten Konstanten umfassen "rgb", "pal", "ntsc", "svideo" und "secam". Wenn mehr als eine Eingabe des angegebenen Typs vorhanden ist, gibt der optionale Wert "number" die gewünschte Eingabe an. Beispielsweise gibt setvideo "source to ntsc number 2" die zweite NTSC-Eingabe an. Wenn die Quelle "to" ausgelassen wird, wird die absolute Quelle gemäß der Definition durch den Befehl "video source" der Liste verwendet. source to type number number Wählt die Videoquelle aus, die auf dem Band aufgezeichnet werden soll. Typ muss "tuner", "line", "svideo", "aux", "generic", "mute" oder "rgb" sein. still-Algorithmusalgorithmus Gibt den vom Erfassungsbefehl verwendeten Algorithmus für die Bildkomprimierung an. Jedes Gerät muss den Algorithmus "None" unterstützen, was bedeutet, dass keine Komprimierung durchgeführt wird. Dies ist die Standardoption. In diesem Fall speichern Digitalvideogeräte Stillbilder als RGB-geräteunabhängige Bitmaps. Geräte unterstützen möglicherweise auch eine gerätespezifische Liste zusätzlicher Algorithmen. Noch-Qualitätsdeskriptor Gibt die Merkmale der Stillbildkomprimierung an, die beim Erfassen eines Stillbilds ausgeführt wird. Alle Geräte unterstützen die Deskriptoren "niedrig", "mittel" und "hoch". Der Standardwert ist gerätespezifisch. Wenn das Flag "algorithm" nicht verwendet wird, gilt der Deskriptor für den aktuellen Algorithmus.
Der Quality-Befehl kann verwendet werden, um andere Deskriptornamen zu definieren.stream to number Gibt den Videostream an, der aus dem Arbeitsbereich wiedergibt. Wenn der Stream nicht angegeben ist und ein Standardstream nicht durch das Dateiformat definiert ist, wird der physisch erste überlappte Videostream abgespielt. Tönung zu Faktor Legt die Tönung des Bilds fest. In der Regel wird diese Anpassung nach der Tönungssteuerung vieler Farb-Tv-Sets modelliert. 250 bedeutet Grün, 750 bedeutet Rot und 0 (oder -
lpszFlags
-
Kann "wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
Rückgabewert
Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.
Bemerkungen
Bei VCR-Geräten kann die Verwendung von setvideo mit einem Flag, das eine einzelne Spur ausschaltet ("Track _ track number off"), dazu führen, dass Ihre Anwendung eine Statusmeldung erhält, die angibt, dass der Befehl nicht ausgeführt werden konnte. Einige VCRs können nur Kombinationen von Spuren deaktivieren, nicht einzelne Spuren. Beispiel: die erste Audiospur und eine Videospur einer Video cassette. Verwenden Sie in diesem Fall einfach setaudio und setvideo, um die anderen Spuren, aus denen die Kombination aufbaut, weiter zu deaktivieren. Der Treiber deaktiviert die Spuren, wenn er den Befehl empfängt, um die letzte Spur in der Kombination zu deaktivieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |