bitmap - commande interne Tk
- NAME
- bitmap - Images affichant deux couleurs
- SYNOPSIS
- image create bitmap ?nom? ?options?
- DESCRIPTION
- CREER UN BITMAP
- -background couleur
- -data chaîne de caractères
- -file nom
- -foreground couleur
- -maskdata chaîne de caractères
- -maskfile nom
- COMMANDES ASSOCIEES A UNE IMAGE
- nom_de_l'image cget option
- nom_de_l'image configure ?option? ?valeur option valeur ...?
- MOTS CLES
bitmap - Image affichant deux couleurs
image create bitmap ?nom? ?options?
Un bitmap est une image dont les pixels ne peuvent prendre que deux
couleurs ou être transparents.
Une image Bitmap est définie par quatre choses : la couleur
du fond, la couleur du premier plan, et deux bitmaps appelés
la source et le masque.
A chaque bitmap est associé un tableau rectangulaire composé de 0 et de 1,
les deux bitmaps doivent avoir les mêmes dimensions.
Pour les pixels dont la valeur de masque est nulle, l'image
n'affiche rien du tout, produisant ainsi un effet de transparence.
Pour les autres pixels, l'image affiche la couleur du premier plan
si la valeur du pixel du bitmap source correspondant est 1. Si cette
valeur est nulle, la couleur du fond est affichée.
Comme toutes les images, les bitmaps sont créés en utilisant la commande
image create.
Les options suivantes, sont acceptées :
- -background couleur
-
Spécifie la couleur du fond de l'image. La couleur peut être
indiquée dans n'importe laquelle des notations acceptées par Tk.
Si la valeur est une chaine vide alors les pixels du fond seront
transparents. Dans ce cas les valeurs de -maskdata et
-maskfile sont ignorées.
- -data chaîne de caractères
-
Spécifie le contenu d'une source bitmap par une chaîne de caractères.
Le format de la chaîne est le format défini par la norme bitmap X11 (i.e., tel qu'il est
généré par le programme bitmap).
Si les deux options -data et -file sont spécifiées,
l'option -data a la priorité.
- -file nom
-
La valeur nom est le nom d'un fichier définissant la source
du bitmap. Le format de ce fichier est le format défini par la norme bitmap X11 (i.e., tel
qu'il est généré par le program bitmap)
- -foreground couleur
-
Définit la valeur du fond de l'image. La couleur peut être
indiquée dans n'importe laquelle des notations acceptées par Tk.
- -maskdata chaîne de caractères
-
Spécifie le contenu d'un masque par une chaîne de caractères.
Le format de la chaîne est le format défini par la norme bitmap X11 (i.e., tel qu'il est
généré par le programme bitmap).
Si les deux options -maskdata et -maskfile sont spécifiées,
l'option -maskdata a la priorité.
- -maskfile nom
-
La valeur nom est le nom d'un fichier définissant le masque
du bitmap. Le format de ce fichier est le format défini par la norme bitmap X11 (i.e., tel
qu'il est généré par le programme bitmap).
Dès qu'un bitmap est créé, Tk crée aussi une nouvelle commande
de même nom que l'image. Cette commande peut être appelée pour
réaliser des actions sur l'image.
La syntaxe est de la forme :
nom_de_l'image option ?arg arg ...?
Les valeurs affectées aux Option et aux arg
détermine le comportement de la commande. Pour les images
bitmap, les commandes suivantes sont possibles :
- nom_de_l'image cget option
-
Retourne la valeur courante de Option.
Option est n'importe laquelle des options couramment
acceptées par la commande image create bitmap.
- nom_de_l'image configure ?option? ?valeur option valeur ...?
-
Interroge ou modifie la valeur des options de l'image.
Si aucune option n'est spécifiée, la liste de toutes
les options possibles, est retournée (voir Tk_ConfigureInfo pour
connaître le format de cette liste). Si option est donnée
sans aucune valeur associée, alors la commande retourne une liste
décrivant cette option (cette liste est indentique à la sous-liste
correspondante à l'option, de la liste retournée si aucune option n'est spécifiée).
Si une ou plusieurs paires option-valeur sont spécifiées, alors
la commande affecte les nouvelles valeurs aux options correspondantes ; dans
ce cas la commande retourne une chaîne vide.
Option est n'importe laquelle des options acceptées par la commande image create bitmap.
bitmap, image
Copyright © 1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 1995-1997 Roger E. Critchlow Jr.
Copyright © 2003 - Le Portail Tcl/Tk Francophone.