comando put

Il comando put definisce l'area della finestra dell'immagine di origine e della finestra di destinazione usata per la visualizzazione. I dispositivi di sovrimpressione digitale e video 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("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

Parametri

lpszDeviceID

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

lpszRegions

Contrassegno per la definizione dell'area. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando put e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	destinazione in framerettangolo in origine rettangoloin rettangolo	video video nella finestra rettangolonella finestra del client della finestra rettangoloin rettangolo
overlay	destinazione in frame di fotogrammi rettangoliin rettangolo	origine di origine nel video rettangoloin rettangolo

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

Valore	Significato
destination	Seleziona l'intera area client della finestra di destinazione per visualizzare i dati.
destinazione nel rettangolo	Seleziona una parte dell'area client della finestra di destinazione usata per visualizzare l'immagine. Quando viene specificata un'area della finestra di visualizzazione e il dispositivo supporta l'estensione, l'immagine di origine viene estesa all'offset e all'estensione di destinazione.
frame	Seleziona l'intero buffer fotogramma per ricevere le immagini video in ingresso.
frame in rettangolo	Seleziona una parte del buffer dei fotogrammi per ricevere le immagini video in ingresso.
source	Seleziona l'intera immagine per la visualizzazione nella finestra di destinazione.
origine in rettangolo	Seleziona una parte dell'immagine da visualizzare nella finestra di destinazione. Quando viene specificata un'area dell'immagine di origine e il dispositivo supporta l'estensione, l'immagine di origine viene estesa all'offset e all'estensione di destinazione.
Video	Seleziona l'intera immagine video in ingresso da acquisire nel buffer dei fotogrammi.
video in rettangolo	Seleziona una parte dell'immagine video in ingresso da acquisire nel buffer dei fotogrammi.
Finestra	Ripristina le dimensioni iniziali della finestra nella visualizzazione. Questo comando visualizza anche la finestra.
finestra in rettangolo	Modifica le dimensioni e la posizione della finestra di visualizzazione. Il rettangolo specificato è relativo alla finestra padre della finestra di visualizzazione (in genere il desktop) se il flag "style child" è stato usato per il comando aperto . Per modificare la posizione della finestra senza modificarne l'altezza o la larghezza, specificare zero per l'altezza e la larghezza.
client finestra	Ripristina l'area client della finestra.
client finestra in rettangolo	Modifica le dimensioni e la posizione dell'area client della finestra. Il rettangolo specificato è relativo alla finestra padre della finestra client. Per modificare la posizione della finestra senza modificarne l'altezza o la larghezza, specificare zero per l'altezza e la larghezza.

Quando un flag include un rettangolo, le coordinate del rettangolo sono relative all'origine della finestra o all'origine dell'immagine, come appropriato e vengono specificate come X1 Y1 X2 Y2. Le coordinate X1Y1 specificano l'angolo superiore sinistro e le coordinate X2Y2 specificano la larghezza e l'altezza del rettangolo.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

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

Commenti

Il comando put definisce uno o più dei rettangoli seguenti quando si utilizzano dispositivi di sovrapposizione video:

• Il rettangolo video definisce l'area dell'immagine video in ingresso da acquisire.
• Il rettangolo fotogramma definisce l'area del buffer fotogramma che riceve l'immagine video in ingresso.
• Il rettangolo di origine definisce l'area del buffer frame copiata nel rettangolo di destinazione.
• Il rettangolo di destinazione definisce l'area del client della finestra di visualizzazione che riceve l'immagine video.

Il rettangolo video è correlato al rettangolo del fotogramma nello stesso modo in cui il rettangolo di origine è correlato al rettangolo di destinazione. L'estensione può verificarsi dal rettangolo video al rettangolo del fotogramma e dal rettangolo di origine al rettangolo di destinazione. Non tutti i dispositivi supportano l'estensione e l'estensione deve essere abilitata (usando il comando set ).

Il comando seguente definisce tre aree per il video, il frame e l'origine.

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

Le aree di questo esempio sono definite come segue:

• Un'area video in ingresso da 200 pixel a 200 pixel, a partire da un'origine di 120 pixel dall'angolo superiore sinistro, verrà acquisita nel buffer del frame.
• I dati video verranno inseriti in un'area da 200 pixel all'angolo superiore sinistro del buffer fotogramma.
• I trasferimenti vengono effettuati dall'area da 200 pixel all'angolo superiore sinistro del buffer frame alla finestra di destinazione.

Requisiti

Vedi anche

MCI

Stringhe di comando MCI

open

set