Syntax
INT is_SaveImage (HIDS hf, char* File)
Beschreibung
Speichert ein Bild im Bitmap Format (*.BMP) in eine Datei. Die Bilder werden aus dem aktiven Bildspeicher ausgelesen (siehe auch is_GetImageMem()). In den DirectDraw Modi werden die Bilddaten direkt aus dem entsprechenden DirectDraw Buffer gelesen. Im DirectDraw Primary Surface Modus ist zu beachten, dass das Bild so gespeichert wird wie es aktuell auf dem Bildschirm dargestellt ist. Es wird nur mit maximal der Größe des Bild-Ausgabefensters gespeichert, unabhängig davon welche Bildgröße mit is_SetImageSize() eingestellt ist. Falls andere Fenster das Bild-Ausgabefenster ganz oder teilweise überlagern, so wird der überlagernde Inhalt mit gespeichert!
Das Bitmap wird mit der Farbtiefe (8, 15, 16, 24 oder 32 Bit) gespeichert, wie der Bildspeicher alloziert wurde bzw. wie der aktuelle Farbmodus bei DirectDraw-Ausgabemodi eingestellt ist. Einige Bildbearbeitungsprogramme unterstützen keine 15-Bit-, 16-Bit- oder 32-Bit-Bitmaps und können somit in diesen Modi gespeicherte Bilder nicht einlesen!
Der Dateiname kann sowohl absolute als auch relative Pfadangaben enthalten. Mit is_LoadImage() werden BMP-Bilder gelesen.
Im DirectDraw Back-Buffer-Modus werden die Overlay-Daten mit gespeichert, wenn das Overlay sichtbar ist.
Im DirectDraw Overlay-Surface-Modus werden Overlay-Daten generell nicht gespeichert!
Das Auslesen des DirectDraw-Buffers ist im Vergleich zum Auslesen des PC RAM verhältnismäßig langsam. Dadurch ist mit einer längeren Verarbeitungszeit beim Speichern von DirectDraw-Buffern zu rechnen.
Übergabeparameter
hf |
Handle auf Frame Grabber |
File |
Name der BMP-Bilddatei NULL = "Speichern unter"-Dialogbox wird geöffnet |
Rückgabewert
IS_SUCCESS, IS_NO_SUCCESS
