File: CONFIGURATION

package info (click to toggle)
xenophilia 0.8-3
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 840 kB
  • ctags: 1,202
  • sloc: ansic: 11,181; makefile: 188; python: 47
file content (193 lines) | stat: -rw-r--r-- 8,490 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193

                               Xenophilia Theme
                                       
Overview

   Xenophilia is a theme engine for GTK+. Its look could be described as
   a mix of NextStep, Windows 95 and Amiga, or in other words: plain.
   Xenophilia was made this way because the default look of GTK+ 1.2.
   (author's opinion) was worse than any of the ones mentioned above, and
   it was also lacking in a few areas which could be improved upon
   through the application of common user interface design principles.
   
   By the way, both Windows 95 and Amiga are borrowing much of their
   visuals from NextStep to begin with.
   
Theme Configuration

  Introduction
  
   When a GTK+ program is loaded, the toolkit parses the file
   $HOME/.gtkrc, any application-specific style files and any files that
   they refer to. These files are in the same text-based format and
   consist of two types of paragraphs: styles and application of these
   styles onto widget classes and named widgets. More about the format of
   these files can be found in the GTK+ documentation and in a tutorial
   at [1]gtk.themes.org.
   
   Xenophilia is a theme engine. In order to activate the engine and bind
   it to a style, the style definition must include a specific clause:
   engine "xeno" { }. The quoted name tells GTK to use the engine with
   that name. The curly brackets are mandatory, and any engine-specific
   options should be placed within them.
   
   The options are in the form option = value. If you do not define an
   option, the default or inherited value for the option will be used.
   
   By the way, you should not put a semicolons at the end of each line.
   =)
   
  Scrollbar
  
   The theme engine applies a few patches to the scrollbar widget which
          can be configured using the options below:
          scrollbar_knob = ( none | dimple | lines | holes | buds | box )
          If the option is set to anything but none, an image will be
          drawn on the center of each scrollbar to indicate that it can
          be moved.
          [dimple.png] A dimple is a little hole as found on scrollbars
          in NextStep.
          [lines.png] The lines are drawn as the lines on the scrollbars
          in MacOS 9.
          [holes.png] holes, and
          [buds.png] buds are also common patters used to indicate
          movable objects.
          A box is an "etched in" box. Looks better on other widgets
          though.
          
   scrollbar_width = integer_number
          Sets the width of the scrollbar in pixels. Default is 15.
          
   stepper_arrows = ( true | false )
          If true the stepper arrows will be drawn in the default GTK
          style, i.e. they will be bevelled and drawn without any
          surrounding box. The default is false.
          [buttons.png] stepper_arrows = false
          [arrows.png] stepper_arrows = true
          
   stepper_ends = ( true | false )
          If true the steppers will be placed at either end of the
          scrollbar instead of in the corner, which is the default.
          
   stepper_box = ( true | false )
          Draw boxes around the stepper arrows. This option is per
          default set to the inverse of the option stepper_arrows, but
          can also be set explicitly. Having no boxes around black arrows
          is rather ugly, but some people (especially old Amiga users)
          like to put boxes around bevelled arrows.=)
          
   scrollbar_flush = ( true | false )
          If true then there will be no inset border around the scrollbar
          and its buttons. This will look better when the scrollbar is
          used for scrolling another widget that does not have any inset
          border, e.g. X-Chat and gnome-terminal text windows.
          
  Shadows
  
   shadow_type => [ none | default | etched | thin | black | note | next
          ] ( in | out )
          
          in [ [ state_type ] ] = shadow_type
          out [ [ state_type ] ] = shadow_type
          Overrides the default shadows for widgets attached to the
          style.
          Example: out[INSENSITIVE] = etched in.
          
   label [ [ state_type ] ] = shadow_type
          Defines how labels should be shaded. Example:
          label[INSENSITIVE] = in. Default is none for everything except
          GtkFrame labels.
          
   button_default = shadow_type
          Sets the shadow that is drawn around buttons who are
          automatically clicked when RETURN is pressed.
          
   menu_item_shadow = shadow_type
          Sets the shadow used for a menu item when the mouse is over it
          
  Other widgets
  
   paned_knob = ( none | dimple | lines | holes | buds | box)
          The Xenophilia theme engine patches the GtkVPaned and GtkHPaned
          widget classes to make the resize-knob into a resize-bar that
          spans the entire length of the gutter. This options define how
          this resizebar should be drawn. Default is box, which means
          that the resizebar should be drawn with an etched-in frame, in
          the style of previous versions of Xenophilia.
          
   handle_knob = ( none | lines | holes | buds | box)
          The default (none) is to draw the handle like ones Netscape 4.x
          have. If it is set to buds or holes, the buds will be organized
          in a regular grid. If you set it to lines it will be drawn like
          handle boxes in Windows 95. The box option makes it look like a
          resizebar.
          
   popup_arrows = ( true | false )
          Changes the tab on the GtkOptionMenu (popup menu button) to a
          pair of solid arrows.
          
  General options
  
   Syntax
   Default
   [arrows.png]
   shine [ [ state_type ] ] = real_number
   1.5
   shade [ [ state_type ] ] = real_number 0.66667
   white [ [ state_type ] ] = real_number 2.0
   black [ [ state_type ] ] = real_number 0.0
   
          These values are shading factors used to blend the background
          color into the colors used to draw the frames. State_type must
          be one of NORMAL, PRELIGHT, ACTIVE, SELECTED and INSENSITIVE as
          usual. A value of 0.0 gives black, 1.0 gives the background
          color, and a value of 2.0 give white. The values will be
          clamped so that white > shine > 1.0 > shade > black. If
          state_type and its brackets are omitted, the option applies to
          all states except the INSENSITIVE state, which defaults to the
          medium of NORMAL and 1.0.
          
   thickness = integer
          Sets the border thickness. Legal values are 0 .. 3. Default is
          2.
          
   flat_windows = ( true | false )
          If true then no bevel will be drawn around the window. This
          will make Xenophilia themes look better together with certain
          window manager themes.
          
   gradient = ( ( horizontal | vertical | diagonal ) [ interlaced ]
          shade_factor ) | none
          Specify how the background should be drawn. The shade_factor
          for gradients is interpreted just as the values for shine and
          shade.
          
   align = x_align y_align
          Specify alignment for the background pixmap, if any. Example:
          align = 0.5 0.5 # Centered.
          
Runtime Configuration

   The theme engine also has a couple of runtime environment variables
          that were added primarily for testing. Don't use these in
          themes!.
          XENO_THEME_PATCH = [ NOT ] ( ALL | NONE | DEFAULT | ( SCROLLBAR
          | SCALE | RADIO_BUTTON | CHECK_BUTTON | PANED | SPIN_BUTTON |
          COMBO | CLIST )* )
          Enable or disable installing a patch. Patches are on by
          default. You can define the variable if you are worried about
          stability. Don't use it for themes. If you don't want the
          Xenophilia behaviour for a widget then don't set xeno to be its
          engine! If all you're after is to get rid of the windoze-like
          combo patch, then this is a bad option; Instead you should
          theme GtkEntry and GtkButton but not GtkCombo to use the
          engine.
          
   XENO_THEME_CMAP = ( YES | NO | TEST )
          Reduce the number of colors used by the engine if YES, or if
          TEST and you are running on a pseudocolor display. You can
          force the option off with NO. The default is TEST.

References

   1. http://gtk.themes.org/