DESCRIPTION.

La procédure PROC_PLcolour() permet de définir la couleur des tracés ainsi que l'épaisseur et l'aspect des bordures.

SYNTAXE.

PROC_PLcolour( couleur , epaisseur , style )

REMARQUES.

couleur doit être une valeur numérique définisant la quantité des composants RVB de la couleur qui sera utilsée pour tacer et/ou remplir les graphismes. En général, on l'exprimera sous une forme &RRVVBB où RR, VV et BB auront une valeur hexadécimale allant de 00 à FF.

epaisseur doit être un nombre entier, exprimé en pixels, et indiquant l'épaisseur des bordures.

style doit être un nombre entier, exprimée le plus souvent sous la forme hexadécimale. la valeur de style est une combinaison de valeurs hexadécimales précisant le type d'extrémité des lignes, leur forme de jonction et le choix de l'uité de messure. Les valeurs possible pour style sont : 

- extrémité des lignes :

- &00000000 pour une extrémité des lignes plate ;

- &01000000 pour une extrémité des lignes ronde ;

- &02000000 pour une extrémité des lignes carrée ;

- jonction des lignes :

- &00000000 pour une jonction des lignes pointue ;

- &04000000 pour une jonction des lignes arrondie ;

- &08000000  pour une jonction des lignes biseautée ;

- choix de l'unité :

- &00000000 pour choisir le pixel comme unité de mesure ;

- &10000000 pour choisir l'unité graphique comme unité de mesure ;

- &00100000 pour choisir le millimètres comme unité de mesure ;

L'appel de la procédure PROC_PLcolour() ne concerne que la couleur et l'épaisseur des lignes des graphismes. Pour définir la couleur qui sera utilsée pour les chaines de caractères, il faudra utilser la procédure PROC_PLfont(). Par contre, si style est utiilisé pour modifier l'unité de mesure, cette unité sera prise en compte pour placer les chaines de caractères dans le doculment PDF.

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_PLcolour() est importée depuis le module pdflib.bbc. 

EXEMPLE.

INSTALL @lib$ + "pdflib.bbc"

DIM kcouleurs( 10 ) : kcouleurs() = 0 , &ff0000 ,  &ffff00 , &00ff00 , &00ffff , &0000ff , &ff00ff , 0 , 0 , 0 , 0

FOR kligne = 1 TO 10 

kodonnee =  50 + ( kligne * 10 ) : REM - calcule l'ordonnee de la ligne

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

PROC_PLline( 25 , kodonnee , 170 , kodonnee ) : REM - trace la ligne

NEXT kligne

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