AddArcToPath

Vektorgrafika, útvonalmeghatározás és rajzolás

Leírás

Körívet ad az aktuális útvonalhoz. Az ív a (CenterX, CenterY) középpont körül rajzolódik; sugara megegyezik a középpont és az útvonal aktuális pontja közötti távolsággal, és TotalAngle fokon ível át. A hívás utáni aktuális pont az ív végpontja, ezért a későbbi AddLineToPath vagy AddArcToPath hívások innen folytatódnak

Szintaxis

Delphi

Function TPDFlib.AddArcToPath(CenterX, CenterY, TotalAngle: Double): Integer;

ActiveX

Function PDFlib::AddArcToPath(CenterX As Double, CenterY As Double, TotalAngle As Double) As Long

DLL

int DLAddArcToPath(int InstanceID, double CenterX, double CenterY, double TotalAngle);

Paraméterek

CenterX	Az ív középpontjának vízszintes koordinátája
CenterY	Az ív középpontjának függőleges koordinátája
TotalAngle	A szögsöprés fokban. A pozitív értékek az óramutató járásával megegyező, a negatív értékek azzal ellentétes irányúak. Az értéknek nem nullának kell lennie. A `360` (vagy `-360`) teljes kört rajzol

Visszatérési értékek

0	Sikertelen — nincs megnyitott dokumentum, nem indult útvonal, vagy a TotalAngle nulla
1	Az ív hozzá lett adva az aktuális útvonalhoz

Megjegyzések

A sugár hallgatólagosan az aktuális pont (a legutóbbi StartPath, AddLineToPath, AddCurveToPath vagy előző AddArcToPath által beállítva) és az e hívásnak átadott középpont közötti távolságból származik. Teljes kör rajzolásához hívja a StartPath függvényt a kör kerületének bármely pontjával, majd az AddArcToPath függvényt a kívánt középponttal és 360 fokos ívvel

Az ív köbös Bézier-szakaszok láncaként jelenik meg, a szokásos PDF-oldalméreteknél képpont alatti tűréshatáron belüli pontossággal

Példa

// A pie slice — straight edge, arc, straight edge back to centre
PDF.SetFillColor(0.7, 0.2, 0.2);

PDF.StartPath(200, 200);               // pie centre
PDF.AddLineToPath(280, 200);           // out to circle (radius 80, angle 0°)
PDF.AddArcToPath(200, 200, 90);        // sweep 90° clockwise
PDF.ClosePath;                         // back to the centre
PDF.DrawPath(2);                       // 2 = fill and outline

// A complete circle drawn as a single arc
PDF.StartPath(300, 100);
PDF.AddArcToPath(250, 100, 360);
PDF.ClosePath;
PDF.DrawPath(0);

Lásd még

StartPath, AddLineToPath, AddCurveToPath, AddBoxToPath, DrawPath, DrawPathEvenOdd