Syntax
INT is_LoadImage (HIDS hf, char* File)
Beschreibung
Lädt ein Bild aus einer Datei. Das Bild muss im BMP-Format vorliegen. Das Bild wird in den aktiven Bildspeicher geladen (siehe auch is_GetImageMem()) oder unter DirectDraw in den entsprechenden DirectDraw Buffer. Im DirectDraw Primary-Surface-Modus ist zu beachten, dass das Bild maximal in der Größe des Ausgabefensters geladen wird. Ist das zu ladende Bild größer, so werden die überhängenden Bereiche abgeschnitten.
Der Dateiname kann sowohl absolute als auch relative Pfadangaben enthalten. Mit is_SaveImage() werden Bilder als BMP-Datei gespeichert.
Übergabeparameter
hf |
Handle auf Frame Grabber |
File |
Name der BMP-Bilddatei NULL = Dialogbox zur Eingabe des Pfadnamens erscheint (siehe is_BoardStatus() zum Beibehalten des Verzeichnispfades) |
Rückgabewert
IS_SUCCESS, IS_NO_SUCCESS