CPDF_CLOSEPATH_FILL_STROKE

Syntaxe

Paramètres

Description

Cette fonction permet de fermer et remplir l'intérieur d'un tracé en cours avec la couleur de remplissage actuel et enfin le dessine 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, de remplir son intérieur avec la couleur de remplissage actuelle et d'appliquer le contour. Cela permet de dessiner des formes complètes comme des polygones ou des chemins fermés avec un style visuel défini par l'utilisateur.
• Le paramètre $pdf_document est indispensable puisqu'il identifie le document PDF sur lequel le tracé doit être appliqué. Sans ce paramètre, la fonction ne saurait pas où exécuter les opérations de fermeture, de remplissage et de dessin.
• Cette fonction agit sur le tracé courant, c'est-à-dire sur les lignes et courbes définies par les fonctions précédentes comme cpdf_moveto, cpdf_lineto ou cpdf_curve. Il est donc crucial d'avoir défini correctement ce tracé avant d'appeler cpdf_closepath_fill_stroke, sinon la forme finale sera incorrecte ou vide.
• L'effet combiné de cette fonction est similaire à celui d'une balise graphique qui ferme, remplit et trace le contour en une seule opération. Cela simplifie la génération de formes complexes par rapport à des appels séparés pour le remplissage et le contour.
• Comme la fonction est obsolète, son utilisation peut rendre le code difficile à maintenir ou incompatible avec PHP moderne. Les bibliothèques modernes comme TCPDF ou FPDF offrent des méthodes équivalentes avec des options plus étendues, notamment la gestion des couleurs, de la transparence et des motifs de remplissage.
• La fonction illustre bien la philosophie des anciennes bibliothèques PDF : elles fournissaient un contrôle très bas-niveau sur le rendu graphique, obligeant le développeur à gérer manuellement le tracé, la fermeture, le remplissage et le contour pour chaque forme.
• Omettre d'appeler cpdf_closepath_fill_stroke après avoir défini un tracé peut conduire à des formes incomplètes ou non remplies, car la fermeture du chemin et le remplissage ne seront pas appliqués. Cela souligne l'importance de respecter l'ordre exact des opérations lors de la génération de PDF avec CLIBPDF.