comando setvideo

Il comando setvideo imposta i valori associati alla riproduzione video e all'acquisizione. I dispositivi digital-video e VCR riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

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

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszVideo

Flag per la riproduzione video e l'acquisizione. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando setvideo e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	algoritmo algoritmobitsperpel per contarela luminosità al fattoreclocktimecolor a contrasto delfattore gamma al valoredel colore halftoneinputkey a r:g:bkey index to indexoffonoutput	nel colore del colore della tavolozza della duratarispetto all'indicea un handle della tavolozza newrgb per gestirela frequenza dei fotogrammi del descrittoredi qualità per registrareil record su offsharpness onrecord offsharpness to factorall'origine dell'origine del valoredel numeroancora algoritmo algoritmo algoritmicoflusso descrittoredi qualità al numero a fattore
Vcr	offonmonitor per digitare numero direcord offrecord track track_number off	record onrecord track track_number onsource per digitare il numero di traccia numerotrack_numberofftrack track_number

La tabella seguente elenca i flag che possono essere specificati nel parametro lpszVideo e i relativi significati.

Valore	Significato
algoritmo algoritmo	Specifica un algoritmo di compressione video da usare da un comando di riserva o record successivo. Gli algoritmi supportati da un dispositivo sono specifici del dispositivo. MCI definisce le costanti "mpeg" e "h261" per l'algoritmo. Se l'algoritmo specificato è in conflitto con il formato di file corrente, il formato del file viene modificato nel formato predefinito per l'algoritmo.
bitsperpel to count	Imposta il numero di bit per pixel per salvare i dati con il comando acquisizione o record .
luminosità a fattore	Imposta il livello di luminosità video.
clocktime	Indica che l'ora specificata nel flag "over" è in millisecondi. Il tempo è assoluto e non in fase di riproduzione dell'area di lavoro.
colore da fattore	Imposta il livello di saturazione dei colori.
contrasto al fattore	Imposta il livello di contrasto video.
gamma a valore	Specifica l'esponente della correzione gamma moltiplicata per 1000. Ad esempio, per specificare un esponente di 2.2, usare 2200 per valore. Un valore gamma pari a 1,0 (1000) indica che non viene applicata alcuna correzione gamma. La correzione gamma regola il mapping tra l'intensità codificata nell'origine della presentazione e la luminosità visualizzata.
Semitono	Causa l'uso della tavolozza halftone anziché della tavolozza predefinita. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI.
input	Modifica il flag "luminosità", "colore", "contrasto", "gamma", "nitidezza" o "tinta" in modo che influisca sul segnale di input e modifica ciò che viene registrato. Se possibile, si tratta dell'impostazione predefinita quando si monitora l'input.
colore chiave per r:g:b	Imposta il colore della chiave. La variabile r:g:b è un valore RGB. Punti (:) separare i singoli valori rossi, verdi e blu.
indice chiave da indicizzare	Imposta l'indice della chiave. La variabile di indice è un indice del tavolozza fisico.
monitor per digitareil numero	Controlla quale input di origine verrà passato all'output del registro virtuale, senza modificare la selezione dell'input dell'origine di registrazione. Il tipo può essere "output" o una delle origini di input valide. Se "number" non è specificato, viene scelto il primo input di tale tipo.
offon	Abilita o disabilita la visualizzazione del video. La disabilitazione del video imposta i pixel nel rettangolo "destinazione " (o il relativo valore predefinito, l'area client della finestra corrente) su un colore a tinta unita. Non ha alcun effetto sul buffer del frame. L'origine video, indipendentemente dall'area di lavoro o da un input esterno, potrebbe continuare a archiviare nuove immagini nel buffer del frame. Non vengono visualizzati fino a quando il video non è abilitato. È possibile usare il comando "state" della finestra per nascondere la finestra. Il valore predefinito è impostato "on".
output	Modifica il flag "luminosità", "colore", "contrasto", "gamma", "nitidezza" o "tinta" in modo da modificare solo il segnale visualizzato e non quello registrato. Se possibile, si tratta dell'impostazione predefinita durante il monitoraggio di un file.
durata	Specifica il tempo necessario per apportare una modifica che usa una variabile fattore . Le unità per la durata sono nel formato ora corrente. Le modifiche si verificano nel passaggio con la riproduzione dell'area di lavoro. Quando si gioca è sospeso, la modifica viene sospesa anche fino a quando il gioco continua. Se "over" non è supportato o meno, la modifica si verifica immediatamente.
colore della tavolozza su indice a newrgb	Imposta un nuovo colore della tavolozza. Il colore e l'indice della tavolozza da modificare sono specificati dai parametri di colore e indice ; il nuovo colore viene specificato da newrgb. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI.
handle della tavolozza da gestire	Specifica l'handle in una tavolozza che il dispositivo deve usare per il rendering. Questo elemento è supportato solo dai dispositivi che usano le tavolozze. Se handle è zero, viene usata la tavolozza predefinita. I dispositivi digital-video non devono liberare la tavolozza passata con questo comando. Le applicazioni devono liberarlo dopo aver chiuso il dispositivo.
descrittore di qualità	Specifica le caratteristiche della compressione video eseguita quando il video viene registrato in un file. Tutti i dispositivi supportano i tre descrittori: "low", "medium" e "high". Il valore predefinito è specifico del dispositivo. Il significato di questi nomi dipende dall'algoritmo e dal dispositivo. I dispositivi possono definire nomi di descrittore aggiuntivi. Il comando qualità può essere usato per definire nomi di descrittori aggiuntivi. Se il flag "algoritmo" non viene usato, il descrittore si applica all'algoritmo corrente.
frequenza dei fotogrammi record a frequenza	Imposta la registrazione per il video di movimento. La frequenza di registrazione viene specificata in unità di fotogrammi al secondo moltiplicate per 1000. Ad esempio, la frequenza dei fotogrammi NTSC di 29,97 fotogrammi al secondo è rappresentata come 29970.
record disattivato	Abilita o disabilita la registrazione dei dati video. La registrazione dei dati video è l'impostazione predefinita.
record track track_number off	Cancella la selezione dell'origine video in modo che nessun video venga registrato con il comando record successivo. "Track" consente la selezione indipendente delle tracce. Se "track" non viene specificato, viene utilizzato un valore predefinito pari a 1. Potrebbe essere necessario eseguire prima di tutto un comando " assemblare record off" prima che la registrazione video possa essere disattivata.
record track track_number on	Seleziona l'origine video da registrare con il comando record successivo. "Track" consente la selezione indipendente delle tracce. La traccia 2 corrisponde alla traccia PCM in Hi8. Se "track" non è specificato, viene utilizzato il valore predefinito 1.
nitidezza a fattore	Imposta il livello di nitidezza video.
source to source number value	Imposta l'origine dell'input video. Questo corrisponde in genere ai connettori esterni. Le costanti definite per l'origine includono "rgb", "pal", "ntsc", "svideo" e "secam". Se esistono più input del tipo specificato, il valore facoltativo "number" indica l'input desiderato. Ad esempio, setvideo "source to ntsc number 2" specifica il secondo input NTSC. Se l'origine "to" viene omessa, l'origine assoluta viene usata come definito dal comando " origine video".
source to typenumber number	Seleziona l'origine video da registrare sul nastro. Il tipo deve essere "tuner", "line", "svideo", "aux", "generic", "mute" o "rgb".
algoritmo ancora algoritmo	Specifica l'algoritmo di compressione delle immagini ancora utilizzato dal comando capture . Ogni dispositivo deve supportare un algoritmo "none", ovvero nessuna compressione. Questo è il valore predefinito. In questo caso, i dispositivi digital-video salvano immagini ancora come bitmap indipendenti dal dispositivo RGB. I dispositivi possono anche supportare un elenco specifico del dispositivo di algoritmi aggiuntivi.
descrittore di qualità ancora	Specifica le caratteristiche della compressione dell'immagine ancora eseguita durante l'acquisizione di un'immagine ancora. Tutti i dispositivi supportano i descrittori "low", "medium" e "high". Il valore predefinito è specifico del dispositivo. Se il flag "algorithm" non viene usato, il descrittore si applica all'algoritmo corrente. Il comando quality può essere usato per definire altri nomi di descrittore.
flusso al numero	Specifica il flusso video riprodotto dall'area di lavoro. Se il flusso non viene specificato e un flusso predefinito non è definito dal formato di file, viene riprodotto il flusso video interleaved fisicamente.
tinta a fattore	Imposta la tinta dell'immagine. In genere, questa regolazione viene modellata dopo il controllo tinta di molti set di televisori a colori, con 250 significato verde, 750 significato rosso e 0 (o

lpszFlags

Può essere "wait", "notify", "test" o una combinazione di queste. Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.

Commenti

Per i dispositivi VCR, l'uso di setvideo con un flag che disattiva una singola traccia ("track track_number off") potrebbe causare la ricezione di un messaggio di stato dell'applicazione che indica che non è stato possibile eseguire il comando. Alcuni VCR possono disattivare solo combinazioni di tracce, non singole tracce; ad esempio la prima traccia audio e una traccia video di una cassetta video. In questo caso, usa semplicemente setaudio e setvideo per continuare a disattivare le altre tracce che compongono la combinazione. Il driver disattiva le tracce quando riceve il comando per disattivare l'ultima traccia nella combinazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

Catturare

list

Mettere

Registrazione

Riserva

set

setaudio

Finestra