DESCRIPTION.

La commande système *DISPLAY charge un fichier image et l'affiche dans la fenêtre de sortie.

SYNTAXE.

*DISPLAY fichier abscisse , ordonnee , longueur , hauteur , alpha

REMARQUES.

fichier doit être un nom de fichier existant, exprimé de façon absolue ou relative et au standard : .bmp, .gif, .jpg, .png ou .tga. Si aucune extension n'est précisée, c'est le format .bmp qui sera recherché par défaut.

abscisse , ordonnee , longueur , hauteur doivent être des nombres entiers, et sont exprimés en points graphiques.

abscisse et ordonnee indiquent les coordonnées, dans la fenêtre de sortie, où sera placé le coin inférieur gauche de l'image. Si abscisse et ordonnee sont absents, l'image sera positionnée dans le coin inférieur gauche de la fenêtre de sortie. Si longueur et/ou hauteur sont présentent, une valeur pour abscisse et ordonnee doit être aussi données. 

longueur et hauteur indiquent les dimensions de l'image. Si ils sont différents de la taille de l'image chargée, celle-ci sera redimensionnée. Cela pourra détériorer l'aspect de l'image affichée. Si longueur et hauteur sont absents l'image sera addichée avec ses dimensions d'origine. Par contre si longueur et/ou hauteur sont présents, une valeur pour abscisse et ordonnee doit être aussi donnée. 

Si longueur et/ou hauteur sont exprimées avec des valeurs négatives , l’image sera inversée horizontalement et/ou verticalement, mais les coordonnées du point d'origine ne seront pas modifiées. Si alpha est présent, cette option ne pourra pas être activée.

alpha doivent être un valeur hexadécimale, exprimant une couleur. Cette couleur sera utilisée comme canal alpha, transparente, pour l'image affichée. Si alpha est absent, l'image n'aura aucune couleur transparente. Si alpha est donnée abscisse,  ordonnee,  longueur et hauteur doivent aussi être présents. La couleur principale doit être spécifiée dans le format interne du fichier BMP. Ainsi, pour un fichier RGB 24 bits par pixel, indiquez une valeur hexadécimale à six chiffres au format rrggbb (par exemple, 1000000 pour le noir ). Si le fichier utilise un format de pixel différent, spécifiez-le dans sa représentation. Dans le cas particulier d'un fichier 16 bits par pixel, choisissez une couleur principale avec des valeurs RGB faibles, par exemple R=1, V=1, B=1, ce qui correspond à la valeur hexadécimale 0421 dans un fichier RGB555.

Si le programme prévoit que l'utilisateur puisse choisir le fichier image à charger, on pourra utiliser l'instruction OSCLI qui permet de transmettre une chaine de caractères en tant que commande au système d'exploitation (OS) de la machine hote. Voir l'instruction OSCLI pour plus de détails.

INPUT "Indiquez le fichier image " ; kfichier$

OSCLI "DISPLAY """ +  kfichier$ + """"

Note : pour sauvegarder temporairement la fenêtre de sortie dans le presse-papier, il faut utiliser simultanément la combinaison de touches :  Alt et Impr-écran.

Voir les commandes système *MDISPLAY pour afficher une image présente en mémoire.

Voir la commande système *SCREENSAVE pour sauvegarder la fenêtre de sortie dans un fichier image.

EXEMPLE.

MODE 8

CIRCLE FILL 639 , 511 , 100

*SCREENSAVE "MaFenetre.bmp"

PRINT TAB( 5 , 7 ) ; "Fenetre sauvegardee !"

WAIT( 100 )

CLS

PRINT TAB( 5 , 7 ) ; "Faisons une petite pause ..."

WAIT( 200 )

*DISPLAY "MaFenetre.bmp"

END