Cross Stitch Pattern Generator - Part 4 - Understanding pyfPDF Sorry for missing so many months. I still can’t sit for long periods of time, so this article might be shorter than what you are used to. My original plan was to jump right into the PDF output portion of the program, but there is so much to understand about this library, I decided to use this installment as a tutorial on pyfPDF and then tackle the PDF output next time. So let’s get started. FPDF stands for Free PDF. A VERY minimal example would be as follows: from fpdf import FPDF pdf = FPDF() pdf.add_page() pdf.set_font(‘Arial’,’B’,16) pdf.cell(40,10,’Hello From Python’) pdf.output(‘example1.pdf’,’F’)

Générateur de modèle de point de croix - Partie 4 - Comprendre pyfPDF

Désolé d'avoir manqué tant de mois. Je ne peux toujours pas rester assis pendant trop longtemps, du coup cet article est plus court que d'habitude. Mon plan initial était de passer directement à la partie du programme qui crée le PDF, mais il y a tellement de choses à comprendre dans cette bibliothèque que j'ai décidé d'utiliser cet épisode comme un tutoriel sur pyfPDF et attaquer la sortie PDF la prochaine fois. Bon, commençons.

FPDF signifie PDF gratuit. Voici un exemple très minimaliste :

from fpdf import FPDF

pdf = FPDF()

pdf.add_page()

pdf.set_font(‘Arial’,’B’,16)

pdf.cell(40,10,’Bonjour de Python’)

pdf.output(‘exemple1.pdf’,’F’)

The first line imports the library file. The next creates an instance of the FPDF object. We use the default values for this example, which are: • Portrait • Measure Unit = Millimeters. • Format = A4 If you need to use ‘US’ standards, you could do it this way: pdf=FPDF(‘P’,’in’,’Letter)

La première ligne importe la bibliothèque. La suivante crée une instance de l'objet FPDF. Nous utilisons pour cet exemple les valeurs par défaut, qui sont : • Portrait • Unité de mesure = millimètres • Format = A4

Si vous avez besoin d'utiliser les normes « US », vous pouvez le faire de cette façon :

pdf=FPDF(‘P’,’in’,’Letter’)

Notice the parameters are FPDF(orientation, units, format): • Possible values for orientation are “P” for Portrait and “L” for Landscape. • Possible values for units are: ‘pt’ (poiints), ‘mm’ (millimeter), ‘cm’ (centimeter), ‘in’ (inches). • Possible values for format are: ‘A3’, ‘A4’, ‘A5’, ‘Letter’, ‘Legal’ or a tuple containing the width and height expressed in the unit given in the unit parameter. The third line creates a page to enter data into. Notice a page is not automatically created when we create the instance of the object. The origin of the page is the upper-left corner, and the current position defaults to 1 cm from the margin. The margin can be changed with the SetMargins function.

Notez que les paramètres sont FPDF (orientation, unités, format) : • Les valeurs possibles pour l'orientation sont « P » pour portrait et « L » pour paysage (« landscape »). • Les valeurs possibles pour les unités sont : 'pt' (points), 'mm' (millimètre), ‘cm’ (centimètre), 'in' (pouces). • Les valeurs possibles pour le format sont : ‘A3’, ‘A4’, ‘A5’, ‘Letter’, ‘Legal’ ou un tuple contenant la largeur et la hauteur exprimées dans l'unité donnée dans le paramètre précédent.

La troisième ligne crée une page pour écrire des données. Remarquez qu'une page n'est pas automatiquement créée lorsque nous créons l'instance de l'objet. L'origine de la page est le coin supérieur gauche et la position de départ se situe par défaut à 1 cm des marges. Les marges peuvent être modifiées avec la fonction SetMargins.

Before you can actually print any text, you must call pdf.set_font() to define a font. In the line above, we are defining Arial Bold 16 point. Standard valid fonts are Arial, Times, Courier, Symbol and ZapfDingbats. Now we can print a cell with the pdf.cell() call. A cell is a rectangular area, possibly framed, which contains some text. Output is at the current position which is specified (40,10 cm) in the above example. The parameters are: pdf.cell(Width, Height, text, border, line, align, fill, link)

Avant de pouvoir afficher du texte, vous devez appeler pdf.set_font() pour définir une police. Dans la ligne ci-dessus, nous définissons Arial Bold 16 points. Les polices standards valides sont Arial, Times, Courier, Symbol et ZapfDingbats.

Maintenant, nous pouvons imprimer une cellule en appelant pdf.cell(). Une cellule est une zone rectangulaire, éventuellement encadrée, qui contient du texte. L'affichage se fait à la position qui est spécifiée (40,10 cm dans l'exemple ci-dessus). Les paramètres sont :

pdf.cell(largeur, hauteur, texte, bordure, ligne, alignement, remplissage, lien)

