Différences

Ci-dessous, les différences entre deux révisions de la page.

--- issue91:python [2015/01/07 20:22] – [3] fredphil91
+++ issue91:python [2015/02/25 10:01] (Version actuelle) – [9] auntiee
@@ Ligne 21: / Ligne 21: @@
 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. Donc, nous allons commencer.
+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 :
@@ Ligne 53: / Ligne 53: @@
 • Format = A4
-Si vous avez besoin d'utiliser les normes « US», vous pouvez le faire de cette façon :
+Si vous avez besoin d'utiliser les normes « US », vous pouvez le faire de cette façon :
 pdf=FPDF(‘P’,’in’,’Letter’)
@@ Ligne 66: / Ligne 66: @@
 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) :
+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 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 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.
+• 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.
+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.
 ====== 4 ======
-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.
+**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)
+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)
 ====== 5 ======
-Where:
+**Where:
 • Width is length of cell. If 0, width extends to the right margin.
 • Height is the height of the cell.
@@ Ligne 91: / Ligne 97: @@
 • 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().
+• 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().
 ====== 6 ======
-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).
+**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.
@@ Ligne 101: / Ligne 117: @@
 The function is called like this:
-pdf.image(name,x=None,y=None,w=0,h=0,type="",link="")
+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="")
 ====== 7 ======
-This function puts the image. The size it will take on the page can be specified in different ways:
+**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
@@ Ligne 114: / Ligne 138: @@
 • gray scale
 • true colours (24 bits)
-• CMYK (32 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).
 ====== 8 ======
-For PNGs, the following are allowed:
+**For PNGs, the following are allowed:
 • gray scales on at most 8 bits (256 levels)
 • indexed colors
@@ Ligne 125: / Ligne 160: @@
 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.
+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.
 ====== 9 ======
-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:
+**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)
@@ Ligne 137: / Ligne 181: @@
 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.
+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.
+====== Cadre orangé page 12 ======
+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')