Directory Contents Search << >>
Leonardo: Funktion LoadDIBFromFile
Achtung! Diese Seite ist Teil der noch unvollständigen Dokumentation der Alpha-Version von DaVinci 4.
Directory Contents Search << >>
Leonardo: Funktion LoadDIBFromFile
Achtung! Diese Seite ist Teil der noch unvollständigen Dokumentation der Alpha-Version von DaVinci 4.
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. |
|
