AddArcToPath

Grafis vektor, Definisi dan penggambaran path

Deskripsi

Menambahkan arc lingkaran ke path saat ini. Arc digambar di sekitar titik pusat (CenterX, CenterY); radiusnya setara jarak dari pusat ke titik saat ini di path, dan ia menyapu sebesar TotalAngle derajat. Titik saat ini setelah panggilan adalah titik akhir arc, sehingga panggilan AddLineToPath atau AddArcToPath berikutnya melanjutkan dari sana

Sintaks

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);

Parameter

CenterX	Koordinat horizontal pusat arc
CenterY	Koordinat vertikal pusat arc
TotalAngle	Sapuan sudut dalam derajat. Nilai positif menyapu searah jarum jam; nilai negatif berlawanan arah jarum jam. Nilainya harus bukan nol. `360` (atau `-360`) menggambar lingkaran penuh

Nilai kembalian

0	Gagal — tidak ada dokumen terbuka, belum ada path yang dimulai, atau TotalAngle bernilai nol
1	Arc ditambahkan ke path saat ini

Catatan

Radius diturunkan secara implisit dari jarak antara titik saat ini (diset oleh StartPath, AddLineToPath, AddCurveToPath, atau AddArcToPath sebelumnya) dan pusat yang diberikan ke panggilan ini. Untuk menggambar lingkaran penuh, StartPath ke titik mana pun di keliling lingkaran lalu panggil AddArcToPath dengan pusat yang diinginkan dan sapuan 360

The arc is rendered as a chain of cubic Bézier segments, accurate to within sub-pixel tolerance for typical PDF page sizes.

Contoh

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

Lihat juga

StartPath, AddLineToPath, AddCurveToPath, AddBoxToPath, DrawPath, DrawPathEvenOdd