ClosePath

Vektorgrafik, stidefinition og tegning

Beskrivelse

Lukker den aktuelle delsti i den sti, der blev startet med StartPath. Der tegnes en lige linje fra det aktuelle punkt tilbage til stiens startpunkt, så figuren bliver én lukket form i stedet for to endepunkter, der kun forbindes af en stregsamling. Kald af ClosePath maler ikke stien — kald efterfølgende DrawPath eller DrawPathEvenOdd for at tegne og/eller udfylde den

Syntaks

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Returværdier

0Mislykkedes — intet dokument er åbent, eller ingen sti er startet.
1Den aktuelle delsti er blevet lukket.

Bemærkninger

Det er vigtigt at lukke stien, når figuren skal stregtegnes: En åben sti efterlader et synligt mellemrum mellem det sidste og det første punkt, og stregsammenføjningen ved dette toppunkt gengives som en flad endehætte i stedet for en korrekt linjesammenføjning. For udfyldte stier medfører udfyldningsreglen den lukkende linje, men udtrykkelig lukning giver stadig renere output og er påkrævet, før en ny delsti startes med endnu et StartPath

Eksempel

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

Se også

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd