Help:Themes fr

From Openbox

(Difference between revisions)
Jump to: navigation, search
(stil translating ...)
m (Integers)
Line 218: Line 218:
 
= Data types =
 
= Data types =
 
== Integers ==
 
== Integers ==
Ce sont simplement des nombres comme <code>1</code> ou <code>42</code>.  ils peuvent être entiers, décimals ou nuls.
+
Ce sont simplement des nombres comme <code>1</code> ou <code>42</code>.  ils peuvent être entiers, négatifs ou nuls.
  
 
Exemple:
 
Exemple:

Revision as of 15:30, 23 April 2013

langue: gb | fr

traduction en cours.

les thèmes pour OpenBox 3 sont écrits au format Xresources dans un fichier themerc. le format est assez simple à apprendre et vous disposez d'un multitude d'options.

chaque options est détaillée ici avec leurs valeurs par défaut, les valeurs valides acceptées.

note : les titres et données sont en anglais pour correspondre parfaitement à votre fichier themerc

Contents

Theme installation

les thèmes openbox s'installent dans deux dossiers:

  • /usr/share/themes : disponible pour tous les utilisateurs
  • ~/.local/share/themes ou ~/.themes : disponible pour un utilisateur

Theme selection

le plus simple est d'utiliser ObConf. il existe aussi des pipemenus remplissant la même fonction.

si vous désirez modifier le thème à la main, éditer le <name> key dans la section <theme> de votre fichier ~/.config/openbox/rc.xml. le guide de Configuration(gb) est un bon endroit pour commencer.

Theme file structure

structure de base d'un thème openbox:

