GrabSprite()

Syntax

Ergebnis = GrabSprite(#Sprite, x, y, Breite, Hoehe [, Modus])

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.

Wenn #PB_Any als '#Sprite' Parameter verwendet wird, dann wird die Nummer des neuen Sprites als 'Ergebnis' zurückgegeben.

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 Hauptspeicher des PC 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.

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

Unterstützte OS

Alle