Open main menu

Difference between revisions of "GUI Themes/Specs"

2,524 bytes added ,  22:40, 9 June 2006
→‎'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 ====


TODO
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 ====
561

edits