ThemesDirectory  (such as /usr/share/themes)
 |
 +-> ThemeName  (This is the name of the theme, such as Clearlooks)
      |
      +-> openbox-3  (This the type of the theme - it's for Openbox 3!)
           |
           |-> themerc  (This is the main theme file, documented in this page)
           |
           |-> max.xbm  (These are optional xbm masks for the titlebar buttons)
           |-> close.xbm
           ...
           +-> shade.xbm

Important.png ObConf peut créer des archives de thèmes Openbox au format .obt pour partager un thème, et peut installer un fichier .obt aussi facilement.

Exemple

Ce thème n'est ici que pour l'exemple, et je ne sais même pas si il est fonctionnel. il est ici pour vous montrer toutes les options disponibles sue Openbox. chaque section est liée au paragraphe qui la concerne.

# Window geometry
padding.width: 2
padding.height: 2
border.width: 1
window.client.padding.width: 1
window.client.padding.height: 0
window.handle.width: 3

#Menu geometry
menu.border.width: 1
menu.overlap.x: 0
menu.overlap.y: 0

# Border colors
window.active.border.color: #000000
window.inactive.border.color: #000000
menu.border.color: #000000
window.active.client.color: #ffffff
window.inactive.client.color: #cccccc

# Text shadows
window.active.label.text.font: shadow=y:shadowtint=70:shadowoffset=1
window.inactive.label.text.font: shadow=y:shadowtint=20:shadowoffset=1
menu.items.font: shadow=n
menu.title.text.font: shadow=y:shadowtint=70:shadowoffset=1

# Window title justification
window.label.text.justify: Center

# Active window
window.active.title.bg: Raised Gradient Vertical Interlaced
window.active.title.bg.color: #658fb5
window.active.title.bg.colorTo: #4d6982
window.active.title.bg.interlace.color: #7788cc

window.active.label.bg: Parentrelative
window.active.label.text.color: #ffffff

window.active.handle.bg: Raised Gradient Vertical
window.active.handle.bg.color: #658fb5
window.active.handle.bg.colorTo: #4d6982

window.active.grip.bg: Raised Gradient Vertical
window.active.grip.bg.color: #658fb5
window.active.grip.bg.colorTo: #4d6982

window.active.button.unpressed.bg: Flat Gradient Vertical Border
window.active.button.unpressed.bg.color: #6993b9
window.active.button.unpressed.bg.colorTo: #55799a
window.active.button.unpressed.bg.border.color: #3d4c5a
window.active.button.unpressed.image.color: #ffffff

window.active.button.pressed.bg: Flat Gradient Vertical Border
window.active.button.pressed.bg.color: #537797
window.active.button.pressed.bg.colorTo: #50708e
window.active.button.pressed.bg.border.color: #3d4c5a
window.active.button.pressed.image.color: #ffffff

window.active.button.disabled.bg: Flat Gradient Vertical Border
window.active.button.disabled.bg.color: #537797
window.active.button.disabled.bg.colorTo: #50708e
window.active.button.disabled.bg.border.color: #3d4c5a
window.active.button.disabled.image.color: #3d4c5a

window.active.button.hover.bg: Flat Gradient Vertical Border
window.active.button.hover.bg.color: #6993b9
window.active.button.hover.bg.colorTo: #55799a
window.active.button.hover.bg.border.color: #3d4c5a
window.active.button.hover.image.color: #ffffff

window.active.button.toggled.unpressed.bg: Flat Gradient Vertical Border
window.active.button.toggled.unpressed.bg.color: #6993b9
window.active.button.toggled.unpressed.bg.colorTo: #55799a
window.active.button.toggled.unpressed.bg.border.color: #3d4c5a
window.active.button.toggled.unpressed.image.color: #cccccc

window.active.button.toggled.pressed.bg: Flat Gradient Vertical Border
window.active.button.toggled.pressed.bg.color: #537797
window.active.button.toggled.pressed.bg.colorTo: #50708e
window.active.button.toggled.pressed.bg.border.color: #3d4c5a
window.active.button.toggled.pressed.image.color: #ffffff

window.active.button.toggled.hover.bg: Flat Gradient Vertical Border
window.active.button.toggled.hover.bg.color: #6993b9
window.active.button.toggled.hover.bg.colorTo: #55799a
window.active.button.toggled.hover.bg.border.color: #3d4c5a
window.active.button.toggled.hover.image.color: #ffffff

# Inactive windows
window.inactive.title.bg: Raised Gradient Vertical
window.inactive.title.bg.color: #f1eeea
window.inactive.title.bg.colorTo: #d8cfc7

window.inactive.label.bg: Parentrelative
window.inactive.label.text.color: #000000

window.inactive.handle.bg: Raised Gradient Vertical
window.inactive.handle.bg.color: #f1eeea
window.inactive.handle.bg.colorTo: #d8cfc7

window.inactive.grip.bg: Raised Gradient Vertical
window.inactive.grip.bg.color: #f1eeea
window.inactive.grip.bg.colorTo: #d8cfc7

window.inactive.button.unpressed.bg: Flat Gradient Vertical Border
window.inactive.button.unpressed.bg.color: #efebe7
window.inactive.button.unpressed.bg.colorTo: #ddd6ce
window.inactive.button.unpressed.bg.border.color: #8f8173
window.inactive.button.unpressed.image.color: #000000

window.inactive.button.pressed.bg: Flat Gradient Vertical Border
window.inactive.button.pressed.bg.color: #efebe7
window.inactive.button.pressed.bg.colorTo: #ddd6ce
window.inactive.button.pressed.bg.border.color: #8f8173
window.inactive.button.pressed.image.color: #000000

window.inactive.button.disabled.bg: Flat Gradient Vertical Border
window.inactive.button.disabled.bg.color: #efebe7
window.inactive.button.disabled.bg.colorTo: #ddd6ce
window.inactive.button.disabled.bg.border.color: #8f8173
window.inactive.button.disabled.image.color: #8f8173

window.inactive.button.toggled.bg: Flat Gradient Vertical Border
window.inactive.button.toggled.bg.color: #efebe7
window.inactive.button.toggled.bg.colorTo: #ddd6ce
window.inactive.button.toggled.bg.border.color: #8f8173
window.inactive.button.toggled.image.color: #000000

window.inactive.button.hover.bg: Flat Gradient Vertical Border
window.inactive.button.hover.bg.color: #efebe7
window.inactive.button.hover.bg.colorTo: #ddd6ce
window.inactive.button.hover.bg.border.color: #8f8173
window.inactive.button.hover.image.color: #000000

window.inactive.button.toggled.unpressed.bg: Flat Gradient Vertical Border
window.inactive.button.toggled.unpressed.bg.color: #efebe7
window.inactive.button.toggled.unpressed.bg.colorTo: #ddd6ce
window.inactive.button.toggled.unpressed.bg.border.color: #8f8173
window.inactive.button.toggled.unpressed.image.color: #000000

window.inactive.button.toggled.pressed.bg: Flat Gradient Vertical Border
window.inactive.button.toggled.pressed.bg.color: #efebe7
window.inactive.button.toggled.pressed.bg.colorTo: #ddd6ce
window.inactive.button.toggled.pressed.bg.border.color: #8f8173
window.inactive.button.pressed.toggled.image.color: #000000

window.inactive.button.toggled.hover.bg: Flat Gradient Vertical Border
window.inactive.button.toggled.hover.bg.color: #efebe7
window.inactive.button.toggled.hover.bg.colorTo: #ddd6ce
window.inactive.button.toggled.hover.bg.border.color: #8f8173
window.inactive.button.toggled.hover.image.color: #000000

# Menus
menu.title.bg: Raised Gradient Vertical
menu.title.bg.color: #658fb5
menu.title.bg.colorTo: #4d6982
menu.title.text.color: #ffffff
menu.title.text.justify: Left
menu.separator.color: #444444
menu.separator.width: 1
menu.separator.padding.width: 6
menu.separator.padding.height: 3

menu.items.bg: Flat Solid
menu.items.bg.color: #f8f5f2
menu.items.text.color: #000000
menu.items.disabled.text.color: #aaaaaa

menu.items.active.bg: Flat Gradient Vertical
menu.items.active.bg.color: #628cb2
menu.items.active.bg.colorTo: #50708d
menu.items.active.text.color: #ffffff
menu.items.active.disabled.text.color: #aaaaaa

Data types

Integers

Ce sont simplement des nombres comme 1 ou 42. ils peuvent être entiers, négatifs ou nuls.

Exemple:

window.handle.width: 3

Justification

détermine le placement du texte. les options acceptées: Left, Center et Right.

Exemple:

menu.title.text.justify: Left

Textures

les textures déterminent l'aspect visuel d'un élément. c'est la partie la plus compliquée d'un fichier de thème, sans l'être trop.

les textures sont spécifiées par une chaîne de texte avec un certain nombre de domaines. Le format est le suivant (| signifie "ou" et [] défini un champ optionnel):

parentrelative | ((solid | gradient gradient-type) [border] [interlaced])

voyons les textures en détail.

Parentrelative

ParentRelative signifie que l'élément hérite des couleurs des textures sous-jacentes. Il est, par essence, complètement transparent. Certains éléments du thème peut être ParentRelative, et certains ne peuvent pas. La documentation de chacun vous dira si vous pouvez utiliser ParentRelative pour elle ou pas.

Exemple:

window.active.label.bg: Parentrelative
window.inactive.label.bg: Parentrelative Raised

Solid

Solid signifie que la texture est compose d'une unique couleur. la texture doit être suivie d'un color field.

Exemple:

menu.items.bg:       Solid Flat
menu.items.bg.color: #f8f5f2

Gradients

la texture gradient doit être suivie d'un type. elle utilise impérativement deux color fields: color and colorTo.

Types de Gradients acceptés:

  • Diagonal - gradient depuis le coin supérieur gauche au coin inférieur droit
  • CrossDiagonal - gradient depuis le coin supérieur droit au coin inférieur gauche
  • Pyramid - gradient depuis les 4 coins vers le centre
  • Horizontal - gradient de la gauche vers la droite
  • MirrorHorizontal - gradient depuis la gauche vers le centre, puis gradient renversé depuis le centre vers la droite
  • Vertical - gradient depuis le haut vers le bas
  • SplitVertical - gradient inversé partant du centre vers le haut et le bas

Exemple:

menu.title.bg:         Gradient Vertical Raised 
menu.title.bg.color:   #658fb5
menu.title.bg.colorTo: #4d6982

SplitVertical gradients

SplitVertical gradients accepte deux color fields additionnels en option: color.splitTo et colorTo.splitTo. ces couleurs sont utilisées pour les bords supérieurs et inférieurs de la texture. par défaut, les valeurs sont définies par color * 5/4, and colorTo * 17/16.

Exemple:

menu.title.bg:                 Gradient SplitVertical Raised 
menu.title.bg.color:           #658fb5
menu.title.bg.color.splitTo:   #7595b9
menu.title.bg.colorTo:         #4d6982
menu.title.bg.colorTo.splitTo: #557485

Border

les bordures peuvent utiliser les textures solid ou gradient. les options de bases sont Flat, Raised (par défaut) et Sunken.

Flat, ne dessine pas de bordure réelle. pour ajouter une bordure , il lui faut absolument une border color et utiliser l'option Flat Border.

Exemple:

window.active.button.unpressed.bg:              Gradient Vertical Flat Border
window.active.button.unpressed.bg.border.color: #3d4c5a

Raised et Sunken ont deux options de relief en plus. par défaut, un relief est dessiné à l'extérieur de la bordure. si Bevel2 est spécifié, alors le relief sera dessiné un peu plus vers l'intérieur de la bordure. ceci peut être utilisé pour animer les états des boutons par exemple.

l'apparence des reliefs peut aussi être déterminée dans le thème grâce aux options highlight et shadow:

highlight détermine la valeur de surbrillance appliquer à l'élément. '0' pas de surbrillance, '256'=100% de surbrillance, '512'=200% de surbrillance etc .. par défaut:'128'=50% en plus de luminosité.

shadow détermine la valuer de l'ombre. compris entre 0 (pas d'ombre) et 256 (ombre noire). par défaut: '64'=25% de réduction de la luminosité.

Exemple:

window.inactive.button.disabled.bg:           Gradient Diagonal Raised
window.inactive.button.disabled.bg.color:     rgb:50/54/58
window.inactive.button.disabled.bg.colorTo:   black
window.inactive.button.disabled.bg.highlight: 128
window.inactive.button.disabled.bg.shadow:    64

window.inactive.button.toggled.pressed.bg:          Gradient Diagonal Raised Bevel2
window.inactive.button.toggled.pressed.bg.color:    rgb:50/54/58
window.inactive.button.toggled.pressed.bg.colorTo:  black

Interlaced

Interlaced textures aka rayures horizontales. à utiliser avec une seconde interlaced color.

Exemple:

window.inactive.title.bg: Solid Flat Interlaced
window.inactive.title.bg.color: #f5f5f5
window.inactive.title.bg.interlace.color: #f6f6f6

Colors

les couleurs peuvent être spécifiées avec leurs noms ou leur désignation héxadécimale GRB.

Color names

Wikipedia décrit une list of X11 color names, et plus de détails ici.

Exemple:

menu.items.active.text.color: white
window.active.grip.bg.color: grey40

RGB values

Les couleurs peuvent être spécifiées par les valeurs RGB hexadécimal de deux façons. La plus connue est à travers une syntaxe similaire à HTML, #​​rrggbb. Cependant, vous pouvez également utiliser le format rgb: rr/bb/gg.

Exemple:

window.active.grip.bg.color: #658fb5
window.active.label.text.color: #fff
menu.items.active.bg.color: rgb:90/94/98
window.active.title.bg.color: rgb:6/9/c

Notez que #fff est équivalent à #f0f0f0, pas à #ffffff.

Text shadow strings

Les ombrages de texte sont précisées par une chaîne de texte spécialement formaté.

Il ya trois propriétés qui peuvent être placés dans la chaîne: shadow, shadowtint et shadowoffset.

Shadow est une valeur booléenne. Par défaut, 'no'. Vous pouvez activer une ombre pour le texte à l'aide de 'shadow=y'.

Shadowtint spécifie la valeur alpha de l'ombre ainsi que sa couleur (noir ou blanc). Par défaut, c'est noir et 50% d'opacité. Vous pouvez spécifier le shadowtint en utilisant 'shadowtint=70'. La teinte peut être n'importe quel nombre entier compris entre -100 et 100. 0 signifie 0% d'opacité (invisible), 100 signifie 100% d'opacité et noir, -100 signifie 100% d'opacité et blanc.

ShadowOffset indique dans quelle mesure l'ombre doit être décalé par rapport au texte. Sa valeur par défaut '1'. Il peut être positif pour déplacer l'ombre en bas à droite du texte, ou négative pour la déplacer vers le haut et à gauche du texte. Vous pouvez régler la ShadowOffset en utilisant 'ShadowOffset=2'. 'ShadowOffset=0' placera l'ombre exactement derrière le texte et elle ne sera pas visible.

les ombres du textes peuvent être spécifiées séparément pour chasue élément. dans ce cas, les propriétés générales sont ignorées

Exemple:

window.active.label.text.font:shadow=y:shadowtint=70:shadowoffset=1

Theme elements

chaque élément d'un thème correspond à un élément de menu, d'une fenêtre etc…

le détail complet de chaque élément avec leurs spécificités sera expliqué sous cette forme:

Type: integer
Default: 1
Valid: 0-100
Parentrelative: no

Type le type d'élément.

Default affiche la valeur par défaut si non spécifiées dans le thème. si le 'default' fait référence à un autre élément, c'est celui-ci qui servira de valeur par défaut

Valid indique les valeurs acceptées par les éléments, comme integer values.

Parentrelative définit si la valeur Parentrelative peut être appliquée.

Geometry

border.width

Type: integer
Default: 1
Valid: 0 - 100

détermine l'épaisseur de la bordures des fenêtres en pixels.

voir aussi: window.active.border.color, window.inactive.border.color

menu.border.width

Type: integer
Default: border.width
Valid: 0 - 100

détermine l'épaisseur de la bordure autour des menus.

voir aussi: menu.border.color

menu.separator.width

Type: integer
Default: 1
Valid: 1 - 100

détermine l'épaisseur des séparateurs de menus. (As of version 3.4.7)

menu.separator.padding.width

Type: integer
Default: 6
Valid: 0 - 100

détermine l'espace en pixels de chaque coté des séparateurs de menu. (As of version 3.4.7)

voir aussi: menu.separator.padding.height

menu.separator.padding.height

Type: integer
Default: 3
Valid: 0 - 100

détermine la marge supérieure et inférieure des séparateurs de menu. (As of version 3.4.7)

Voir aussi: menu.separator.padding.width

osd.border.width

Type: integer
Default: border.width
Valid: 0 - 100

détermine l'épaisseur de la bordure des fenêtres de dialogue, comme le switch du focus (Alt-Tab).

Voir aussi: osd.border.color

window.client.padding.width

Type: integer
Default: padding.width
Valid: 0 - 100

détermine l'épaisseur de la bordure latérale (droite et gauche) interne des fenêtres. elle se dessine entre la bordure externe et le corps de la fenêtre.

Voir aussi: window.active.client.color, window.inactive.client.color window.client.padding.height

window.client.padding.height

Type: integer
Default: window.client.padding.width
Valid: 0 - 100

détermine l'épaisseur de la bordure interne (haute et basse) des fenêtres. elle se dessine entre la bordure externe et le corps de la fenêtre.

