CPDF_FILL_STROKE

Syntaxe

Paramètres

Description

Cette fonction permet de remplir le tracé courant et sa bordure 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 remplir le tracé courant et de dessiner sa bordure dans un document PDF. Cela permet de créer des formes complètes et visuellement distinctes, combinant à la fois l'intérieur rempli et le contour tracé selon la couleur et le style actifs.
• Le paramètre $pdf_document est obligatoire puisqu'il identifie le document PDF sur lequel le tracé doit être rendu. Sans ce paramètre, la fonction ne saurait pas où appliquer le remplissage et le contour, rendant l'appel inutile.
• Cette fonction agit sur le tracé courant, défini au préalable avec des fonctions telles que cpdf_moveto, cpdf_lineto, cpdf_curve ou cpdf_circle. Il est donc crucial que le tracé soit correctement configuré avant l'appel à cpdf_fill_stroke.
• cpdf_fill_stroke combine deux opérations souvent effectuées séparément : le remplissage de l'intérieur et le dessin du contour. Cela simplifie le code par rapport à l'usage combiné de cpdf_fill suivi de cpdf_stroke pour obtenir le même effet.
• Comme la fonction est obsolète, son utilisation peut rendre le code difficile à maintenir et incompatible avec PHP moderne. Les bibliothèques modernes comme TCPDF ou FPDF proposent des méthodes équivalentes avec des options avancées pour gérer la couleur, la transparence et le style de contour.
• Cette fonction illustre la philosophie des anciennes bibliothèques PDF, où le contrôle était très bas-niveau : le développeur devait gérer manuellement le tracé, le remplissage et le contour pour obtenir le rendu attendu, ce qui demande une bonne compréhension des coordonnées et du flux PDF.
• Ne pas utiliser cpdf_fill_stroke après avoir défini un tracé peut entraîner des formes incomplètes ou mal rendues, car ni le remplissage ni le contour ne seront appliqués. Cela souligne l'importance de respecter l'ordre exact des opérations dans CLIBPDF pour garantir un rendu correct et conforme aux attentes graphiques.