Funzione ICImageCompress (vfw.h)

La funzione ICImageCompress comprime un'immagine a una determinata dimensione. Questa funzione non richiede funzioni di inizializzazione.

Sintassi

HANDLE VFWAPI ICImageCompress(
  HIC          hic,
  UINT         uiFlags,
  LPBITMAPINFO lpbiIn,
  LPVOID       lpBits,
  LPBITMAPINFO lpbiOut,
  LONG         lQuality,
  LONG         *plSize
);

Parametri

hic

Handle per un compressore aperto con la funzione ICOpen . Specificare NULL per fare in modo che VCM selezioni un compressore appropriato per il formato di compressione. Un'applicazione può fare in modo che l'utente selezioni il compressore usando la funzione ICCompressorChoose , che apre il compressore selezionato e restituisce un handle del compressore in questo parametro.

uiFlags

Riservati; deve essere zero.

lpbiIn

Puntatore alla struttura BITMAPINFO contenente il formato dei dati di input.

lpBits

Puntatore ai bit di dati di input da comprimere. I bit di dati escludono informazioni di intestazione e formato.

lpbiOut

Puntatore alla struttura BITMAPINFO contenente il formato di output compresso. Specificare NULL per fare in modo che il compressore usi un formato appropriato.

lQuality

Valore di qualità utilizzato dal compressore. I valori sono compresi tra 0 e 10.000.

plSize

Dimensioni massime desiderate per l'immagine compressa. Il compressore potrebbe non essere in grado di comprimere i dati in base a queste dimensioni. Quando la funzione viene restituita, questo parametro punta alle dimensioni dell'immagine compressa. Le dimensioni dell'immagine vengono specificate in byte.

Valore restituito

Restituisce un handle a un DIB compresso. I dati dell'immagine seguono l'intestazione del formato.

Commenti

Per ottenere le informazioni sul formato dalla struttura BITMAPINFOHEADER , utilizzare la funzione GlobalLock per bloccare i dati. Usare la funzione GlobalFree per liberare il DIB al termine.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vfw.h
Libreria	Vfw32.lib
DLL	Msvfw32.dll

Vedi anche

Funzioni di compressione video

Gestione compressione video