CatchSprite()

Syntax

Ergebnis = CatchSprite(#Sprite, SpeicherAdresse [, Modus])

Lädt das angegebene Sprite aus dem angegebenen Speicherbereich 'SpeicherAdresse'. Wenn #PB_Any als '#Sprite' Parameter verwendet wird, dann wird der Identifier des neuen Sprite als 'Ergebnis' zurückgegeben.

Vor dem Laden eines Sprites sollte ein Bildschirm mit OpenScreen() oder OpenWindowedScreen() geöffnet sein. Wenn beim Laden des Sprites ein Fehler auftrat, wird als 'Ergebnis' 0 zurückgegeben.

Sprites können im BMP-Format (mit 1 Bit, 4 Bit, 8 Bit, 16 Bit, 24 Bit oder 32 Bit Farbtiefe, in unkomprimierter Form [nicht RLE]) oder in jedem anderen von der ImagePlugin Library unterstützten Format vorliegen.

Ein geladenes Sprite kann mittels dem FreeSprite() Befehl freigegeben werden.

Der 'CatchSprite' Befehl ist nützlich im Zusammenhang mit dem 'IncludeBinary' PureBasic Schlüsselwort. Damit können Bilder mit in das Executable gepackt werden. Verwenden Sie diese Option trotzdem mit Bedacht, da mehr Speicher als beim Speichern des Sprites in einer externen Datei benötigt wird (das Sprite befindet sich sowohl im Speicher des Executable und wird auch in den physikalischen Speicher geladen).

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

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

Der 'Modus' Parameter ist optional und kann folgende Werte annehmen:

  0                 : Normaler Modus, das Sprite befindet sich im Video-Speicher (wenn möglich)
  #PB_Sprite_Memory : das Sprite wird in den PC-Hauptspeicher geladen (für SpecialFX)
  #PB_Sprite_Alpha  : das Sprite ist in 8 Bit, grau und wird mit DisplayAlphaSprite() oder DisplayShadowSprite() benutzt
  #PB_Sprite_Texture: das Sprite wird mit 3D Unterstützung erstellt, nützlich für den CreateSprite3D() Befehl der Sprite3D Library.

Beispiel:

  CatchSprite(0, ?Pic)
  End

  DataSection
    Pic: IncludeBinary "Sprite.bmp"

Hinweis: Das "?" ist ein Zeiger auf eine Sprungmarke. Weitere Informationen über Zeiger und Speicherzugriff finden Sie im zugehörigen Kapitel hier.

Bei der Verwendung des 8 Bit-Bildschirmmodus (256 Farben, mit Farbpalette), werden nur 8 Bit-BMPs als Spriteformat akzeptiert. Die ImagePlugins oder andere BMP-Farbformate werden nicht unterstützt.

Unterstützte OS

All