Voir aussi: window.active.client.color, window.inactive.client.color window.client.padding.width

window.handle.width

Type: integer
Default: 6
Valid: 0 - 100

détermine l'épaisseur de la zone de préhension. cette zone se situe en bas de la fenêtre. une valeur de '0' masque cette zone.

Voir aussi: window.active.handle.bg, window.inactive.handle.bg, window.active.grip.bg, window.inactive.grip.bg

padding.width

Type: integer
Default: 3
Valid: 0 - 100

détermine la marge interne horizontale (et verticale si non spécifiée) utilisée pour séparer les éléments des décorations de la fenêtre.

Voir aussi: padding.height

padding.height

Type: integer
Default: padding.width
Valid: 0 - 100

détermine la marge interne verticale utilisée pour séparer les éléments des décorations de la fenêtre.

Voir aussi: padding.width

menu.overlap.x

Type: integer
Default: menu.overlap
Valid: -100 - 100

détermine le décallage horizontal entre menu et sous-menu. une valeur positive supperpose le sous-menu au menu, une valeur négative le sépare. (As of version 3.4.7)

Voir aussi: menu.overlap.y

menu.overlap.y

Type: integer
Default: menu.overlap
Valid: -100 - 100

détermine le décallage vertical entre menu et sous-menu. une valeur positive fait descendre le sous-menu, une valeur négative le fait monter. (As of version 3.4.7)

Voir aussi: menu.overlap.x

menu.overlap

Type: integer
Default: 0
Valid: -100 - 100

cette propriété est obsolète et n'existe que pour raison de compatibilité.

Voir aussi: menu.overlap.x, menu.overlap.y

Border colors

window.active.border.color

Type: color
Default: border.color

détermine la couleur de la bordure de la fenêtre active.

Voir aussi: border.width, window.inactive.border.color

window.active.title.separator.color

Type: color
Default: window.active.border.color

détermine la couleur de la bordure inférieure de la barre de titre de la fenêtre active.

Voir aussi: window.inactive.title.separator.color

window.inactive.border.color

Type: color
Default: window.active.border.color

détermine la couleur de la bordure des fenêtres inactives.

Voir aussi: border.width, window.active.border.color

window.inactive.title.separator.color

Type: color
Default: window.inactive.border.color

détermine la couleur de la bordure inférieure de la barre de titre des fenêtres inactives.

Voir aussi: window.active.title.separator.color

border.color

Type: color
Default: black

cette propriété est obsolète et n'existe que pour raison de compatibilité.

Voir aussi: window.active.border.color, window.inactive.border.color, menu.border.color

window.active.client.color

Type: color
Default: white

détermine la couleur de la bordure interne de la fenêtre active. elle se dessine entre la bordure externe et le corps de la fenêtre.

Voir aussi: window.client.padding.width, window.inactive.client.color

window.inactive.client.color

Type: color
Default: white

détermine la couleur de la bordure interne des fenêtres inactives. elle se dessine entre la bordure externe et le corps de la fenêtre.

Voir aussi: window.client.padding.width, window.active.client.color

menu.border.color

Type: color
Default: window.active.border.color

détermine la couleur de la bordure du menu.

Voir aussi: menu.border.width

osd.border.color

Type: color
Default: window.active.border.color

détermine la couleur de la bordure des fenêtres de dialogue comme le switch de focus (Alt-Tab).

Voir aussi: osd.border.width

Titlebar colors

window.active.label.text.color

Type: color
Default: black

détermine la couleur du texte de la barre de titre de la fenêtre active.

Voir aussi: window.inactive.label.text.color

window.inactive.label.text.color

Type: color
Default: white

détermine la couleur du texte de la barre de titre des fenêtres inactives.

Voir aussi: window.active.label.text.color

window.active.button.unpressed.image.color

Type: color
Default: black

détermine la couleur des images des boutons de la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.unpressed.image.color

window.active.button.pressed.image.color

Type: color
Default: window.active.button.unpressed.image.color

détermine la couleur des images des boutons lors d'un clic pour la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.pressed.image.color

window.active.button.disabled.image.color

Type: color
Default: white

détermine la couleur des images des boutons désactivés de la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.disabled.image.color

window.active.button.hover.image.color

Type: color
Default: window.active.button.unpressed.image.color

détermine la couleur des images des boutons lors d'un survol pour la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.hover.image.color

window.active.button.toggled.unpressed.image.color

Type: color
Default: window.active.button.toggled.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) pour la barre de titre de la fenêtre active.

Voir aussi: window.inactive.button.toggled.unpressed.image.color

window.active.button.toggled.pressed.image.color

Type: color
Default: window.active.button.pressed.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) lors d'un clic pour la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.toggled.pressed.image.color

window.active.button.toggled.hover.image.color

Type: color
Default: window.active.button.toggled.unpressed.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) lors d'un survol pour la barre de titre de la fenetre active.

Voir aussi: window.inactive.button.toggled.hover.image.color

window.active.button.toggled.image.color

Type: color
Default: window.active.button.pressed.image.color

cette propriété est obsolète et n'existe que pour des raisons de compatibilités.

window.inactive.button.unpressed.image.color

Type: color
Default: white

détermine la couleur des images des boutons de la barre de titre des fenêtres inactives.

Voir aussi: window.active.button.unpressed.image.color

window.inactive.button.pressed.image.color

Type: color
Default: window.inactive.button.unpressed.image.color

détermine la couleur des images des boutons de la barre de titre des fenêtres inactives lors d'un clic.

cette option est aussi utilisé pour le mode 'toggle' lors d'un clic pour les fenêtres inactives.

Voir aussi: window.active.button.pressed.image.color

window.inactive.button.disabled.image.color

Type: color
Default: black

détermine la couleur des images des boutons désactivés de la barre de titre des fenêtres inactives.

Voir aussi: window.active.button.disabled.image.color

window.inactive.button.hover.image.color

Type: color
Default: window.inactive.button.unpressed.image.color

détermine la couleur des images des boutons de la barre de titre des fenêtres inactives lors d'un survol.

Voir aussi: window.active.button.hover.image.color

window.inactive.button.toggled.unpressed.image.color

Type: color
Default: window.inactive.button.toggled.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) pour la barre de titre des fenêtres inactives.

Voir aussi: window.active.button.toggled.unpressed.image.color

window.inactive.button.toggled.pressed.image.color

Type: color
Default: window.inactive.button.pressed.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) lors d'un clic pour la barre de titre de la fenêtre active.

Voir aussi: window.active.button.toggled.pressed.image.color

window.inactive.button.toggled.hover.image.color

Type: color
Default: window.inactive.button.toggled.unpressed.image.color

détermine la couleur des images des boutons en mode 'toggle' (ex: fenêtre maximisée) lors d'un survol pour la barre de titre des fenêtres inactives.

Voir aussi: window.active.button.toggled.hover.image.color

window.inactive.button.toggled.image.color

Type: color
Default: window.active.button.pressed.image.color

cette propriété est obsolète et n'existe que pour des raisons de compatibilités.


Active window textures

window.active.title.bg

Type: texture
Default: none
Parentrelative: no

Specifies the background for the focused window's titlebar.

Voir aussi: window.inactive.title.bg

window.active.label.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for the focused window's titlebar label. The label is the container for the window title. When it is parentrelative, then it uses the window.active.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.label.bg, window.active.title.bg

window.active.handle.bg

Type: texture
Default: none
Parentrelative: no

Specifies the background for the focused window's handle. The handle is the window decorations placed on the bottom of windows.

Voir aussi: window.handle.width, window.inactive.handle.bg

window.active.grip.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for the focused window's grips. The grips are located at the left and right sides of the window's handle. When it is parentrelative, then it uses the window.active.handle.bg which is underneath it.

Voir aussi: window.handle.width, window.inactive.grip.bg, window.active.handle.bg

Inactive window textures

window.inactive.title.bg

Type: texture
Default: none
Parentrelative: no

Specifies the background for non-focused windows' titlebars.

Voir aussi: window.active.title.bg

window.inactive.label.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for non-focused windows' titlebar labels. The label is the container for the window title. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.label.bg, window.inactive.title.bg

window.inactive.handle.bg

Type: texture
Default: none
Parentrelative: no

Specifies the background for non-focused windows' handles. The handle is the window decorations placed on the bottom of windows.

Voir aussi: window.handle.width, window.active.handle.bg

window.inactive.grip.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for non-focused windows' grips. The grips are located at the left and right sides of the window's handle. When it is parentrelative, then it uses the window.inactive.handle.bg which is underneath it.

Voir aussi: window.handle.width, window.active.grip.bg, window.inactive.handle.bg

Active window button textures

window.active.button.unpressed.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons in their default, unpressed, state. This element is for the focused window. When it is parentrelative, then it uses the window.active.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.unpressed.bg

window.active.button.pressed.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons when they are being pressed by the user. This element is for the focused window. When it is parentrelative, then it uses the window.active.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.pressed.bg

window.active.button.hover.bg

Type: texture
Default: window.active.button.unpressed.bg
Parentrelative: yes

Specifies the background for titlebar buttons when the mouse is over them. This element is for the focused window. When it is parentrelative, then it uses the window.active.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.hover.bg

window.active.button.disabled.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons when they are disabled for the window. This element is for the focused window. When it is parentrelative, then it uses the window.active.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.disabled.bg

window.active.button.toggled.unpressed.bg

Type: texture
Default: window.active.button.toggled.bg
Parentrelative: yes

Specifies the default background for titlebar buttons when they are toggled - such as when a window is maximized. This element is for the focused window. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.toggled.unpressed.bg

