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

### NAME

bitmap - Image affichant deux couleurs

### SYNOPSIS

image create bitmap ?nom? ?options?

### DESCRIPTION

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.

### CREER UN BITMAP

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).

### COMMANDES ASSOCIEES A UNE IMAGE

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.

### MOTS CLES

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.