ICImageCompress-Funktion (vfw.h)
Die ICImageCompress-Funktion komprimiert ein Bild auf eine bestimmte Größe. Für diese Funktion sind keine Initialisierungsfunktionen erforderlich.
Syntax
HANDLE VFWAPI ICImageCompress(
HIC hic,
UINT uiFlags,
LPBITMAPINFO lpbiIn,
LPVOID lpBits,
LPBITMAPINFO lpbiOut,
LONG lQuality,
LONG *plSize
);
Parameter
hic
Griff zu einem Kompressor, der mit der ICOpen-Funktion geöffnet wird. Geben Sie NULL an, damit VCM einen geeigneten Kompressor für das Komprimierungsformat auswählt. Bei einer Anwendung kann der Benutzer den Kompressor mithilfe der ICCompressorChoose-Funktion auswählen, die den ausgewählten Kompressor öffnet und einen Handle des Kompressors in diesem Parameter zurückgibt.
uiFlags
Reserviert; muss null sein.
lpbiIn
Zeiger auf die BITMAPINFO-Struktur , die das Eingabedatenformat enthält.
lpBits
Zeiger auf Eingabedatenbits, die komprimiert werden sollen. Die Datenbits schließen Header- und Formatinformationen aus.
lpbiOut
Zeiger auf die BITMAPINFO-Struktur , die das komprimierte Ausgabeformat enthält. Geben Sie NULL an, damit der Kompressor ein geeignetes Format verwendet.
lQuality
Vom Kompressor verwendete Qualitätswert. Die Werte reichen von 0 bis 10.000.
plSize
Die maximale gewünschte Größe für das komprimierte Bild. Der Kompressor kann die Daten möglicherweise nicht komprimieren, um in diese Größe zu passen. Wenn die Funktion zurückgibt, zeigt dieser Parameter auf die Größe des komprimierten Bilds. Bildgrößen werden in Bytes angegeben.
Rückgabewert
Gibt ein Handle an einen komprimierten DIB zurück. Die Bilddaten folgen dem Formatheader.
Hinweise
Um die Formatinformationen aus der BITMAPINFOHEADER-Struktur abzurufen, verwenden Sie die GlobalLock-Funktion , um die Daten zu sperren. Verwenden Sie die GlobalFree-Funktion , um den DIB frei zu geben, wenn Sie fertig sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vfw.h |
| Bibliothek | Vfw32.lib |
| DLL | Msvfw32.dll |