blackbox

Section: User Commands (1)
Updated: F�vrier 2002
Page Index

NOM

blackbox - un gestionnaire de fen�tre pour X11

SYNOPSIS

blackbox -help | -version
blackbox [ -rc fichier_rc ] [ -display affichage ]

DESCRIPTION

Blackbox est un ajout de plus � la liste des gestionnaires de fen�tres pour le Syst�me de Fen�tres X de l'Open Group, Version 11 Release 6 et au del�. Blackbox est impl�ment� en C++, et ne reprend aucune ligne de code d'un autre gestionnaire de fen�tres (bien que l'impl�mentation des graphiques soit similaire � celle de Window Maker).

D�s l'heure o� la premi�re ligne de code fut �crite, Blackbox a �volu� autour d'un principe : le minimalisme. Il n'est pas con�u pour �tre agr�able au regard, ni pour �tre le plus riche en fonctionnalit�s, ni le plus d�cor� pour ressembler � l'interface NeXt, la plus largement connue. Il est simplement con�u pour �tre rapide.

Blackbox fournit des d�corations de fen�tres configurables, un menu racine pour lancer des applications et une barre-outil qui indique le nom de l'espace de travail courant, le nom de l'application disposant du clavier, et l'heure courante. Il dispose aussi d'un menu pour g�rer les espaces de travail (ajout ou suppression). La `fente' (NDT. slit) est utilisable pour accrocher de petites applications, comme la plupart des outils-bb (NDT. bbtools), par exemple.

Blackbox fournit une gestion des ic�nes d'un type particulier : lorsqu'on r�duit en ic�ne une fen�tre, aucun ic�ne n'appara�t ; en revanche, le nom de l'application est ajout� dans le sous-menu `Icones' du menu des espaces de travail. Ainsi, votre bureau ne sera jamais embarrass� par une multitude d'icones �parpill�s. Comme alternative aux ic�nes, les fen�tres fant�mes sont mises � disposition : un double-clic sur la barre de titre d'une fen�tre la rend fant�me (c'est-�-dire que la fen�tre dispara�t et seule sa barre de titre demeure visible).

Blackbox utilise ses propres classes graphiques pour produire ses images � la vol�es. Par l'utilisation de fichiers de styles, vous pouvez tr�s finement d�terminer � quoi ressemble votre bureau. Blackbox utilise actuellement son propre protocole pour communiquer avec les clients tels que les pagineurs. Le travail est en cours pour supporter les nouvelles sp�cifications de gestionnaires de fen�tres que GNOME et KDE utilisent.

OPTIONS

Blackbox comprend les options de ligne de commande suivantes :

-help: Affiche les options de ligne de commande, les fonctionnalit�s support�es, puis se termine.
-version: Affiche les informations de version et se termine.
-rc fichier_rc: Utilise un autre fichier de contr�le d'ex�cution que celui par d�faut ~/.blackboxrc.
-display affichage: D�marre Blackbox sur l'affichage sp�cifi�. Les programmes lanc�s par Blackbox auront �galement la variable d'environnement DISPLAY positionn�e � cette valeur.

EX�CUTER BLACKBOX

Le programme est habituellement ex�cut� par le script de d�marrage de l'utilisateur, la plupart du temps nomm� ~/.xinitrc ou ~/.xsession. Pour ex�cuter blackbox, modifiez le script en ajoutant

exec blackbox

en tant que derni�re commande ex�cut�e par le script. Lorsque Blackbox se termine, la session X est �galement termin�e.

Lorsqu'il d�marre, Blackbox essaie de trouver un fichier de menu par d�faut dans /usr/share/blackbox/menu. Vous pouvez y configurer un menu global pour les utilisateurs.

Lors de l'arr�t ou du red�marrage, Blackbox enregistre les options par d�faut de l'utilisateur dans le fichier ~/.blackboxrc dans le r�pertoire de l'utilisateur. Certaines ressources de ce fichier peuvent �tre �dit�es manuellement.

UTILISER BLACKBOX

Depuis la version 0.60.x, Blackbox n'assume plus lui-m�me la gestion du clavier ; pour cela, il s'appuie sur un programme externe bbkeys(1). Aussi, dans cette section, nous n'abordons que les commandes li�es � la souris.