Where: • Width is length of cell. If 0, width extends to the right margin. • Height is the height of the cell. • Text is the string of text you want to print. • Border is either 0 (no border(default)), 1 is border, or a string of any or all of the following characters: “L”,“T”,“B”,“R” • Line is where the current position should go after printing the text. Values are 0 (to the right), 1 (to the beginning of the next line, 2 (below). Default is 0, and putting 1 is equivalent to putting 0 and calling ln() immediatly after. • Align allows to center or align the text within the cell. Values are “L” (left), “C” (center), “R” (right). • Fill sets the background to be painted (true) or transparent (false). Default is false. • Link is a url or identifier returned by addlink().

où : • largeur est la largeur de la cellule. Si égale à 0, la largeur va jusqu'à la marge de droite ; • hauteur est la hauteur de la cellule ; • texte est la chaîne de texte que vous souhaitez afficher ; • bordure est soit 0 (pas de bordure, par défaut), 1 pour une bordure, ou une chaîne de tout ou partie des caractères suivants: « L», « T », « B », « R » ; • ligne indique la position à laquelle on doit aller après l'affichage du texte. Les valeurs sont 0 (vers la droite), 1 (au début de la ligne suivante), 2 (en-dessous). Par défaut c'est 0, et indiquer 1 revient à mettre 0 et appeler ln() immédiatement après ; • alignement permet de centrer ou aligner le texte dans la cellule. Les valeurs sont « L » (gauche), « C » (centre), « R » (droite) ; • remplissage définit si le fond est rempli (true) ou transparent (false). Par défaut c'est false. • Lien est une url ou un identifiant retourné par addlink().

Finally, the document is closed and sent to the file with Output. The parameters are fpdf.output(name,dest). If file is not specified, the output will be sent to the browser. Options for destination are “I” (inline to browser(default)), “F” (local file given by name), “D” (to the browser and force a file download with the name passed), and “S” (return the document as a string). Since we will be sending our cross stitch images to the pdf file, we will have to understand the image function. The function is called like this: pdf.image(name,x=None,y=None,w=0,h=0,type=“”,link=“”)

Enfin, le document est fermé et envoyé au fichier avec Output. Les paramètres sont fpdf.output(nom, destination). Si aucun fichier n'est spécifié, la sortie sera envoyé au navigateur. Les options pour la destination sont « I » (en ligne dans le navigateur, par défaut), « F » (fichier local donné par nom), « D » (envoi au navigateur en forçant un téléchargement de fichier avec le nom passé) et « S » (retourne le document sous forme de chaîne).

Puisque nous allons envoyer nos images de point de croix dans le fichier pdf, nous devrons comprendre la fonction image.

Cette fonction est appelée comme ceci :

pdf.image(nom,x=None,y=None,w=0,h=0,type=“”,link=“”)

This function puts the image. The size it will take on the page can be specified in different ways: • Explicit width and height or • One explicit dimension Supported formats are JPEG, PNG, and GIF. If you wish to use GIF files, you must get the GD extension. For JPEGs, all flavors are allowed: • gray scale • true colours (24 bits) • CMYK (32 bits)

Cette fonction place une image. La taille qu'elle occupera sur la page peut être spécifiée de différentes manières : • la largeur et la hauteur explicite ou • une dimension explicite.

Les formats supportés sont JPEG, PNG et GIF. Si vous souhaitez utiliser des fichiers GIF, vous devez installer l'extension GD.

Pour les fichiers JPEG, tous les types sont autorisés : • échelle de gris ; • couleurs vraies (24 bits) ; • CMYK (32 bits).

For PNGs, the following are allowed: • gray scales on at most 8 bits (256 levels) • indexed colors • true colors (24 bits) Note: interlacing is not allowed, and if you are using a version of FPDF prior to 1.7, Alpha channel is not supported. I stole this example (shown right) from the pyFPDF tutorial.

Pour PNG, les types suivants sont acceptés : • niveaux de gris sur au plus 8 bits (256 niveaux) ; • couleurs indexées ; • couleurs vraies (24 bits).

Remarque : l'entrelacement n'est pas permis et, si vous utilisez une version de FPDF antérieure à la 1.7, le canal alpha n'est pas supporté.

J'ai volé cet exemple (à droite) dans le tutoriel de pyFPDF.

You have been around long enough that you should be able to look at the program and understand what is going on. But in this example the line we are REALLY interested in is the fourth line: this.image('img1.png',10,8,33) In this instance, we are calling the image function with the filename, the x position of where the picture will go on the page, the y position, and the width of the picture. Now that you have a gross grasp of the library, we will start our PDF code next time. Until then, have a good month. See you soon.

Vous avez vu assez de choses pour être en mesure d'examiner le programme et comprendre ce qui se passe. Mais dans cet exemple la ligne qui nous intéresse VRAIMENT est la quatrième :

this.image('img1.png',10,8,33)

Dans ce cas, nous appelons la fonction image avec le nom du fichier, la position x de l'endroit où sera l'image sur la page, la position y et la largeur de l'image.

Maintenant que vous avez une connaissance grossière de la bibliothèque, nous pourrons commencer notre code PDF la prochaine fois.

Jusque-là, passez un bon mois. À bientôt.

from fpdf import FPDF class PDF(FPDF):

  def header(this):
      # Logo - remplacer par un petit PNG de votre choix
      this.image('img1.png',10,8,33)
      # Arial bold 15
      this.set_font('Arial','B',15)
      # se deplacer vers la droite
      this.cell(80)
      # titre
      this.cell(30,10,'Titre',1,0,'C')
      # saut de ligne
      this.ln(20)
      # instanciation de la classe

pdf=PDF() pdf.alias_nb_pages() pdf.add_page() pdf.set_font('Times','',12) for i in range(1,41):

  pdf.cell(0,10,'Affichage du numero de ligne '+str(i),0,1)

pdf.output('example2.pdf','F')