Help:Themes fr
From Openbox
(starting translation) |
m (warning message) |
||
Line 1: | Line 1: | ||
langue: [[Help:Themes|gb]] | fr | langue: [[Help:Themes|gb]] | fr | ||
− | + | <span style="color:red">'''''traduction en cours.'''''</span> | |
les thèmes pour OpenBox 3 sont écrits au format Xresources dans un fichier <code>themerc</code>. le format est assez simple à apprendre et vous disposez d'un multitude d'options. | les thèmes pour OpenBox 3 sont écrits au format Xresources dans un fichier <code>themerc</code>. le format est assez simple à apprendre et vous disposez d'un multitude d'options. |
Revision as of 14:46, 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
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
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, décimals 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 |
Specifies the size of the border drawn around window frames.
See also: window.active.border.color, window.inactive.border.color
Type: | integer |
---|---|
Default: | border.width |
Valid: | 0 - 100 |
Specifies the size of the border drawn around menus.
See also: menu.border.color
Type: | integer |
---|---|
Default: | 1 |
Valid: | 1 - 100 |
Specifies the size of menu line separators. (As of version 3.4.7)
Type: | integer |
---|---|
Default: | 6 |
Valid: | 0 - 100 |
Specifies the space on the left and right side of menu line separators. (As of version 3.4.7)
See also: menu.separator.padding.height
Type: | integer |
---|---|
Default: | 3 |
Valid: | 0 - 100 |
Specifies the space on the top and bottom of menu line separators. (As of version 3.4.7)
See also: menu.separator.padding.width
osd.border.width
Type: | integer |
---|---|
Default: | border.width |
Valid: | 0 - 100 |
Specifies the size of the border drawn on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.
See also: osd.border.color
window.client.padding.width
Type: | integer |
---|---|
Default: | padding.width |
Valid: | 0 - 100 |
Specifies the size of the left and right sides of the inner border. The inner border is drawn around the window, but inside the other decorations.
See also: 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 |
Specifies the size of the top and bottom sides of the inner border. The inner border is drawn around the window, but inside the other decorations.
See also: window.active.client.color, window.inactive.client.color window.client.padding.width
window.handle.width
Type: | integer |
---|---|
Default: | 6 |
Valid: | 0 - 100 |
Specifies the size of the window handle. The window handle is the piece of decorations on the bottom of windows. A value of 0 means that no handle is shown.
See also: 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 |
Specifies the padding size, used for spacing out elements in the window decorations. This can be used to give a theme a more compact or a more relaxed feel. This specifies padding in the horizontal direction (and vertical direction if padding.height is not explicitly set).
See also: padding.height
padding.height
Type: | integer |
---|---|
Default: | padding.width |
Valid: | 0 - 100 |
Specifies the padding size, used for spacing out elements in the window decorations. This can be used to give a theme a more compact or a more relaxed feel. This specifies padding in only the vertical direction.
See also: padding.width
Type: | integer |
---|---|
Default: | menu.overlap |
Valid: | -100 - 100 |
Specifies how sub menus should overlap their parents. A positive value moves the submenu over top of their parent by that amount. A negative value moves the submenu away from their parent by that amount. (As of version 3.4.7)
See also: menu.overlap.y
Type: | integer |
---|---|
Default: | menu.overlap |
Valid: | -100 - 100 |
Specifies how sub menus should be positioned relative to their parents. A positive value moves the submenu vertically down by that amount, a negative value moves it up by that amount. (As of version 3.4.7)
See also: menu.overlap.x
Type: | integer |
---|---|
Default: | 0 |
Valid: | -100 - 100 |
This property is obsolete and only present for backwards compatibility.
See also: menu.overlap.x, menu.overlap.y
Border colors
window.active.border.color
Type: | color |
---|---|
Default: | border.color |
Specifies the border color for the focused window.
See also: border.width, window.inactive.border.color
window.active.title.separator.color
Type: | color |
---|---|
Default: | window.active.border.color |
Specifies the border color for the border between the titlebar and the window, for the focused window.
See also: window.inactive.title.separator.color
window.inactive.border.color
Type: | color |
---|---|
Default: | window.active.border.color |
Specifies the border color for all non-focused windows.
See also: border.width, window.active.border.color
window.inactive.title.separator.color
Type: | color |
---|---|
Default: | window.inactive.border.color |
Specifies the border color for the border between the titlebar and the window, for non-focused windows.
See also: window.active.title.separator.color
border.color
Type: | color |
---|---|
Default: | black |
This property is obsolete and only present for backwards compatibility.
See also: window.active.border.color, window.inactive.border.color, menu.border.color
window.active.client.color
Type: | color |
---|---|
Default: | white |
Specifies the color of the inner border for the focused window, drawn around the window but inside the other decorations.
See also: window.client.padding.width, window.inactive.client.color
window.inactive.client.color
Type: | color |
---|---|
Default: | white |
Specifies the color of the inner border for non-focused windows, drawn around the window but inside the other decorations.
See also: window.client.padding.width, window.active.client.color
Type: | color |
---|---|
Default: | window.active.border.color |
Specifies the border color for menus.
See also: menu.border.width
osd.border.color
Type: | color |
---|---|
Default: | window.active.border.color |
Specifies the border color for on-screen-dialogs, such as the focus cycling (Alt-Tab) dialog.
See also: osd.border.width
Titlebar colors
window.active.label.text.color
Type: | color |
---|---|
Default: | black |
Specifies the color of the titlebar text for the focused window.
See also: window.inactive.label.text.color
window.inactive.label.text.color
Type: | color |
---|---|
Default: | white |
Specifies the color of the titlebar text for non-focused windows.
See also: window.active.label.text.color
window.active.button.unpressed.image.color
Type: | color |
---|---|
Default: | black |
Specifies the color of the images in titlebar buttons in their default, unpressed, state. This element is for the focused window.
See also: window.inactive.button.unpressed.image.color
window.active.button.pressed.image.color
Type: | color |
---|---|
Default: | window.active.button.unpressed.image.color |
Specifies the color of the images in titlebar buttons when they are being pressed by the user. This element is for the focused window.
See also: window.inactive.button.pressed.image.color
window.active.button.disabled.image.color
Type: | color |
---|---|
Default: | white |
Specifies the color of the images in titlebar buttons when they are disabled for the window. This element is for the focused window.
See also: window.inactive.button.disabled.image.color
window.active.button.hover.image.color
Type: | color |
---|---|
Default: | window.active.button.unpressed.image.color |
Specifies the color of the images in titlebar buttons when the mouse is over top of the button. This element is for the focused window.
See also: window.inactive.button.hover.image.color
window.active.button.toggled.unpressed.image.color
Type: | color |
---|---|
Default: | window.active.button.toggled.image.color |
Specifies the color of the images in titlebar buttons when the button is toggled - such as when a window is maximized. This element is for the focused window.
See also: window.inactive.button.toggled.unpressed.image.color
window.active.button.toggled.pressed.image.color
Type: | color |
---|---|
Default: | window.active.button.pressed.image.color |
Specifies the color of the images in the titlebar buttons if they are pressed on with the mouse while they are in the toggled state - such as when a window is maximized. This element is for the focused window.
See also: window.inactive.button.toggled.pressed.image.color
window.active.button.toggled.hover.image.color
Type: | color |
---|---|
Default: | window.active.button.toggled.unpressed.image.color |
Specifies the color of the images in the titlebar buttons when the mouse is hovered over them while they are in the toggled state - such as when a window is maximized. This element is for the focused window.
See also: window.inactive.button.toggled.hover.image.color
window.active.button.toggled.image.color
Type: | color |
---|---|
Default: | window.active.button.pressed.image.color |
This property is obsolete and only present for backwards compatibility.
window.inactive.button.unpressed.image.color
Type: | color |
---|---|
Default: | white |
Specifies the color of the images in titlebar buttons in their default, unpressed, state. This element is for non-focused windows.
See also: window.active.button.unpressed.image.color
window.inactive.button.pressed.image.color
Type: | color |
---|---|
Default: | window.inactive.button.unpressed.image.color |
Specifies the color of the images in titlebar buttons when they are being pressed by the user. This element is for non-focused windows.
This color is also used for pressed color when the button is toggled.
See also: window.active.button.pressed.image.color
window.inactive.button.disabled.image.color
Type: | color |
---|---|
Default: | black |
Specifies the color of the images in titlebar buttons when they are disabled for the window. This element is for non-focused windows.
See also: window.active.button.disabled.image.color
window.inactive.button.hover.image.color
Type: | color |
---|---|
Default: | window.inactive.button.unpressed.image.color |
Specifies the color of the images in titlebar buttons when the mouse is over top of the button. This element is for non-focused windows.
See also: window.active.button.hover.image.color
window.inactive.button.toggled.unpressed.image.color
Type: | color |
---|---|
Default: | window.inactive.button.toggled.image.color |
Specifies the color of the images in titlebar buttons when the button is toggled - such as when a window is maximized. This element is for non-focused windows.
See also: window.active.button.toggled.unpressed.image.color
window.inactive.button.toggled.pressed.image.color
Type: | color |
---|---|
Default: | window.inactive.button.pressed.image.color |
Specifies the color of the images in the titlebar buttons if they are pressed on with the mouse while they are in the toggled state - such as when a window is maximized. This element is for non-focused windows.
See also: window.active.button.toggled.pressed.image.color
window.inactive.button.toggled.hover.image.color
Type: | color |
---|---|
Default: | window.inactive.button.toggled.unpressed.image.color |
Specifies the color of the images in the titlebar buttons when the mouse is hovered over them while they are in the toggled state - such as when a window is maximized. This element is for non-focused windows.
See also: window.active.button.toggled.hover.image.color
window.inactive.button.toggled.image.color
Type: | color |
---|---|
Default: | window.active.button.pressed.image.color |
This property is obsolete and only present for backwards compatibility.
Active window textures
window.active.title.bg
Type: | texture |
---|---|
Default: | none |
Parentrelative: | no |
Specifies the background for the focused window's titlebar.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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.
See also: 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
Type: | color |
---|---|
Default: | black |
Specifies the text color for menu headers.
Type: | color |
---|---|
Default: | white |
Specifies the text color for normal menu entries.
Type: | color |
---|---|
Default: | black |
Specifies the text color for disabled menu entries.
Type: | color |
---|---|
Default: | black |
Specifies the text color for normal menu entries when they are selected.
Type: | color |
---|---|
Default: | menu.items.disabled.text.color |
Specifies the text color for disabled menu entries when they are selected.
Type: | color |
---|---|
Default: | menu.items.text.color |
The color of menu line separators. (As of version 3.4.7)
See also: menu.items.text.color
Menu textures
Type: | texture |
---|---|
Default: | none |
Parentrelative: | no |
Specifies the background for menus.
See also: 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.
See also: menu.items.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.
See also: 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.
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.
See also: 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.
See also: window.active.label.text.font
Type: | text shadow string |
---|---|
Default: | no shadow |
Specifies the shadow for all menu entries.
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.
bullet.xbm
Default: | Internal default |
---|
The bullet shown in a menu for submenu entries.