CatchImage()

Syntax

Ergebnis = CatchImage(#Image, Speicheradresse [, Groesse])

Lädt das angegebene Bild '#Image' von der angegebenen Speicheradresse. Wenn #PB_Any als '#Image' Parameter verwendet wird, dann wird die Nummer des neuen Image als 'Ergebnis' zurückgegeben. Wenn ein Bild geladen wird, dann wird es entweder in 24 Bit konvertiert (wenn die Bildtiefe kleiner oder gleich 24 Bit ist), oder in 32 Bit (wenn das Bild einen Alpha-Kanal hat).

Das Bild kann im BMP-, Icon- (.ico, nur auf Windows) 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).

Der optionale Parameter 'Groesse' gibt die maximale Größe (in Bytes) des zu ladenden Bildes an. Dies kann einem Absturz vorbeugen, wenn versucht wird, Bilder unbekannter Herkunft zu laden, welche beschädigt sein können.

Die folgenden Befehle können zum Aktivieren weiterer Bildformate benutzt werden:

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

Beispiel:

  CatchImage(0, ?Logo)
  End

  DataSection
    Logo: IncludeBinary "Logo.bmp"
  EndDataSection

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. Wenn auf Windows das angegebene Bild ein Icon (.ico) ist, sind die folgenden Befehle zu dessen Manipulation nicht verfügbar: SaveImage() und @fastimage"ImageOutput()".

Unterstützte OS

Alle