Bezeichnung
csurface:CreateSimilar -- Erstellt eine ähnliche Oberfläche
Übersicht
handle = csurface:CreateSimilar(content, width, height)
Beschreibung
Erstellt eine neue Oberfläche, die möglichst kompatibel zu einer vorhandenen Oberfläche ist. Beispielsweise verfügt die neue Oberfläche über denselben Gerätemaßstab, dieselbe Ersatzauflösung und dieselben Schriftartoptionen wie die Quelloberfläche. Im Allgemeinen verwendet die neue Oberfläche auch dasselbe Backend wie die Quelloberfläche, es sei denn, dies ist aus irgendeinem Grund nicht möglich. Der Typ der zurückgegebenen Oberfläche kann mit csurface:GetType() untersucht werden.

Der Parameter content kann auf eine der folgenden Konstanten gesetzt werden:

#CAIRO_CONTENT_COLOR
Die Oberfläche nimmt nur Farbinhalte auf.
#CAIRO_CONTENT_ALPHA
Die Oberfläche enthält nur Alpha-Inhalte.
#CAIRO_CONTENT_COLOR_ALPHA
Die Oberfläche enthält Farbe und Alphainhalte.

Anfänglich sind alle Oberflächeninhalte 0 (transparent, wenn der Inhalt transparent ist, andernfalls schwarz).

Verwenden Sie csurface:CreateSimilarImage(), wenn Sie eine Bildoberfläche benötigen, die schnell auf die Zieloberfläche gemalt werden kann.

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
content
den Inhalt für die neue Oberfläche (siehe oben)
width
Breite der neuen Oberfläche (in Gerätebereicheinheiten)
height
Höhe der neuen Oberfläche (in Gerätebereicheinheiten)
Rückgabewerte
handle
Handle auf eine neue Oberfläche
Navigation zeigen