X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=ionconf%2Fnode5.html;h=2db991c86a4ffc5e1d877398174ccbe072970c4c;hb=refs%2Ftags%2Fion3-20070927;hp=da15f290ec3e9ac40f8a9b7ca79a322ee6448e8a;hpb=16a5f824c31d29598763c5f49918ef67a47ad7e0;p=ion3-doc.git diff --git a/ionconf/node5.html b/ionconf/node5.html index da15f29..2db991c 100644 --- a/ionconf/node5.html +++ b/ionconf/node5.html @@ -28,31 +28,31 @@ original version by: Nikos Drakos, CBLU, University of Leeds
@@ -61,51 +61,53 @@ original version by: Nikos Drakos, CBLU, University of Leeds Subsections
Ion's drawing routines are abstracted into so-called drawing engine modules that can, again depending on the system, be dynamically -loaded as needed. The drawing engine modules provide ''brushes'' +loaded as needed. The drawing engine modules provide ``brushes'' that objects can use to draw some high-level primitives such as borders and text boxes (in addition to simple text and rectangle drawing) on their windows and configure e.g. the shape and @@ -150,17 +153,17 @@ element1-element2-...-elementn
-An example of such a style specification is tab-frame; +An example of such a style specification is `tab-frame'; see the table in subsection 4.1.1 for more styles.
When an object asks for a brush of certain style, the selected
drawing engine will attempt to find the closest match to this
specification. The styles/brushes defined by the drawing engines
-may have asterisks (*
) as some of the elements indicating
+may have asterisks (`*') as some of the elements indicating
a match to anything. Exact matches are preferred to asterisk
matches and longer matches to shorter. For example, let a brush
-for style foo-bar-baz be queried, then the following
+for style `foo-bar-baz' be queried, then the following
brushes are in order of preference:
@@ -177,7 +180,7 @@ specified, also in the form
attr1-attr2-...-attrn-These extra attributes are called substyles +These extra attributes are called substyles and allow, for example, the state of the object to be indicated by different colour sets while keeping the interface at an abstract level and the drawing engine completely ignorant @@ -206,27 +209,27 @@ tag and drag states.)
@@ -354,13 +366,13 @@ end
The gr.select_engine function sees if the engine given as argument is registered (the default drawing engine is -simply called ''de''). If the engine could not be found, it +simply called ``de''). If the engine could not be found, it tries to load a module of the same name. If the engine still -is not registered, gr.select_engine returns false +is not registered, gr.select_engine returns `false' and in this case we also exit the style setup script. If the engine was found, gr.select_engine sees that further requests for brushes are forwarded to that engine -and returns true. +and returns `true'.
Before defining new styles it may be a good idea to clear old @@ -412,7 +424,7 @@ border elements and styles referred to there are explained in Figure
-
Description | ||
highlight_colour | -Colour for the ''highlight'' part of a border. | +Colour for the ``highlight'' part of a border. |
shadow_colour | -Colour for the ''highlight'' part of a border. | +Colour for the ``shadow'' part of a border. |
foreground_colour | Colour for the normal drawing operations, e.g. text. | @@ -463,7 +475,7 @@ in /usr/X11R6/lib/X11/rgb.txt (exact path varying). background colour boxes.|
padding_colour | -Colour for the ''padding'' part of a border border. Set to + | Colour for the ``padding'' part of a border border. Set to background_colour if unset. |
As discussed in previous sections, styles may have substyles to e.g. -indicate different states of the object being drawn. The ''de'' engine +indicate different states of the object being drawn. The ``de'' engine limits what can be configured in substyles to the set of colours in the first table above, but also specifically interprets for the main style -tab-frame the substyles *-*-tagged and *-*-*-dragged +`tab-frame' the substyles `*-*-tagged' and `*-*-*-dragged' by, respectively, drawing a right angle shape at the top right corner of a tab and by shading the tab with a stipple pattern. Also for -menus the substyles *-*-submenu are handled as a special case. +menus the substyles `*-*-submenu' are handled as a special case.
Substyles are defined with the function de.substyle within the @@ -623,21 +641,39 @@ de.defstyle("tab-frame", {
-
-The following style fields are independent of the drawing engine used, -but are related to objects' styles and therefore configured in the drawing -engine configuration file. + +
+The function WFrame.set_grattr may be used to give frames +(and their tabs) arbitrary extra attributes to be passed to the +drawing engine. Hence, by configuring such substyles in the style +configuration files, and turning on the attribute when needed, +scripts may display visual cues related to the frame. There is +also one extra attribute specially interpreted by the default +drawing engine: the `numbered' attribute, which causes +numbers to be displayed on the tabs. -
+ +
+The following style fields are independent of the drawing engine used, +but are related to objects' styles and therefore configured in the drawing +engine configuration file. +
Field | @@ -645,8 +681,8 @@ engine configuration file.|
bar | Controls the style of the tab-bar. Possible values - are the strings "none", "inside", "outside" - and "shaped", with the last providing the PWM-style + are the strings `none', `inside', `outside' + and `shaped', with the last providing the PWM-style tab-bars for floating frames. |
floatframe_tab_min_w | @@ -657,14 +693,17 @@ engine configuration file.|
floatframe_bar_max_w_q | Maximum tab-bar width quotient of frame width for the shaped styles. A number in the - interval . | + interval .
-
@@ -674,12 +713,12 @@ engine configuration file.