Fen�tre racine (arri�re-plan) :

Un clic droit (bouton 3) fait jaillir le menu racine. Par celui-ci, vous pouvez lancer vos applications. Vous pouvez aussi le personnaliser en fonction de vos besoins. Voir ci-dessus pour sa localisation. Un clic central (bouton 2) fait jaillir le menu des espaces de travail. Vous pouvez ajouter ou supprimer un espace de travail, voir les applications qui s'ex�cutent sur chacun d'entre eux, voir les fen�tres iconifi�es, ou passer directement � n'importe quel espace de travail ou application.

Cliquer � l'aide du bouton de gauche (bouton 1) sur une application dans le menu des espaces de travail vous place sur cet espace de travail, am�ne l'application au devant et lui attribue le clavier. Cliquer � l'aide du bouton central (bouton 2) place l'application sur l'espace de travail courant.

Barre-Outil :

La barre-outil consiste en trois zones : le nom de l'espace de travail, le nom de la fen�tre disposant actuellement du clavier et l'horloge. Un clic gauche sur la barre-outil l'am�ne au devant, un clic central la cache derri�re les autres fen�tres (si `Toujours au dessus' n'est pas positionn�) et un clic droit fait appara�tre un petit menu.

En utilisant ce menu, vous pouvez saisir un nom pour l'espace de travail courant (lorsque la saisie est termin�e, pressez Entr�e). Vous pouvez aussi d�terminer la position de la barre-outil, si elle doit toujours �tre visible (c'est-�-dire qu'aucune autre fen�tre ne la cache), et si elle doit glisser hors de l'�cran lorsque la souris la quitte.

Note : Avec les versions de Blackbox ant�rieures � la version 0.60.0, un clic droit sur la barre-outil entra�nait imm�diatement la saisie du nom de l'espace de travail.

Barre de titre et Bordures des Fen�tres :

Un clic gauche sur n'importe quelle partie de la bordure d'une fen�tre l'am�ne au devant. Faire glisser la souris (bouton maintenu enfonc�) d�place alors la fen�tre. Faire glisser les poign�es de redimensionnement situ�es dans les coins au bas de la fen�tre permet de changer sa taille. Cliquer avec le bouton central pousse la fen�tre en arri�re. Cliquer avec le bouton droit sur la bordure ou la barre de titre fait jaillir un menu de fen�tre, contenant les commandes suivantes :

Envoie vers ...: Envoie la fen�tre sur un autre espace de travail. Lorsque vous s�lectionnez l'espace de travail avec le bouton central, Blackbox vous place, avec l'application, sur l'espace de travail s�lectionn�.
Fant�me: Rend la fen�tre fant�me (affiche seulement sa barre de titre).
Iconifie: Iconifie la fen�tre. L'ic�ne est pr�sent dans le sous-menu 'Ic�nes' du menu des espaces de travail. Il n'appara�tra d'*AUCUNE* autre fa�on sur l'�cran.
Maximise: Maximise la fen�tre ou la restaure � sa taille initiale. Lorsque vous cliquez avec le bouton central sur cet item, la fen�tre est seulement maximis�e verticalement.
�l�ve: Place la fen�tre au dessus des autres.
Abaisse: Place la fen�tre sous les autres.
�pingle: �pingle la fen�tre ou la lib�re. Une fen�tre �pingl�e sera toujours affich�e sur l'espace de travail courant.
Massacre: Massacre sauvagement (-SIGKILL) le propri�taire de la fen�tre. A n'utiliser qu'avec les clients r�calcitrants qui refusent de se terminer.
Fermer: Ferme l'application proprement.

Lorsque vous double-cliquez sur la barre de titre d'une fen�tre, elle devient `fant�me', de sorte que seule la barre de titre demeure visible. Un autre double-clic la rend � nouveau int�gralement visible.

Boutons des Fen�tres :

Le bouton dans le coin en haut � gauche de la fen�tre est le bouton pour iconifier. Cliquer dessus avec n'importe quel bouton de la souris iconifie la fen�tre. Le bouton le plus � droite (avec le X) ferme l'application. L'autre bouton � droite (lorsqu'il est pr�sent) maximise la fen�tre de trois fa�ons diff�rentes : le bouton gauche de la souris produit une maximisation sur tout l'�cran, le bouton central une maximisation verticale et le bouton droit une maximisation horizontale.

Pour tout menu :

Un clic avec le bouton droit de la souris referme le menu. Cliquer avec le bouton gauche sur la barre de titre de n'importe quel (sous)menu et ensuite le faire glisser quelque part rend ce menu permanent, il ne dispara�tra pas lorsque vous cliquerez sur l'un de ses items.

Divers :

Lorsque vous voulez faire glisser une fen�tre, mais que vous ne pouvez voir ni la barre de saisie, ni la barre de titre, vous pouvez presser Alt + bouton 1 n'importe o� dans la fen�tre et ensuite la faire glisser o� vous voulez. Vous pouvez utiliser Alt + bouton 1 pour �lever une fen�tre partiellement visible. Enfin, Alt + bouton 2 abaisse la fen�tre, et Alt + bouton 3 permet de modifier sa taille.

FICHIER DE MENU

Un fichier de menu par d�faut est install� dans /usr/share/blackbox/menu. Bien s�r, ce menu global pour le syst�me peut �tre configur� pour tous les utilisateurs simultan�ment. Mais il est �galement possible de cr�er un menu personnel. Il est habituel de cr�er un r�pertoire ~/.blackbox/ (ou ~/blackbox/) dans votre r�pertoire d'utilisateur, et d'y cr�er un fichier de menu, par exemple menu, ou d'y copier le fichier du menu global. Ensuite, il faut indiquer � Blackbox de charger votre menu de fichier plut�t que celui par d�faut. Pour cela il faut ajouter une ressource (ou changer sa valeur) dans le fichier ~/.blackboxrc :

session.menuFile:       ~/.blackbox/menu

Pour que cette modification prenne effet, Blackbox doit �tre red�marr�. Assurez-vous que le menu est utilisable, puis s�lectionnez `Red�marrer' dans le menu racine par d�faut de Blackbox.

Syntaxe du menu

La syntaxe du menu est tr�s simple et tr�s efficace. Il peut y avoir jusqu'� trois champs sur une ligne de menu. Ils sont de la forme :

[�tiquette] (libell� ou fichier) {commande ou fichier}

Les �tiquettes support�es sont les suivantes :

[begin] (libell� du menu racine)

Indique � Blackbox de commencer l'analyse du fichier de menu. Cette �tiquette est obligatoire pour que Blackbox analyse le fichier de menu. S'il ne peut la trouver, le menu par d�faut du syst�me est utilis� � la place.

[end]

Indique � Blackbox la fin du menu. Ce peut �tre un sous-menu ou le menu racine principal. Il doit y avoir au moins une �tiquette [end] correspondant � l'�tiquette obligatoire [begin].

[exec] (libell� de la commande) {commande shell}

Ins�re un item de commande dans le menu. Lorsque vous s�lectionnez l'item dans le menu, Blackbox ex�cute `commande shell'.

[exit] (libell� pour quitter)

Ins�re un item qui arr�te Blackbox et termine. Tout programme en cours d'ex�cution n'est pas ferm�.

[include] (fichier)

Analyse le fichier sp�cifi� par fichier et l'inclut dans le menu courant. Le nom de fichier peut �tre un chemin d'acc�s complet � un fichier, ou peut commencer par ~/, ce qui sera remplac� par le chemin d'acc�s complet � votre r�pertoire d'utilisateur (par exemple

[include] (~/blackbox/menustyles)

inclut /home/bhughes/blackbox/menustyles dans mon menu).

[nop] (libell� - optionnel)

Ins�re un item inop�rant dans le menu courant. Il peut �tre utilis� pour formater un menu en blocs ou en sections. [nop] accepte un libell�, mais il n'est pas obligatoire, et un item vide sera utilis� si aucun n'est renseign�.

[style] (libell�) {fichier}

Demande � Blackbox d'ins�rer un item qui, lorsqu'il est s�lectionn�, lit le fichier de style fichier et applique les nouvelles textures, couleurs et polices de caract�res � la session en cours.

[stylesdir] (r�pertoire)

