Bezeichnung
ccontext:CopyPathFlat -- Kopiert die vereinfachte Version des Pfads
Übersicht
handle = ccontext:CopyPathFlat()
Beschreibung
Ruft eine vereinfachte Kopie des aktuellen Pfads ab und gibt sie als Cairo-Pfadobjekt an den Benutzer zurück. Verwenden Sie cpath:Get(), um die einzelnen Pfadelemente abzurufen.

Diese Funktion ähnelt ccontext:CopyPath(), außer dass alle Kurven im Pfad mit stückweise linearen Näherungen angenähert werden (genau innerhalb des aktuellen Toleranzwerts). Das heißt, das Ergebnis enthält garantiert keine Elemente vom Typ #CAIRO_PATH_CURVE_TO, sondern wird stattdessen durch eine Reihe von #CAIRO_PATH_LINE_TO-Elementen ersetzt.

Diese Funktion gibt immer ein gültiges Handle zurück, das Ergebnis enthält jedoch keine Daten, wenn eine der folgenden Bedingungen zutrifft:

  1. Wenn nicht genügend Speicher zum Kopieren des Pfads vorhanden ist. In diesem Fall wird der Pfadstatus auf #CAIRO_STATUS_NO_MEMORY gesetzt.

  2. Wenn sich der Cairo-Kontext bereits in einem Fehlerzustand befindet. In diesem Fall enthält der Pfadstatus denselben Status, der von ccontext:Status() zurückgegeben würde.

Diese Funktion gibt die Kopie des aktuellen Pfads zurück. Der Aufrufer hat das zurückgegebenen Objekt zugewiesen und sollte cpath:Free() aufrufen, wenn er damit fertig ist.

Eingaben
Keine

Rückgabewerte
handle
die Kopie des aktuellen Pfades

Navigation zeigen