MyStyle(1) AfterStep X11 window manager MyStyle(1)NAMEMyStyle - defines combination of color, font, style, background to be
used together
Look Alignment flags Bevel flags MyBackground MyFrame MyStyle
Suported hints Titlebar layout
CONFIGURATION OPTIONS
BackColor color
Specifies the background color associated with this style. color
is a color definition in one of the color formats supported by
AfterStep.
BackColor is also used to calculate bevel colors used to draw a
border around a widget.
BackGradient type from to
Specifies that a gradient should be used as a background instead
of a solid color. The gradient colors start at from and end at
to . from and to are color definition in one of the supported
color formats . If gradient includes at least one transparent
color ( alpha value set to be below FF ), gradient will be
alpha-blended over the root background image. type can be 1, 2,
3, 4, or 5:
1: Wharf-style diagonal gradient
2: Horizontal from top to bottom
3: Horizontal from top/bottom to center
4: Vertical from left to right
5: Vertical from left/right to center
6: Top-Left to Bottom Right diagonal ( same as 1 )
7: Bottom-Left to Top-Right diagonal
8: Vertical Top to Bottom ( same as 2 )
9: Horizontal Left to Right ( same as 4 )
BackMultiGradient type offset1 color1 ... offsetN colorN
Specifies that a gradient should be used as a background instead
of a solid color. The gradient colors start at color1 and end at
colorN . Each color has an offset associated with it. The offset
is a number between 0.0 and 1.0, and specifies where in the gra‐
dient the colors are to be placed. The colors are in one of the
color formats supported by AfterStep. At least two colors must
be given. If gradient includes at least one transparent color (
alpha value set to be below FF ), gradient will be alpha-blended
over the root background image. The offsets are non-decreasing
numbers between 0.0 and 1.0. If the first offset is not 0.0, it
will be set to 0.0. If the last offset is not 1.0, it will be
set to 1.0. type may be any of the following:
6: Top-Left to Bottom Right diagonal
7: Bottom-Left to Top-Right diagonal
8: Vertical Top to Bottom
9: Horizontal Left to Right
BackPixmap type pixmap_name|color_name
Specifies that a pixmap should be used as a background instead
of a solid color. This option has two forms, depending on the
value of type :
If type is 125, 126, 127, 128, 130-144, 150-164 - the second
parameter, pixmap_name must be the name of an image file which
can be found in PixmapPath .
If type is 129 or 149 the root pixmap (desktop background) will
be used, and the optional second parameter must be a color with
which the root pixmap will be shaded/tinted.
Depending on the value of type AfterStep will render pixmap in
many different ways :
125 Image is SCALED to the size of the widget, and its opacity is
used to set the shape of the widget/window decoration, achieving
non-rectangular window effect.
126 Image is TILED to the size of the widget, and its opacity is
used to set the shape of the widget/window decoration, achieving
non-rectangular window effect.
127 Image is SCALED to the size of the widget.
128 Image is Tiled to the size of the image.
129 Underlying desktop background is tinted/shaded with the color
specified with the second parameter.
130 Underlying desktop background is combined with tiled image,
using "allanon" method - taking average of pixel values.
131 Underlying desktop background is alpha-blended with tiled image.
132 Underlying desktop background is tinted using pixel values of
the tiled image, as a tint values on per-pixel basis.
133 Each pixel of underlying desktop background has value of tiled
image's pixel added to it.
134 Each pixel of underlying desktop background has value of tiled
image's pixel subtracted from it.
135 Result consists of pixels representing absolute value of differ‐
ence between underlying desktop background and tiled image.
136 Underlying desktop background is darkened using luminocity of
the tiled image's pixels.
137 Underlying desktop background is lightened using luminocity of
the tiled image's pixels.
138 Underlying desktop background is "screened" by the tiled image.
139 Underlying desktop background is "overlayed" by the tiled image.
140 Underlying desktop background's hue is substituted with the hue
of the tiled image.
141 Underlying desktop background's saturation is substituted with
the saturation of the tiled image.
142 Underlying desktop background's value (in HSV colorspace) is
substituted with the value of the tiled image.
143 Underlying desktop background is "colorized" by the tiled image.
144 Underlying desktop background is "dissipated" by the tiled
image.
149 Underlying desktop background is tinted/shaded with the color
specified with the second parameter. It differs from 129 so that
desktop background could be both darkened and brightened. If
tint color channel is greater the 7F (127 decimal) - then
respective channel of background will be brightened.
150 - 164
Same as 130-144 but specified image is scaled to the size of the
widget.
BlurSize
FIXME: add proper description here.
DrawTextBackground [ 0|1 ]
Specifies that the area behind text drawn in this style should
be cleared to BackColor . The argument is optional. If the argu‐
ment is 0, this option is turned off; if it is omitted or is
nonzero, the option is turned on.
Font font
Specifies the font associated with this style. font copuld beei‐
ther a standard X11 font definition, or a filename of the True‐
Type font that could be found in FontPath. To specify the size
of the TrueType font - use format like that : FontName.ttf-Size.
Example :
Font DefaultSans.ttf-14
ForeColor color
Specifies the text color associated with this style. color is
color definition in one of the color formats supported by After‐
Step.
Inherit " style_name "
Specifies a MyStyle to inherit options from. Options from
style_name will override previously specified options for this
style. Inherit is a good way to save memory and network band‐
width if the same BackPixmap is used for several styles, as the
pixmap will only be loaded for the inherited style.
MyStyle " style_name "
style_option
~MyStyle
Specifies the beginning of a look style definition. The style
can be referred to later by style_name . ~MyStyle ends a look
style definition.
Overlay
FIXME: add proper description here.
SliceXEnd val
When used with scalable BackPixmap it will make image sliced
instead scaled. Which means that its borders will remain
unchanged, but center part will get tiled to fill empty space.
SliceXEnd is the left edge of the right border.
SliceXStart val
When used with scalable BackPixmap it will make image sliced
instead scaled. Which means that its borders will remain
unchanged, but center part will get tiled to fill empty space.
SliceXStart is the width of the left border.
SliceYEnd val
When used with scalable BackPixmap it will make image sliced
instead scaled. Which means that its borders will remain
unchanged, but center part will get tiled to fill empty space.
SliceYEnd is the top edge of the bottom border.
SliceYStart val
When used with scalable BackPixmap it will make image sliced
instead scaled. Which means that its borders will remain
unchanged, but center part will get tiled to fill empty space.
SliceYStart is the height of the top border.
TextStyle style
Specifies the text style associated with this style. style can
be 0, 1, or 2:
0: normal text
1: embossed 3D text
2: sunken 3D text
3: text has shade above the text
4: text has shade below the text
5: thick embossed 3D text
6: thick sunken 3D text
7: text is outlined with contrasting color on upper edge of a glyph.
8: text is outlined with contrasting color on bottom edge of a glyph.
9: text is outlined with contrasting color all around a glyph.
DESCRIPTIONMyStyle 's are the means to define how widgets (menu items, titlebars,
wharf buttons, Pager desktops, etc. ) should be rendered. It defines
widget's background (solid color, gradient, textured image and/or semi‐
transparent texture), shape - making widget non-rectangular, text font,
text 3D style, widget's border bevel colors.
All the GUI elements are rendered using consistent approach in every
module and every part of the AfterStep. Interface is build from so
called TBars. TBar is rectangular area that may be focused(hilited) or
unfocused and pressed or unpressed. TBAR STRUCTURE Each TBar has the
following structure :
- the background of the TBar, which is defined by MyStyle and state of
the bar - there are two MyStyles assigned to each TBar - one for
focused and one for unfocused state.
- tiles of the TBar. Tiles are smaller features that gets arranged
inside the bar according to its size, alignment, position and order.
Tiles could be static icons ( cannot be pressed ); blocks of buttons -
each having two shapes - pressed and normal; Text labels; Empty space
tiles. There could be upto 256 tiles, each residing on one of the cells
in 8x8 grid. Several tiles could reside in single cell, in which case
they get superimposed on top of each other.
- bevel of the TBar. When TBar is rendered all of its tiles are super‐
imposed on top of its background, and resulting image will have a 3D
bevel drawn on it, using colors from same MyStyle as used for back‐
ground. Bevel could be switched off partially or entirely. Respective
configuration options has been added where appropriate. When TBar is
pressed - its bevel is inverted. TBAR RENDERING When TBar is rendered
all of its elements gets superimposed on top of each other using one of
13 blending methods supported by libAfterImage, with default being sim‐
ple alphablending. See MyFrame configuration for more details. This is
refrred to as "Composition Method".
3rd Berkeley Distribution AfterStep v.2.2.11MyStyle(1)