DESCRIPTION.

Le module pdflib.bbc propose des procédures et des fonctions permettant de créer des document au format .pdf (Portable Document Format).

SYNTAXE.

INSTALL @lib$ + "pdflib.bbc"

REMARQUES.

La module pdflib.bbc permet de créer un fichier PDF pour BBC BASIC for SDL 2.0, et pour des feuilles aux dimensions A4, c'est-à-dire 210 x 297 mm. La module pdflib.bbc prend en charge du texte Unicode (police incorporée requise).

Le module pdflib.bbc peut être utilisé avec la distribution BBC BASIC for Windows, avec les limitations suivantes :  la procédure PROC_PLhardcopy() ne fonctionne pas et seules les polices standard Times, Courier, Helvetica, Symbol et ZapfDingbats peuvent être utilisées.

Les alias ​​à utiliser dans la procédure PROC_PLfont() sont :

- Times, TimesB, TimesI, TimesBI ; 

- Helvetica, HelveticaB, HelveticaO, HelveticaBO ; 

- Courier, CourierB, CourierO, CourierBO ; 

- Symbol , Zap ;

 - ou le chemin d’accès à un fichier ttf pour Unicode, avec un maximum quatre polices de ce type.

Les noms PostScript des 14 polices de type 1, connues sous le nom de polices standard, sont les suivants : 

- Times-Roman, Times-Bold, Times-Italic, Times-BoldItalic ; 

- Helvetica, Helvetica-Bold, Helvetica-Oblique, Helvetica-BoldOblique ; 

- Courier, Courier-Bold, Courier-Oblique, Courier-BoldOblique ; 

- Symbol, ZapfDingbats.

Le mode graphique par défaut est le pixel,  avec 1 pixel = 0,35278 mm et donc 1 mm égal environ 2,84 pixels, et le point d'origine (abscisse = 0 et ordonnée = 0) est situé à gauche et en bas de la feuille, ce qui signifie que les abscisses augmentent en allant vers la droite de la feuille, et que les ordonnées augmentent en allant vers le haut de la feuille.

Note : pour basculer l'unité de mesure en millimètre, utilisez la procédure PROC_PLcolour() avec la valeur &00100000 pour style, en troisième paramètre. Dans ce cas la valeur des ordonnées vont du haut (0 mm) au bas (297 mm) du document, les valeurs des abscisses restent inchangées de gauche (0 mm) à droite (210 mm).

Important : les auteurs de ce module : Svein Svensson et Richard Russell, précisent que ce logiciel est fourni en l'état, sans aucune garantie expresse ou implicite. En aucun cas, les auteurs ne pourront être tenus responsables des dommages résultant de l'utilisation de ce logiciel. L'autorisation est accordée à quiconque d'utiliser ce logiciel à quelque fin que ce soit, y compris pour des applications commerciales, de le modifier et de le redistribuer librement, mais sous réserve des restrictions suivantes :

1. L'origine de ce logiciel ne doit pas être déformée ; vous ne devez pas prétendre avoir écrit le logiciel original.

Si vous utilisez ce logiciel dans un produit, une mention dans la documentation du produit serait appréciée,

mais n'est pas obligatoire.

2. Les versions modifiées du code source doivent être clairement identifiées comme telles

et ne doivent pas être présentées comme étant le logiciel original.

3. Cet avis ne doit pas être supprimé ni modifié dans la distribution du code source.

Le module doit être chargé depuis votre programme à l'aide de l'instruction : INSTALL @lib$ + "pdflib.bbc"

LISTE DES PROCEDURES DU MODULE.

FN_PLcreatepdf() : créé et sauvegarde le document PDF.

PROC_PLbezier() : trace une courbe de Bézier, vide ou remplie, sur le document PDF.

PROC_PLcircle() : dessine un cercle, vide ou rempli, sur le document PDF.

PROC_PLcolour() : définit la couleur et le style des bordures des graphisme.

PROC_PLellipse() : dessine une ellipse, vide ou remplie, sur le document PDF.

PROC_PLfont() : définit la police de caractère, sa taille et sa couleur pour les chaines de caractères.

PROC_PLline() : trace une ligne droite sur le document PDF.

PROC_PLmetadata() : place les métadonnées dans l'en-tête du fichier PDF.

PROC_PLpolybezier() : trace un ensemble de courbe, vide ou rempli, sur le document PDF.

PROC_PLpolyline() : trace une figure géométrique quelconque, vide ou rempli, sur le document PDF.

PROC_PLprint() : place une chaine de caractères sur le document PDF.

PROC_PLrectangle() : dessine un rectangle, vide ou rempli, sur le document PDF.

PROC_PLsector() : trace un secteur d'un cercle, vide ou rempli, sur le document PDF.