Bezeichnung
csurface:CreateForRectangle -- Erstellt eine Fläche als Rechteck
Übersicht
handle = csurface:CreateForRectangle(x, y, width, height)
Beschreibung
Erstellt eine neue Fläche, die ein Rechteck innerhalb der Zielfläche ist. Alle auf dieser Oberfläche gezeichneten Operationen werden dann ausgeschnitten und auf die Zieloberfläche übertragen. Nichts, was über diese Unteroberfläche außerhalb ihrer Grenzen gezeichnet wird, wird auf die Zieloberfläche gezeichnet. Dies macht dies zu einer nützlichen Funktion, um eingeschränkte untergeordnete Oberflächen an Bibliotheksroutinen zu übergeben, die direkt auf die übergeordnete Oberfläche zeichnen, d.h. ohne weitere Backend-Zuweisungen, doppelte Pufferung oder Kopien .

Die Semantik von Untergrundflächen ist noch nicht endgültig festgelegt, es sei denn, das Rechteck besteht aus vollständigen Geräteeinheiten, ist in den Ausmaßen der Zieloberfläche enthalten und die Gerätetransformationen des Ziels oder Untergrunds werden nicht geändert.

Diese Funktion gibt ein Handle für die neu zugewiesene Oberfläche zurück. Der Aufrufer hat das zurückgegebenen Objekt zugewiesen und sollte csurface:Free() aufrufen, wenn er damit fertig ist.

Diese Funktion gibt immer ein gültiges Handle zurück, sie gibt jedoch ein Handle für eine "Null"-Oberfläche zurück, wenn sich die Quelloberfläche bereits in einem Fehlerzustand befindet oder ein anderer Fehler auftritt.

Eingaben
x
der x-Ursprung der Unteroberfläche von der oberen linken Ecke der Zieloberfläche (in Gerätebereicheinheiten).
y
der y-Ursprung der Unteroberfläche von der oberen linken Ecke der Zieloberfläche (in Gerätebereicheinheiten).
width
Breite des Untergrunds (in Gerätebereicheinheiten)
height
Höhe des Untergrunds (in Gerätebereicheinheiten)
Rückgabewerte
handle
Handle auf eine neue Oberfläche
Navigation zeigen