window.active.button.toggled.pressed.bg

Type: texture
Default: window.active.button.pressed.bg
Parentrelative: yes

Specifies the default background for titlebar buttons if the user is pressing them with the mouse while they are toggled - such as when a window is maximized. This element is for the focused window. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.toggled.pressed.bg

window.active.button.toggled.hover.bg

Type: texture
Default: window.active.button.toggled.unpressed.bg
Parentrelative: yes

Specifies the default background for titlebar buttons if the user is pressing them with the mouse while they are toggled - such as when a window is maximized. This element is for the focused window. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.active.title.bg, window.inactive.button.toggled.hover.bg

window.active.button.toggled.bg

Type: texture
Default: window.active.button.pressed.bg
Parentrelative: yes

This property is obsolete and only present for backwards compatibility.

Inactive window button textures

window.inactive.button.unpressed.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons in their default, unpressed, state. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.unpressed.bg

window.inactive.button.pressed.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons when they are being pressed by the user. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.pressed.bg

window.inactive.button.hover.bg

Type: texture
Default: window.inactive.button.unpressed.bg
Parentrelative: yes

Specifies the background for titlebar buttons when the mouse is over them. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.hover.bg

window.inactive.button.disabled.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for titlebar buttons when they are disabled for the window. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.disabled.bg

window.inactive.button.toggled.unpressed.bg

Type: texture
Default: window.inactive.button.toggled.bg
Parentrelative: yes

Specifies the default background for titlebar buttons when they are toggled - such as when a window is maximized. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.toggled.unpressed.bg

window.inactive.button.toggled.pressed.bg

Type: texture
Default: window.inactive.button.pressed.bg
Parentrelative: yes

Specifies the default background for titlebar buttons if the user is pressing them with the mouse while they are toggled - such as when a window is maximized. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.toggled.pressed.bg

window.inactive.button.toggled.hover.bg

Type: texture
Default: window.inactive.button.toggled.unpressed.bg
Parentrelative: yes

Specifies the default background for titlebar buttons if the user is pressing them with the mouse while they are toggled - such as when a window is maximized. This element is for non-focused windows. When it is parentrelative, then it uses the window.inactive.title.bg which is underneath it.

Voir aussi: titlebar colors, window.inactive.title.bg, window.active.button.toggled.hover.bg

window.inactive.button.toggled.bg

Type: texture
Default: window.inactive.button.pressed.bg
Parentrelative: yes

This property is obsolete and only present for backwards compatibility.

Menu colors

menu.title.text.color

Type: color
Default: black

Specifies the text color for menu headers.

menu.items.text.color

Type: color
Default: white

Specifies the text color for normal menu entries.

menu.items.disabled.text.color

Type: color
Default: black

Specifies the text color for disabled menu entries.

menu.items.active.text.color

Type: color
Default: black

Specifies the text color for normal menu entries when they are selected.

menu.items.active.disabled.text.color

Type: color
Default: menu.items.disabled.text.color

Specifies the text color for disabled menu entries when they are selected.

menu.separator.color

Type: color
Default: menu.items.text.color

The color of menu line separators. (As of version 3.4.7)

Voir aussi: menu.items.text.color

Menu textures

menu.items.bg

Type: texture
Default: none
Parentrelative: no

Specifies the background for menus.

Voir aussi: menu.items.active.bg

menu.items.active.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for the selected menu entry (whether or not it is disabled). When it is parentrelative, then it uses the menu.items.bg which is underneath it.

Voir aussi: menu.items.bg

menu.title.bg

Type: texture
Default: none
Parentrelative: yes

Specifies the background for menu headers. When it is parentrelative, then it uses the menu.items.bg which is underneath it.

Voir aussi: menu.items.bg

OSD textures

osd.bg

Type: texture
Default: window.active.title.bg
Parentrelative: no

Specifies the background for on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.

osd.label.bg

Type: texture
Default: window.active.label.bg
Parentrelative: yes

Specifies the background for text in on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.

osd.hilight.bg

Type: texture
Default: window.active.label.bg, if it is not parentrelative. Otherwise, window.active.title.bg
Parentrelative: no

Specifies the texture for the selected desktop in the desktop cycling (pager) dialog.

osd.unhilight.bg

Type: texture
Default: window.inactive.label.bg, if it is not parentrelative. Otherwise, window.inactive.title.bg
Parentrelative: no

Specifies the texture for unselected desktops in the desktop cycling (pager) dialog.

OSD colors

osd.label.text.color

Type: color
Default: black

Specifies the text color for on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.

osd.hilight.bg.color

Type: color
Default: black

Specifies the color for selected desktops in the desktop cycling (pager) dialog.

osd.unhilight.bg.color

Type: color
Default: black

Specifies the color for unselected desktops in the desktop cycling (pager) dialog.

Text justification

window.label.text.justify

Type: justification
Default: Left

