GrabSprite

GrabSprite()

Syntax

Ergebnis = GrabSprite(#Sprite, x, y, Breite, Höhe [, Modus])

Beschreibung

Fotografiert ("grab") den Bildschirminhalt im Bereich von (x, y, Breite, Höhe) und erstellt daraus ein neues #Sprite. In der Kombination von Grabsprite und SaveSprite() ist es somit z.B. möglich, einen Screenshot eines Spiels zu erstellen.

Parameter

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

x, y Die Position auf dem Bildschirm, an der das Fotografieren beginnt (in Pixel).

Breite, Höhe Die Größe der Fotografie (in Pixel).
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().

Rückgabewert

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

Anmerkungen

GrabSprite() sollte immer außerhalb eines StartDrawing() : StopDrawing() Blocks aufgerufen werden.

Unterstützte OS

Alle

<- FreeSprite() - Sprite Inhaltsverzeichnis - InitSprite() ->

#Sprite	Eine Nummer zum Identifizieren des neuen fotografierten Sprites. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
x, y	Die Position auf dem Bildschirm, an der das Fotografieren beginnt (in Pixel).
Breite, Höhe	Die Größe der Fotografie (in Pixel).
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().