CPDF_ARC

Syntaxe

Paramètres

Description

Cette fonction permet d'effectuer le dessinage d'un arc de cercle dans un document de format PDF. Cette fonction est obsolète.

Remarques

• L'extension CLIBPDF initialement proposé à partir du PHP 3 a été progressivement retiré jusqu'à la version 5 du PHP où elle fut remplacé par l'extension PDFLIB, laquelle est utilisé par de nombreux langages de programmations autre que le PHP. Si vous ne pouvez pas installer un extension supplémentaire, vous pouvez utiliser la bibliothèque gratuite et open source entièrement écrit en PHP pure FPDF Library développé par Olivier PLATHEY.
• La fonction cpdf_arc() permet de dessiner un arc de cercle dans un document PDF : Elle prend en compte un centre, un rayon, ainsi que des angles de départ et de fin pour définir la portion du cercle à tracer, ce qui est utile pour créer des éléments graphiques circulaires comme des diagrammes ou des décorations.
• Le système de coordonnées utilisé dépend de l'unité définie pour le document PDF : Il est donc important de bien comprendre le système d'unité du document (point, millimètre,...), surtout si le paramètre $mode est utilisé pour ajuster le comportement de l'unité.
• L'arc n'est pas un objet complet de cercle mais un segment partiel défini par deux angles : Les angles $start et $end sont exprimés en degrés, mesurés dans le sens des aiguilles d'une montre, ce qui peut surprendre ceux habitués aux conventions mathématiques standard (sens trigonométrique).
• L'ajout d'un arc via CLIBPDF ne remplit pas automatiquement l'arc ni ne le ferme : Il s'agit uniquement du tracé du contour de l'arc. Pour remplir ou fermer la forme, des instructions supplémentaires doivent être utilisées après l'appel à cpdf_arc().
• Le paramètre $mode est facultatif mais permet de spécifier l'unité ou le comportement graphique : Il peut être utilisé pour adapter le dessin à différentes résolutions ou types de documents, bien que la documentation autour de ce paramètre soit limitée.
• La fonction est désormais obsolète, tout comme l'extension CLIBPDF qui l'implémentait : Pour les projets modernes, il est fortement recommandé d'utiliser PDFlib, ou des bibliothèques PHP modernes comme FPDF, TCPDF ou mpdf, étant bien maintenues et plus puissantes.
• En utilisant cette fonction, l'arc est simplement ajouté à la "chemin courant" du PDF : Cela signifie qu'il ne sera visible qu'après un appel à une fonction comme cpdf_stroke() pour dessiner les contours, ou cpdf_fill() pour le remplir.
• Cette fonction s'adresse aux développeurs voulant une maîtrise bas-niveau du rendu PDF : À l'inverse des bibliothèques de plus haut niveau (comme FPDF), CLIBPDF permettait un contrôle très granulaire sur les tracés, mais au prix d'une complexité accrue et d'une portabilité limitée.