CPDF_CLOSEPATH_STROKE

Syntaxe

Paramètres

Description

Cette fonction permet de fermer le tracé 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.
• Son rôle principal est de fermer un tracé graphique dans un document PDF et de le dessiner avec le contour actuel. Contrairement à cpdf_closepath_fill_stroke, cette fonction ne remplit pas l'intérieur de la forme, elle se limite uniquement au contour.
• Le paramètre $pdf_document est obligatoire car il identifie le document PDF sur lequel le tracé doit être fermé et dessiné. Sans ce paramètre, la fonction ne peut pas savoir sur quel fichier agir, rendant l'appel inutile ou erroné.
• Cette fonction agit sur le tracé courant, c'est-à-dire les lignes et courbes définies précédemment avec des fonctions telles que cpdf_moveto, cpdf_lineto ou cpdf_curve. Il est donc important d'avoir correctement défini ce tracé avant l'appel pour obtenir la forme souhaitée.
• cpdf_closepath_stroke simplifie le processus en combinant la fermeture du tracé et le dessin du contour en une seule opération. Sans cette fonction, le développeur devrait fermer le tracé manuellement puis appeler une fonction séparée pour dessiner le contour.
• Comme la fonction est obsolète, son utilisation peut rendre le code difficile à maintenir et limiter sa compatibilité avec les versions récentes de PHP. Les bibliothèques modernes telles que TCPDF ou FPDF offrent des méthodes équivalentes, plus robustes et avec des options supplémentaires pour le style des contours.
• Cette fonction illustre la philosophie des anciennes bibliothèques PDF, qui fournissaient un contrôle bas-niveau sur le rendu graphique. Le développeur devait gérer lui-même la création du tracé, sa fermeture et son rendu, ce qui exigeait une bonne compréhension des coordonnées et du flux PDF.
• Omettre d'utiliser cpdf_closepath_stroke après avoir défini un tracé peut entraîner un tracé incomplet ou non dessiné, car le contour ne sera pas appliqué et le chemin restera ouvert. Cela souligne l'importance de respecter l'ordre exact des appels dans CLIBPDF pour produire un rendu correct.