AddArcToPath

Graphiques vectoriels, définition et dessin des tracés

Description

Ajoute un arc de cercle au chemin actuel. Il est tracé autour de (CenterX, CenterY) avec un rayon égal à la distance entre le centre et le point courant, sur TotalAngle degrés. Le point courant devient l’extrémité de l’arc, et les appels suivants à AddLineToPath ou AddArcToPath continuent depuis là

Syntaxe

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ètres

CenterX	Coordonnée horizontale du centre de l’arc
CenterY	Coordonnée verticale du centre de l’arc
TotalAngle	Balayage angulaire en degrés. Les valeurs positives vont dans le sens horaire, les négatives dans le sens antihoraire. Doit être non nul ; `360` ou `-360` dessine un cercle complet

Valeurs de retour

0	Échec — aucun document n'est ouvert, aucun chemin n'a été démarré ou TotalAngle vaut zéro
1	L’arc a été ajouté au chemin actuel

Remarques

Le rayon est déduit implicitement de la distance entre le point courant (défini par le plus récent StartPath, AddLineToPath, AddCurveToPath ou précédent AddArcToPath) et le centre transmis à cet appel. Pour tracer un cercle complet, appelez StartPath sur un point quelconque de la circonférence, puis AddArcToPath avec le centre voulu et un balayage de 360

L'arc est rendu sous forme d'une chaîne de segments de Bézier cubiques, avec une précision inférieure au pixel pour les tailles de page PDF habituelles

Exemple

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

Voir aussi

StartPath, AddLineToPath, AddCurveToPath, AddBoxToPath, DrawPath, DrawPathEvenOdd