Lit tous les noms de fichiers (les r�pertoires sont ignor�s) du r�pertoire sp�cifi� et cr�e des items de menu dans le menu courant correspondant aux noms des fichiers. Blackbox suppose que chaque fichier est un fichier de style valide. Lorsqu'un tel item est s�lectionn� par l'utilisateur, Blackbox applique le style � la session en cours.

[stylesmenu] (libell�) {r�pertoire}

Cr�e une entr�e de sous-menu nomm�e libell� (qui est aussi le titre du sous-menu), et ins�re dans ce sous-menu tous les noms de fichiers du r�pertoire sp�cifi�, de la m�me fa�on que [stylesdir].

Les commandes [stylesdir] et [stylesmenu] permettent d'installer de nouveaux fichiers de styles sans avoir � �diter le fichier de menu.

[submenu] (libell�) {titre du menu - optionnel}

Demande � Blackbox de cr�er et analyser un nouveau menu. Ce menu est ins�r� en tant que sous-menu du menu parent. Comme les menus sont analys�s r�cursivement, il n'y a pas de limite au nombre de niveaux des sous-menus. Le titre du nouveau menu est optionnel ; si aucun n'est renseign�, le titre sera identique au libell� de l'item. Une �tiquette [end] est obligatoire pour terminer le sous-menu.

[reconfig] (libell�)

Lorsqu'on s�lectionne cet item, Blackbox relit les fichiers du style courant et du menu, puis applique toute modification. Ceci est particuli�rement pratique pour cr�er de nouveaux th�mes ou styles, car ainsi il n'est pas n�cessaire de red�marrer constamment Blackbox chaque fois que le fichier du style est enregistr�. Par ailleurs, Blackbox relit automagiquement le menu chaque fois qu'il a �t� modifi�.

[restart] (libell�) {commande shell - optionnel}

Indique � Blackbox de red�marrer. Si `commande shell' est renseign�e, Blackbox s'arr�te et ex�cute la commande (qui lance habituellement un autre gestionnaire de fen�tre). Si la commande est omise, Blackbox se red�marre lui-m�me.

[config] (libell�)

Ins�re un sous-menu g�n�r� par Blackbox, contenant de nombreuses options de configuration telles que la politique de positionnement des fen�tres, le mode d'attribution du clavier, le style de d�placement des fen�tres, etc.

[workspaces] (libell�)

Ins�re dans le menu un lien direct vers le menu des espaces de travail. Ceci est tr�s pratique pour les utilisateurs ne disposant pas d'une souris � trois boutons.

Toute ligne d�butant par le caract�re `#' est consid�r�e comme un commentaire et n'est pas prise en compte par Blackbox. Dans les libell�s, les commandes ou les noms de fichiers, n'importe quel caract�re peut �tre prot�g� de la fa�on suivante :

