DESCRIPTION.

La commande système *MDISPLAY sauvegarde la fenêtre se sortie dans un fichier image au format .bmp.

SYNTAXE.

*MDISPLAY adresse abscisse , ordonnee , longueur , hauteur , alpha

REMARQUES.

adresse doit être une valeur numérique exprimée sous forme hexadécimale. La valeur de adresse être un emplacement de mémoire valide et disponible pour recevoir les données de fichier. adresse pouvant être un nombre de 64 bits, il faudra s'assurer que le mode *HEX 64 a été activé et que adresse a le suffixe %% ou aucun suffixe.

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, du point inférieur gauche de l'image. Si abscisse et ordonnee sont absents, ils recevront les coordonnées du point d'origine. Voir l'instruction ORIGIN pour plus de détails. 

longueur et hauteur indiquent les dimensions de l'image à sauvegarder. Si ils sont absents, la totalité de la fenêtre de sortie sera sauvegardée, sauf si le point d'origine de la fenêtre de sortie a été modifié. Par contre si longueur et/ou hauteur sont présents, une valeur pour abscisse et ordonnee doit être aussi donnés. 

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.

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 la commande systèmes *LOAD pour charger les données d'une image en mémoire.

Voir les commandes système *DISPLAY pour charger et afficher une image dans la fenêtre de sortie.

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

EXEMPLE.

MODE 8

*TYPE /home/user/BBCBasic/monimage.jpg ~TOP

*MDISPLAY ~TOP