LoadSprite()

Syntax

Ergebnis = LoadSprite(#Sprite, Dateiname$ [, Modus])

Lädt das angegebene Sprite in den Speicher zur sofortigen Verwendung. Ein Bildschirm sollte mittels OpenScreen() oder OpenWindowedScreen() geöffnet worden sein, bevor ein Sprite geladen wird.

Sprites können im BMP-Format oder in jedem anderen von der ImagePlugin Bibliothek unterstützten Format vorliegen.

Die folgenden Befehle können zum automatischen Aktivieren weiterer Bildformate verwendet werden:
UseJPEGImageDecoder()
UseJPEG2000ImageDecoder()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Parameter

#Sprite	Eine Nummer zum Identifizieren des neu geladenen Sprites. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
Dateiname$	Name der zum Erstellen des Sprites verwendeten Bilddatei.
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 geladen wurde, andernfalls Null. Wenn #PB_Any als #Sprite Parameter verwendet wurde, dann wird im Erfolgsfall die generierte Nummer zurückgegeben.

Anmerkungen

Sprites sollten nicht größer als der verwendete Bildschirmmodus sein. Das Verwenden größerer Sprites kann auf mancher Hardware funktionieren, auf anderer nicht. Besser ist das Aufsplitten des großen Sprites in mehrere kleine.

Unterstützte OS

Alle