Herd Software Entwicklung
DaVinci Grafikbibliothek
DaVinci Dokumentation

Leonardo: Funktion LoadDIBFromFile

Die Funktion LoadDIBFromFile lädt eine .BMP Bitmap-Datei in den Hauptspeicher und liefert ein HDIB-Handle zurück.

HDIB API LoadDIBFromFile (
LPCSTR szFile,
HDIB hDIB);

szFile LPCSTR Zeiger auf den Dateinamen unter dem die Datei gespeichert werden soll.

Rückgabewert

Ein HDIB-Handle das die eingelesenen Dateidaten kennzeichnet. NULL, falls die Funktion nicht erfolgreich war. wahrscheinlichste Ursachen:

• die Datei mit dem angegebenen Namen wurde nicht gefunden,
  
  
• nicht genügend freier Hauptspeicher,
  
  
• das Dateiformat der Datei ist keine Windows BMP-Datei (BITMAPFILEHEADER).

Anmerkungen

Falls die DIB in der BMP-Datei RLE-Kodiert gespeichert wurde (Einfaches Kompressionsverfahren, biCompression=BI_RLE4 oder BI_RLE8) wandelt LoadDIBFromFile sie automatisch in ein unkomprimiertes Format um.

Top-Down DIBs (biHeight < 0) werden automatisch in Bottom-Up DIBs umgewandelt.

Diese Funktion befindet sich im Gegensatz zur Funktion ipImportInd in der Bibliothek LEON3_xx.DLL anstelle der DAV3_xx.DLL und erlaubt es, Programme, die nur das einfache BMP-Dateiformat benutzen, ohne die umfangreichere DAV3_xx.DLL auszuliefern.

Þ SaveDIBToFile

Þ ipImportExt