CatchImage()

Syntax

Ergebnis = CatchImage(#Image, Speicheradresse)

Lädt das angegebene Bild '#Image' von der angegebenen Speicheradresse. Wenn #PB_Any als '#Image' Parameter verwendet wird, dann wird der Identifier des neuen Image als 'Ergebnis' zurückgegeben.

Das Bild kann im BMP-, Icon- oder jedem anderen Format vorliegen, welches durch die ImagePlugin Library unterstützt wird. Ist das Laden des Bildes nicht möglich, wird als 'Ergebnis' 0 zurückgegeben. Ein geladenes Bild kann mit Hilfe des FreeImage() Befehls freigegeben werden.

Dieser Befehl ist nützlich in Verbindung mit dem 'IncludeBinary' PureBasic Schlüsselwort. Damit können Bilder mit in das Executable gepackt werden. Nichtsdestotrotz, benutzen Sie diese Option mit Bedacht, da hiermit mehr Speicher benötigt wird, als wenn die Bilddatei in einer externen Datei gespeichert wird (die Datei befindet sich im Speicher des Executable und auch geladen im physikalischen Speicher).
Die folgenden Befehle können zum Aktivieren weiterer Bildformate benutzt werden:

UseJPEGImageDecoder()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Beispiel:

  CatchImage(0, ?Logo)
  End

  Logo: IncludeBinary "Logo.bmp"

Hinweis: Das "?" ist ein Zeiger auf eine Sprungmarke. Weitere Informationen über Zeiger und Speicherzugriff finden Sie im zugehörigen Kapitel hier. Die Bildgröße ist derzeit auf 8192x8192 Pixel (sofern der verfügbare Speicher dies ermöglicht) limitiert.

Unterstützte OS

Windows, AmigaOS, Linux