DESCRIPTION.

La procédure PROC_PLmetadata() place les métadonnées fournies dans l'en-tête du document PDF.

SYNTAXE.

PROC_PLmetadata( titre , auteur , sujet , createur , producteur , date )

REMARQUES.

titre, auteur, sujet, createur, producteur et date doivent être des chaines de caractères, quelconques mais valides.

Note : en général on créditera comme :

- auteur, le rédacteur du contenu ;

- createur, l'application qui a été utilisée pour rédiger le contenu ;

- producteur, le logiciel qui a convertir le document rédactionnel au format pdf.

Les métadonnées d’un fichier, comme dans un PDF, sont des informations sur le fichier lui-même plutôt que sur son contenu visible. Elles servent à identifier, classer et rechercher facilement le document, et permettent aussi de conserver l’historique et l’origine du fichier.

Rappel : L'unité par défaut est le pixel, avec 1 pixel = 0,35278 mm et donc 1 mm égal environ 2,84 pixels. Les dimensions du document créé sont au format standardisé du A4 soit 210 x 297 mm. Pour basculer l'unité de mesure par défaut en millimètre, utilisez la procédure PROC_PLcolour() avec la valeur &00100000 pour style, en troisième paramètre. Dans ce cas les valeurs des ordonnées vont du haut du document (0 mm) au bas du document ( 297 mm), les valeurs des abscisses restent inchangées de gauche (0 mm) à droite (210 mm).

Rappel : la fonction FN_PLcreatepdf() doit être appelée pour placer les modifications sur le document .pdf en cours de création.

La procédure PROC_PLcircle() est importée depuis le module pdflib.bbc. 

EXEMPLE.

INSTALL @lib$ + "pdflib.bbc"

PROC_PLcolour( &ffffff , 2 , &00100000 ) : REM - modifie la couleur et l'épaisseur de la ligne

kchaine$ = "BBC BASIC for SDL 2.0 by R.T. RUSSELL."

PROC_PLfont( "HelveticaB" , 12 , &0000ff ) : REM - indique la police de caractère et sa couleur

PROC_PLprint( 25 , 30 , kchaine$ ) : REM - place la chaine de caractères dans le document

PROC_PLfont( "Helvetica" , 12 , &32cd32 ) : REM - indique la police de caractère et sa couleur

PROC_PLprint( 25 , 40 , "Mon BBC BASIC pas à par par Origine NERD." )

PROC_PLmetadata( "Test" , "Origine NERD" , "Exemple" , "BBC BASIC for SDL 2.0" , "pdflib.bbc" , "08-07-2026" )

kfichier$ = @tmp$ + "test.pdf"

ketat = FN_PLcreatepdf( kfichier$ ) : REM - cree et enregistre le document

IF ketat <> 0 THEN PRINT "Vous pouvez ouvrir " ;  kfichier$ ELSE PRINT "Le document n'a pu etre cree !"

END