Specifies how window titles are aligned in the titlebar for both the focused and non-focused windows.

menu.title.text.justify

Type: justification
Default: Left

Specifies how text is aligned in all menu headers.

Text shadows

window.active.label.text.font

Type: text shadow string
Default: no shadow

Specifies the shadow for the focused window's title.

Voir aussi: window.inactive.label.text.font

window.inactive.label.text.font

Type: text shadow string
Default: no shadow

Specifies the shadow for non-focused windows' titles.

Voir aussi: window.active.label.text.font

menu.items.font

Type: text shadow string
Default: no shadow

Specifies the shadow for all menu entries.

menu.title.text.font

Type: text shadow string
Default: no shadow

Specifies the shadow for all menu headers.

osd.label.text.font

Type: text shadow string
Default: no shadow

Specifies the text shadow for on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.

Dialogs

Openbox shows dialog boxes in some situations. Two examples are:

  • The exit dialog window that appears when the exit action is called.
  • When closing a window for a program that is not responding.

These dialogs have buttons, such as Cancel and Exit. These buttons get their background information from window.active.button.*.bg. The buttons' text color comes from window.active.button.*.image.color.

Button images

The images used for the titlebar buttons and the submenu bullet are 1-bit xbm (X Bitmaps). These are masks where 0 = clear and 1 = colored.

The xbm image files are placed in the same directory within your theme as the themerc file, as shown in the file structure discussion.

The xbm's which Openbox uses as its internal defaults are distributed with Openbox and installed to /usr/share/doc/openbox/xbm.

Here are all the possible xbm files which Openbox looks for.

Maximized button

max.xbm

Default: Internal default

Maximize button in its default, unpressed state.

max_toggled.xbm

Default: If max.xbm is present, it uses that. If not, it has a separate internal default

Maximize button when it is in toggled state.

max_pressed.xbm

Default: max.xbm, or its internal default

Maximized button when pressed.

max_disabled.xbm

Default: max.xbm, or its internal default

Maximized button when disabled.

max_hover.xbm

Default: max.xbm, or its internal default

Maximized button when mouse is over it.

max_toggled_pressed.xbm

Default: max_toggled.xbm, or max.xbm, or its internal default

Maximized button when pressed, in toggled state.

max_toggled_hover.xbm

Default: max_toggled.xbm, or max.xbm, or its internal default

Maximized button when mouse is over it, in toggled state.

Iconify button

iconify.xbm

Default: Internal default

Iconify button in its default, unpressed state.

iconify_pressed.xbm

Default: iconify.xbm, or its internal default

Iconify button when pressed.

iconify_disabled.xbm

Default: iconify.xbm, or its internal default

Iconify button when disabled.

iconify_hover.xbm

Default: iconify.xbm, or its internal default

Iconify button when mouse is over it.

Close button

close.xbm

Default: Internal default

Close button in its default, unpressed state.

close_pressed.xbm

Default: close.xbm, or its internal default

Close button when pressed.

close_disabled.xbm

Default: close.xbm, or its internal default

Close button when disabled.

close_hover.xbm

Default: close.xbm, or its internal default

Close button when mouse is over it.

All-desktops button

desk.xbm

Default: Internal default

All-desktops button in its default, unpressed state.

desk_toggled.xbm

Default: If desk.xbm is present, it uses that. If not, it has a separate internal default

All-desktops button when it is in toggled state.

desk_pressed.xbm

Default: desk.xbm, or its internal default

All-desktops button when pressed.

desk_disabled.xbm

Default: desk.xbm, or its internal default

All-desktops button when disabled.

desk_hover.xbm

Default: desk.xbm, or its internal default

All-desktops button when mouse is over it.

desk_toggled_pressed.xbm

Default: desk_toggled.xbm, or desk.xbm, or its internal default

All-desktops button when pressed, in toggled state.

desk_toggled_hover.xbm

Default: desk_toggled.xbm, or desk.xbm, or its internal default

All-desktops button when mouse is over it, in toggled state.

Shade button

shade.xbm

Default: Internal default

Shade button in its default, unpressed state.

shade_toggled.xbm

Default: If shade.xbm is present, it uses that. If not, it has a separate internal default

Shade button when it is in toggled state.

shade_pressed.xbm

Default: shade.xbm, or its internal default

Shade button when pressed.

shade_disabled.xbm

Default: shade.xbm, or its internal default

Shade button when disabled.

shade_hover.xbm

Default: shade.xbm, or its internal default

Shade button when mouse is over it.

shade_toggled_pressed.xbm

Default: shade_toggled.xbm, or shade.xbm, or its internal default

Shade button when pressed, in toggled state.

shade_toggled_hover.xbm

Default: shade_toggled.xbm, or shade.xbm, or its internal default

Shade button when mouse is over it, in toggled state.

Submenu bullet

bullet.xbm

Default: Internal default

The bullet shown in a menu for submenu entries.

Personal tools