ClosePath

Grafika wektorowa, Definiowanie i rysowanie ścieżek

Opis

Zamyka bieżącą podścieżkę ścieżki rozpoczętej przez StartPath. Od bieżącego punktu do punktu początkowego ścieżki rysowana jest linia prosta, dzięki czemu figura tworzy pojedynczy zamknięty kształt zamiast dwóch punktów końcowych połączonych wyłącznie złączeniem obrysu. Wywołanie ClosePath nie maluje ścieżki — następnie wywołaj DrawPath lub DrawPathEvenOdd, aby ją obrysować lub wypełnić.

Składnia

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Wartości zwracane

0	Niepowodzenie — brak otwartego dokumentu albo nie rozpoczęto ścieżki.
1	Bieżąca podścieżka została zamknięta.

Uwagi

Zamknięcie ścieżki jest ważne zawsze, gdy kształt będzie obrysowany: otwarta ścieżka pozostawia widoczną szczelinę między ostatnim i pierwszym punktem, a złączenie obrysu w tym wierzchołku jest renderowane jako płaskie zakończenie zamiast prawidłowego połączenia linii. W przypadku ścieżek wypełnianych linia zamykająca wynika z reguły wypełnienia, ale jawne zamknięcie nadal zapewnia czystszy wynik i jest wymagane przed rozpoczęciem nowej podścieżki przez kolejne wywołanie StartPath.

Przykład

// 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

Zobacz również

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd