Hilfe

CopyRect

B2D B+ B3D

Aufruf

CopyRect X1, Y1, width, heigth, X2, Y2 [,Quelle] [,Ziel]

Parameter

X1 Horizontale Koordinate des Ausschnitts
Y1 Vertikale Koordinate des Ausschnitts
width Breite des Ausschnitts in Pixel
height Höhe des Ausschnitts in Pixel
X2 Horizontale Ziel-Koordinate
Y2 Vertikale ZielKoordinate
Quelle Identität des Quell-Buffers (0=aktuell)
Ziel dentität des Ziel-Buffers (0=aktuell)


Rückgabewert

-


Beschreibung

Dieser Befehl kopiert einen Bildausschnitt von einem Buffer zum anderen. Es kann aber auch ein und der selbe Buffer verwendet werden. Benutze für Buffer z.B. Backbuffer, Frontbuffer oder Imagebuffer. Werden Buffer-Parameter weggelassen, so wird der aktuelle Buffer verwendet. Die Koordinate X1/Y1 ist oben/links im Quellbuffer. Die Koordinate X2/Y2 ist dagegen oben/links im Zielbuffer.

Benutze auch Grabimage, um einfach einen Bildschirmausschnitt in ein neu erstelltes Bild zu kopieren.

Der Befehl CopyRect ist eine interessante Alternative für Flip. Wird das Bild im Backbuffer nie komplett berechnet, so kann man nur einen Teil des Bildes nach Frontbuffer kopieren.


Der Befehl CopyRect kann nicht auf einen mittels LockBuffer gesperrten Buffer angewendet werden.


Beispiel

Standardbeispiel:

Dieses Programm zeichnet verschiedene Rechtecke. Ein Ausschnitt wird dann kopiert. Nach einem Tastendruck erscheint dieser Ausschnitt:

Graphics 800, 600
gfxBlank = CreateImage (300,300)
For t = 1 To 1000
Rect Rand(800), Rand(600), Rand(100), Rand(100), Rand(0,1)
Color Rand(255), Rand(255), Rand(255)
Next
Delay 2000
CopyRect(Rand(800), Rand(600), 300, 300, 0, 0, Frontbuffer(), Imagebuffer(gfxBlank))
Cls
DrawImage gfxBlank, 0, 0
WaitKey


Siehe auch

CopyImage, GrabImage, SaveBuffer

Übersicht 2D Grafik Grafik