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