ClosePath

Διανυσματικά γραφικά, ορισμός και σχεδίαση διαδρομών

Περιγραφή

Κλείνει την τρέχουσα υποδιαδρομή της διαδρομής που ξεκίνησε με StartPath. Μια ευθεία γραμμή σχεδιάζεται από το τρέχον σημείο πίσω στο σημείο εκκίνησης της διαδρομής, ώστε το σχήμα να είναι ένα ενιαίο κλειστό σχήμα και όχι δύο τελικά σημεία ενωμένα μόνο με ένωση πινελιού. Η κλήση ClosePath δεν ζωγραφίζει τη διαδρομή — καλέστε μετά DrawPath ή DrawPathEvenOdd για να τη δώσετε περιγραμμά και/ή γέμισμα

Σύνταξη

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Τιμές επιστροφής

0Αποτυχία — δεν υπάρχει ανοιχτό έγγραφο ή δεν έχει ξεκινήσει διαδρομή
1Η τρέχουσα υπο-διαδρομή έκλεισε

Παρατηρήσεις

Το κλείσιμο της διαδρομής είναι σημαντικό κάθε φορά που το σχήμα θα υποστεί stroke: μια ανοιχτή διαδρομή αφήνει ορατό κενό μεταξύ του τελευταίου και του πρώτου σημείου, και η ένωση stroke σε αυτή την κορυφή αποδίδεται ως butt cap αντί για κανονική line join. Για γεμισμένες διαδρομές, η γραμμή κλεισίματος υπονοείται από τον κανόνα γεμίσματος, αλλά το ρητό κλείσιμο εξακολουθεί να παράγει καθαρότερη έξοδο και απαιτείται πριν ξεκινήσετε νέο sub-path με άλλη StartPath

Παράδειγμα

// Draw a closed triangle, stroked
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(100, 100);
PDF.AddLineToPath(200, 100);
PDF.AddLineToPath(150, 180);
PDF.ClosePath;          // line back to (100, 100)
PDF.DrawPath(0);        // 0 = outline only

Δείτε επίσης

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd