CPDF_FILL

Syntaxe

Paramètres

Description

Cette fonction permet de remplir le tracé courant 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.
• Le rôle principal de cette fonction est de remplir le tracé courant avec la couleur de remplissage définie. Cela permet de créer des formes pleines, par exemple des rectangles, cercles ou polygones, à partir d'un tracé préalablement défini.
• Le paramètre $pdf_document est obligatoire car il identifie le document PDF dans lequel le tracé doit être rempli. Sans ce paramètre, la fonction ne sait pas où appliquer l'opération de remplissage, rendant l'appel inutile ou erroné.
• Cette fonction agit uniquement sur le tracé courant, défini par des fonctions précédentes comme cpdf_moveto, cpdf_lineto, cpdf_curve ou cpdf_circle. Il est donc important que le tracé soit correctement défini avant l'appel à cpdf_fill.
• cpdf_fill ne trace pas le contour du tracé : elle se contente de remplir l'intérieur avec la couleur active. Pour obtenir à la fois le contour et le remplissage, il faut utiliser des fonctions combinées comme cpdf_closepath_fill_stroke.
• 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 offrent des méthodes plus intuitives et plus puissantes pour remplir des tracés avec options de couleur, transparence et motifs.
• Cette fonction illustre la philosophie des anciennes bibliothèques PDF, où le développeur devait gérer manuellement chaque tracé et son remplissage. Cela exigeait une bonne compréhension des coordonnées et de la logique de construction des formes dans le flux PDF.
• Ne pas appeler cpdf_fill après avoir défini un tracé peut entraîner des formes non remplies dans le document PDF. Cela souligne l'importance de respecter l'ordre exact des opérations dans CLIBPDF pour produire un rendu graphique correct et conforme aux attentes.