561
edits
Difference between revisions of "GUI Themes/Specs"
→'colors' section: adds documentation about the 'colors' section of the modern theme.
(→Inactive dialog effects: note about backends which don't copy the game screen into the overlay buffer) |
(→'colors' section: adds documentation about the 'colors' section of the modern theme.) |
||
| Line 251: | Line 251: | ||
==== 'colors' section ==== | ==== 'colors' section ==== | ||
In the "colors" section colors for the widget/dialog are specified. | |||
A color gets defined in this way: | |||
name=R G B | |||
with values from 0 to 255 for R, G and B. | |||
There is a special color entry to define the transparency color for the pixmaps, it is | |||
named "color_transparency". Our default theme uses pink (255 0 255) as the transparency | |||
color. | |||
color_transparency=255 0 255 | |||
To set up text colors the following entries have to be set: | |||
color_state_disabled=192 192 192 | |||
color_state_highlight=100 162 8 | |||
color_state_enabled=0 0 0 | |||
"color_state_disabled" is used for disabled text. | |||
"color_state_highlight" is used for highlighted text. | |||
"color_state_enabled" is used for normal text. | |||
The ListWidget uses two special text color entries: | |||
text_inverted_background=100 162 8 | |||
text_inverted_color=0 0 0 | |||
There "text_inverted_background" is used for the rect which is drawn when a entry is selected, | |||
"text_inverted_color" is used for the text drawn when a entry is selected. | |||
Another special color is used for all kind of text input widgets: | |||
caret_color=0 0 0 | |||
This value is used for the color the caret is drawn in. | |||
Some colors are used for background fades, you can easiliy make them out | |||
since they have a '_start' and '_end' suffix. | |||
Another example: | |||
main_dialog_start=210 114 10 | |||
main_dialog_end=239 196 24 | |||
This defines the color fade for the launcher background. "main_dialog_start" | |||
defines the color at the top of the drawn area, "main_dialog_end" at the bottom | |||
of the drawn area, the colors in between get calculated. (see 'gradients' section | |||
for more information). | |||
There are sometimes more than one color fade definition for a widget, the button | |||
widget uses for example one colorfade for normal drawing and a special for highlighted | |||
drawing. Example: | |||
button_bkgd_start=203 126 107 | |||
button_bkgd_end=169 42 12 | |||
button_bkgd_highlight_start=255 210 200 | |||
button_bkgd_highlight_end=200 70 50 | |||
"button_bkgd_start" and "button_bkgd_end" are used for normal drawing. | |||
"button_bkgd_highlight_start" and "button_bkgd_highlight_end" are used for highlighted | |||
drawing. | |||
There are three special entries for the button widget to define the text color: | |||
button_text_enabled=255 255 255 | |||
button_text_disabled=192 192 192 | |||
button_text_highlight=255 214 84 | |||
"button_text_enabled" is used for normal buttons. | |||
"button_text_disabled" is used for buttons which are currently disabled. | |||
"button_text_highlight" is used for highlighted buttons. | |||
If you want to find out all defineable colors look at our default theme config file, | |||
it's named "modern.ini". | |||
==== 'gradients' section ==== | ==== 'gradients' section ==== | ||