CatchSprite

CatchSprite()

Syntax

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

Beschreibung

Lädt das angegebene Sprite aus dem angegebenen Speicherbereich 'SpeicherAdresse'.

Vor dem Laden eines Sprites sollte ein Bildschirm mit OpenScreen() oder OpenWindowedScreen() geöffnet werden.

Sprites können im BMP-Format oder in jedem anderen von der ImagePlugin Bibliothek 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()
UseJPEG2000ImageDecoder()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Parameter

#Sprite Eine Nummer zum Identifizieren des neuen Sprites. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.

*SpeicherAdresse Die Speicheradresse, welche das zum Erstellen des Sprites benutzte Bild beinhaltet.
Modus (optional)
Dies kann eine Kombination der folgenden Werte (verknüpft mit dem '|' Operator) sein:
  #PB_Sprite_PixelCollision: Fügt spezielle Informationen zum Handling der Pixel-Kollision mittels SpritePixelCollision() hinzu.
  #PB_Sprite_AlphaBlending : Das Sprite wird mit per Pixel Alpha-Kanal Unterstützung erstellt, benötigt
                             für DisplayTransparentSprite(). Das Bildformat muss dies unterstützen
                             (derzeit nur PNG und TIFF). 

Rückgabewert

Ein Wert ungleich Null, wenn das Sprite erstellt wurde, andernfalls Null. Wenn #PB_Any als #Sprite Parameter verwendet wurde, dann wird im Erfolgsfall die generierte Nummer zurückgegeben.

Beispiel

  CatchSprite(0, ?Pic)
  End

  DataSection
    Pic: IncludeBinary "Sprite.bmp"

Anmerkungen

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

Siehe auch

CreateSprite(), LoadSprite()

Unterstützte OS

Alle

Sprite Inhaltsverzeichnis - ClipSprite() ->

#Sprite	Eine Nummer zum Identifizieren des neuen Sprites. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
*SpeicherAdresse	Die Speicheradresse, welche das zum Erstellen des Sprites benutzte Bild beinhaltet.
Modus (optional)	Dies kann eine Kombination der folgenden Werte (verknüpft mit dem '\|' Operator) sein: #PB_Sprite_PixelCollision: Fügt spezielle Informationen zum Handling der Pixel-Kollision mittels SpritePixelCollision() hinzu. #PB_Sprite_AlphaBlending : Das Sprite wird mit per Pixel Alpha-Kanal Unterstützung erstellt, benötigt für DisplayTransparentSprite(). Das Bildformat muss dies unterstützen (derzeit nur PNG und TIFF).