[exec] (\(mon super\) \{XTERM\}) {xterm -T \"super XTERM\"}

L'utilisation de `\\' ins�re un back-slash litt�ral dans le libell�, la commande ou le nom de fichier.

Exemple de menu

Mixons un peu tout �a. Voici un court exemple de fichier de menu :

# Fichier de menu Blackbox
[begin] (Blackbox 0.76)
  [exec] (rxvt) {rxvt -ls}
  [exec] (Mozilla) {mozilla}
  [exec] (The GIMP) {gimp}
  [submenu] (Gestionnaire de fen�tres)
    [exec] (�dition Menus) {nedit .blackbox/Menu}
    [submenu] (Style) {Quel Style ?}
      [stylesdir] (~/.blackbox/styles)
      [stylesmenu] (Styles Blackbox) {/usr/share/blackbox/styles}
    [end]
    [config] (Options de Config.)
    [reconfig] (Reconfigurer)
    [restart] (Red�marrer)
  [end]
  [exit] (D�connexion)
[end]
# Fin du fichier de menu

STYLES

Pour d�terminer l'apparence g�n�rale des bordures de fen�tres, des menus et de la barre-outil, Blackbox recourt � des fichiers sp�cifiques contenant des ressources X(1). Ces derni�res permettent de sp�cifier les couleurs, les textures et les polices de caract�res.

L'installation par d�faut de Blackbox fournit quelques fichiers de style. Ils sont habituellement copi�s dans /usr/share/blackbox/styles. Vous pouvez �tudier ou �diter ces fichiers pour comprendre comment fonctionnent les styles dans Blackbox. Les commandes [style], [stylesdir] et [stylesmenu] plac�es dans votre fichier de menu vous permettent de changer de style � la vol�e en le s�lectionnant simplement dans votre menu.

Vous pouvez aussi cr�er un r�pertoire dans votre r�pertoire d'utilisateur (habituellement nomm� ~/.blackbox/styles) et y placer vos propres styles. Vous avez bien s�r le choix dans le nom du r�pertoire, mais de nombreux styles � t�l�charger s'appuient sur le nom styles (selon le mod�le de nom de bb.themes.org).

Pour comprendre comment les styles fonctionnent, vous devez avoir une l�g�re connaissance sur le fonctionnement des ressources X.

Les ressources X consistent en une cl� et une valeur. La cl� est constitu�e d'un certain nombre de cl�s plus petites (parfois r�f�renc�es sous le nom d'enfants), d�limit�es par un point (`.'). Les cl�s peuvent aussi contenir une ast�risque (`*') qui sert de joker, ce qui signifie qu'une seule ligne de texte saisie peut correspondre � plusieurs cl�s. Ce cas est tr�s utile lorsque le style est bas� sur une ou deux couleurs.

Blackbox vous autorise � configurer ses quatre composants principaux : la barre-outil, la fente, les menus et la d�coration des fen�tres.

La petite fen�tre qui affiche la position (x,y) pendant que vous d�placez une fen�tre emprunte son style aux barres de titre des fen�tres.

Voici quelques exemples rapides :

toolbar.clock.color:    green

Ici, la valeur `green' (vert) est affect�e � la ressource couleur de l'horloge pr�sente sur la barre-outil.

menu*color:     rgb:3/4/5

Dans cet exemple, la valeur `rgb:3/4/5' est affect�e � la ressource couleur du menu et � tous ses `enfants'. (Pour une description des noms de couleurs, voir X(1) ). Ainsi, elle s'applique aussi � menu.title.color et menu.frame.color.

*font:  -b&h-lucida-medium-r-normal-*-*-140-*

Cet exemple positionne � la m�me valeur la ressource police de caract�re de toutes les cl�s. (Pour des informations sur les fontes install�es sur votre syst�me, vous pouvez utiliser des programmes tels que xfontsel(1), gtkfontsel, ou xlsfonts(1) ).

Mais ce qui rend Blackbox si spectaculaire, c'est sa capacit� � produire des textures � la vol�e. Les descriptions de textures sont sp�cifi�es d'une fa�on semblable � celle des couleurs illustr�e pr�c�demment. Par exemple :

toolbar.clock:         Raised Gradient Diagonal Bevel1
toolbar.clock.color:   rgb:8/6/4
toolbar.clock.colorTo: rgb:4/3/2

Pas de panique~! Nous expliquons tout de suite. La description d'une texture est compos�e d'au plus cinq champs, qui peuvent prendre les valeurs suivantes :

Flat / Raised / Sunken: donne au composant un aspect plat (Flat), bomb� (Raised) ou enfonc� (Sunken).
Gradient / Solid: indique � Blackbox d'utiliser une couleur uniforme (Solid) ou d'appliquer une texture d�grad�e (Gradient).
Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid: s�lectionne le type de texture : horizontal, vertical, diagonal (d'en haut � gauche � en bas � droite), diagonal crois� (Crossdiagonal - d'en haut � droite � en bas � gauche), croisement de tuyaux (Pipecross), elliptique (Elliptic), rectangulaire (Rectangle) ou pyramidal (Pyramid). Cela n'est utile que lorsque Gradient est �galement sp�cifi�~!
Interlaced: indique � Blackbox d'entrelacer la texture (une ligne sur deux est assombrie). Cette option est plus couramment utilis�e avec les textures d�grad�es, mais depuis Blackbox version 0.60.3, elle est aussi disponible avec les textures uniformes.
Bevel1 / Bevel2: indique � Blackbox quel type de relief utiliser. Bevel1 est le relief par d�faut. L'ombre est plac�e au bord de l'image. Bevel2 est une alternative. Le trait d'ombre est plac� � un pixel du bord de l'image.

A la place de la description d'une texture, l'option ParentRelative est aussi disponible, ce qui rend le composant semblable � son parent, autrement dit il est totalement transparent.

Toutes les textures d�grad�es sont compos�es de deux valeurs de couleur : les ressources color et colorTo. color repr�sente la couleur initiale et colorTo la couleur finale du d�grad�. Lorsque Interlaced est utilis� conjointement au mode Solid, la ressource colorTo est utilis�e pour sp�cifier la couleur d'entrelacement.

Bien, voici la liste compl�te des composants, avec le type de valeur qu'ils acceptent. Les commentaires sont pr�c�d�s d'un point d'exclamation (!), qui est aussi utilis� pour les commentaires dans le fichier de style Blackbox, tout autant que dans les fichiers de ressources X.

! La barre-outil elle-m�me.
toolbar:                        Texture
toolbar.color:                  Couleur
toolbar.colorTo:                Couleur

! Les boutons de la barre-outil.
toolbar.button:                 Texture ou ParentRelative
toolbar.button.color:           Couleur
toolbar.button.colorTo:         Couleur

! Couleur des fl�ches des boutons.
toolbar.button.picColor:        Couleur

! Boutons dans l'�tat enfonc� (cliqu�).
toolbar.button.pressed:         Texture (p.ex. Sunken) ou ParentRelative
toolbar.button.pressed.color:   Couleur
toolbar.button.pressed.colorTo: Couleur

! Couleur des fl�ches des boutons dans l'�tat enfonc� (cliqu�).
toolbar.button.pressed.picColor:Couleur

! Le libell� de l'espace de travail sur la barre-outil.
toolbar.label:                  Texture ou ParentRelative
toolbar.label.color:            Couleur
toolbar.label.colorTo:          Couleur
toolbar.label.textColor:        Couleur

! Le titre de la fen�tre active sur la barre-outil.
toolbar.windowLabel:            Texture ou ParentRelative
toolbar.windowLabel.color:      Couleur
toolbar.windowLabel.colorTo:    Couleur
toolbar.windowLabel.textColor:  Couleur

! L'horloge sur la barre-outil.
toolbar.clock:                  Texture ou ParentRelative
toolbar.clock.color:            Couleur
toolbar.clock.colorTo:          Couleur
toolbar.clock.textColor:        Couleur

! Comment le texte de la barre-outil doit �tre align�.
! Centr� (center), � gauche (left) ou � droite (right).
toolbar.justify:                center, left, or right

! Police de caract�res � utiliser avec tous les composants de la barre-outil.
toolbar.font:                   Fonte (p.ex. -*-helvetica-medium-r-normal-*-*-100-*)

! Barre de titre du menu.
menu.title:                     Texture
menu.title.color:               Couleur
menu.title.colorTo:             Couleur
menu.title.textColor:           Couleur
menu.title.font:                Fonte
menu.title.justify:             center, left ou right

! Le menu lui-m�me.
menu.frame:                     Texture
menu.frame.color:               Couleur
menu.frame.colorTo:             Couleur
menu.frame.textColor:           Couleur
menu.frame.disableColor:        Couleur
menu.frame.font:                Fonte
menu.frame.justify:             center, left ou right

! Les bulles pour les sous-menus.
! Vide (empty), triangle (triangle), carr� (square), losange (diamond).
menu.bullet:                    empty, triangle, square ou diamond
menu.bullet.position:           right or left

! Un item de menu sur-lign�.
menu.hilite:                    Texture (p.ex. Raised)
menu.hilite.color:              Couleur
menu.hilite.colorTo:            Couleur
menu.hilite.textColor:          Couleur

! Une fen�tre disposant du clavier (active).
window.title.focus:             Texture
window.title.focus.color:       Couleur
window.title.focus.colorTo:     Couleur

! Une fen�tre ne disposant pas du clavier (inactive).
window.title.unfocus:           Texture
window.title.unfocus.color:     Couleur
window.title.unfocus.colorTo:   Couleur

! Titre de la fen�tre.
window.label.focus:             Texture ou ParentRelative
window.label.focus.color:       Couleur
window.label.focus.colorTo:     Couleur
window.label.focus.textColor:   Couleur

window.label.unfocus:           Texture ou ParentRelative
window.label.unfocus.color:     Couleur
window.label.unfocus.colorTo:   Couleur
window.label.unfocus.textColor: Couleur

! Barre de saisie.
window.handle.focus:            Texture
window.handle.focus.color:      Couleur
window.handle.focus.colorTo:    Couleur

window.handle.unfocus:          Texture
window.handle.unfocus.color:    Couleur
window.handle.unfocus.colorTo:  Couleur

! Poign�es de redimensionnement.
window.grip.focus:              Texture
window.grip.focus.color:        Couleur
window.grip.focus.colorTo:      Couleur

window.grip.unfocus:            Texture
window.grip.unfocus.color:      Couleur
window.grip.unfocus.colorTo:    Couleur

! Boutons de fen�tre.
window.button.focus:            Texture ou ParentRelative
window.button.focus.color:      Couleur
window.button.focus.colorTo:    Couleur
window.button.focus.picColor:   Couleur

window.button.unfocus:          Texture ou ParentRelative
window.button.unfocus.color:    Couleur
window.button.unfocus.colorTo:  Couleur
window.button.unfocus.picColor: Couleur

window.button.pressed:          Texture (p.ex. Sunken)
window.button.pressed.color:    Couleur
window.button.pressed.colorTo:  Couleur

! Cadre autour de la fen�tre.
window.frame.focusColor:        Couleur
window.frame.unfocusColor:      Couleur

! Police de caract�res et alignement.
window.font:                    Fonte
window.justify:                 center, left ou right

! Diverses ressources.

! Une bordure peut �tre dessin�e autour de tous les composants.
borderWidth:                    un nombre de pixels, p.ex. 1
borderColor:                    Couleur

! �paisseur des reliefs.
bevelWidth:                     un nombre de pixels > 0
! �paisseur de la barre de saisie.
handleWidth:                    un nombre de pixels > 0

! Largeur du cadre des fen�tres (depuis la version 0.61).
! Lorsqu'il n'est pas sp�cifi�, la valeur de bevelWidth est prise par d�faut.
frameWidth:                     un nombre de pixels >= 0


! Cette commande est ex�cut�e chaque fois que le style est s�lectionn�.
! Typiquement, elle place une belle image sur la fen�tre racine.
rootCommand:                    Commande shell, p.ex. bsetroot -mod 4 4 -fg rgb:5/6/6 -bg grey20

! Certains bbtools lisent ces vieilles ressources de la version 0.51.
menuFont:                       Fonte
titleFont:                      Fonte

Cette liste est certes longue, mais rappelez vous lorsque vous cr�ez votre propre style que vous pouvez facilement positionner beaucoup de cl�s en une seule ligne, par exemple :


*color:             slategrey
*colorTo:           darkslategrey
*unfocus.color:     darkslategrey
*unfocus.colorTo:   black
*textColor:         white
*unfocus.textColor: lightgrey
*font:              lucidasans-10

Cela sp�cifie d�j� des valeurs par d�faut sympathiques pour pas mal de composants.

LA FENTE

La fente est une fen�tre sp�ciale qui peut contenir des applications � accrochables � (NDT. dockable), par exemple les `outils-bb' (NDT. `bbtools') ou les `dockapps' de WindowMaker. Lorsque des applications s'ex�cutent dans la fente, elles n'ont pas de bordure propre ; en revanche, elles sont encastr�es dans la fente et elles sont toujours visibles sur l'espace de travail courant. Vous pouvez cliquer avec le bouton 3 sur le bord de la fente afin de faire appara�tre un menu permettant de configurer sa position, son orientation et si elle doit dispara�tre lorsque la souris n'est plus positionn�e au dessus d'elle.

La plupart des applications accrochables utilise l'option -w pour s'ex�cuter dans la fente. Par exemple, vous pouvez placer dans votre fichier ~/.xinitrc :

bbmail -w &
bbpager -w &
exec blackbox

Bien s�r, pour utiliser la fente, vous devez avoir compil� Blackbox en activant le support de la fente (c'est l'option par d�faut).

FICHIER DE RESSOURCES

Habituellement, le fichier de ressources ~/.blackboxrc est cr�� et maintenu par Blackbox lui-m�me. Toutes les options du menu [config] (depuis la version 0.60.x), le dernier fichier de style s�lectionn�, le nom des espaces de travail, etc. sont automatiquement enregistr�s dans ce fichier. Cependant, il y a quelques ressources que vous pouvez vouloir �diter vous-m�me :

session.menuFile:: Indique � Blackbox quel fichier de menu doit �tre charg�.
session.screen0.toolbar.widthPercent:: D�termine la proportion (en %) de la largeur de l'�cran qui sera occup�e par la barre-outil. La valeur par d�faut est : 66.
session.screen0.strftimeFormat:: Sp�cifie le format d'affichage de l'heure courante sur la barre-outil. La syntaxe du format est celle de la fonction strftime(3). La valeur par d�faut est : %I:%M %p.
session.autoRaiseDelay:: Sp�cifie le d�lai (en ms) avant que la fen�tre disposant du clavier ne soit �lev�e au premier plan. La valeur par d�faut est : 250.
session.doubleClickInterval:: Sp�cifie le d�lai (en ms) en dessous duquel Blackbox consid�re deux clics cons�cutifs comme un double-clic. La valeur par d�faut est : 250.
session.screen0.edgeSnapThreshold:: Lorsque vous d�placez une fen�tre sur l'�cran, Blackbox peut `l'aimanter' aux extr�mit�s de l'�cran afin de faciliter son positionnement. Ce param�tre indique � Blackbox la distance (en pixels) � partir de laquelle la fen�tre se collera automatiquement aux bords. La valeur par d�faut est : 0.
session.cacheMax:: Cette ressource indique � Blackbox quelle quantit� de m�moire (en Ko) il peut utiliser pour conserver les pixmaps en cache sur le serveur X. Si votre machine tombe � court de m�moire, vous pouvez diminuer cette valeur. Elle est par d�faut � : 200.
session.cacheLife:: Indique � Blackbox combien de temps (en minutes) les pixmaps inutilis�s demeurent dans la m�moire du serveur X. La valeur par d�faut est : 5.
session.colorsPerChannel:: Indique � Blackbox combien de couleurs doivent �tre r�serv�es sur le serveur X pour les affichages en mode pseudocolor. Un `channel' (NDT. canal) peut �tre rouge, vert ou bleu. Blackbox alloue un nombre de couleurs correspondant � cette valeur puissance 3 et les rend toujours disponibles. Cette valeur doit �tre comprise entre 2 et 6. Lorsque vous ex�cutez Blackbox sur un affichage 8 bits, vous devez positionner cette ressource � 4. La valeur par d�faut est : 4.

Lorsque vous ex�cutez Blackbox dans un environnement disposant de plusieurs �crans, la cl� screen0 peut aussi �tre screen1, 2 etc. pour tout �cran appropri�.

ENVIRONNEMENT

HOME: Blackbox utilise $HOME pour trouver le fichier .blackboxrc, et pour r�soudre le nom du fichier de style ou les noms de r�pertoires.
DISPLAY: Lorsqu'aucun autre affichage n'a �t� sp�cifi� en ligne de commande, Blackbox s'ex�cute sur l'affichage d�sign� par cette variable.

AUTEURS et CR�DITS

Tout le code a �t� initialement �crit et maintenu par Brad Hughes (blackbox@alug.org) puis par Jeff Raven (jraven@psu.edu), il est dor�navant maintenu par Sean 'Shaleh' Perry (shaleh@debian.org) avec les contributions et la fusion de patches provenant de nombreux individus de par le monde.

L'adresse du site officiel de Blackbox est : http://blackboxwm.sf.net
La page des d�fauts (NDT. bugs) et des demandes de fonctionnalit�s, ainsi que les versions courantes sont accessibles � : http://sf.net/projects/blackboxwm
De nombreux th�mes et d'autres contributions sont disponibles � : http://bb.themes.org/

Cette page de manuel a �t� r�dig�e par Wilbert Berendsen (wbsoft@xs4all.nl) et traduite en fran�ais par Bertrand Duret (bertrand.duret@libertysurf.fr). De nombreuses autres traductions seront bient�t disponibles.

VOIR AUSSI

bsetroot(1), bbkeys(1)