MyFrame(1) AfterStep X11 window manager MyFrame(1)
NAME
MyFrame - defines how AfterStep should construct window's frame
CONFIGURATION OPTIONS
AllowBorder
Denotes that beveled borders should be drawn around the window
frame and titlebar. This is on by default, so this option is
only useful in combination with inheriting previously defined
window frames.
See Also: Inherit MyFrame for details.
CondenseTitlebar
Left|Right|Center Allows titlebars to be smaller then the size of the window.
The parameter defines the Alignment of the whole titlebar.
See Also: Alignment flags for further details.
Corner
[ SouthEast | SouthWest | NorthEast | NorthWest ] "pixmap_name" Specifies the corner of the window frame to be decorated and
the pixmap to be used.
CornerAlign
FIXME: add proper description here.
See Also: Alignment flags for further details.
CornerBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the default bevel of a window s frame corners.
If you need different bevels for the different window states,
use CornerFocusedBevel, CornerUnfocusedBevel,
CornerStickyBevel
See Also: Bevel flags for further details.
CornerFBevel
Alias for CornerFocusedBevel.
See Also: Bevel flags for further details.
CornerFocusedBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the bevel of the window s frame corners while window is
in focused state.
If this is not used, values set with CornerBevel will be used.
See Also: Bevel flags for further details.
CornerSBevel
Alias for CornerStickyBevel.
See Also: Bevel flags for further details.
CornerSize
NorthEast|SouthEast|NorthWest|SouthWest|Any WIDTHxHEIGHT FIXME: add proper description here.
CornerStickyBevel
NorthEast|SouthEast|NorthWest|SouthWest|Any None|[Left,Top,Right,Bottom,Extra,NoOutline] Sets the bevel of the window s frame corners while window is
in sticky state. This overwrites any value set with
CornerBevel.
If this is not used, values set with CornerBevel will be used.
See Also: Bevel flags for further details.
CornerUBevel
Alias for CornerUnfocusedBevel.
See Also: Bevel flags for further details.
CornerUnfocusedBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the bevel of the window s frame corners while window is
in unfocused state.
If this is not used, values set with CornerBevel will be used.
See Also: Bevel flags for further details.
East
"pixmap_name" Specifies the pixmap to be displayed in the right border of
the window frame, if DecorateFrames is set.
FrameFStyle
MyStyle Alias for FrameFocusedStyle.
FrameFocusedStyle
MyStyle Defines the MyStyle to apply to the window frame if window is
in focused state.
FrameSStyle
MyStyle Alias for FrameStickyStyle.
FrameStickyStyle
MyStyle Defines the MyStyle to apply to the window frame if window is
in sticky state.
FrameUStyle
MyStyle Alias for FrameUnfocusedStyle.
FrameUnfocusedStyle
MyStyle Defines the MyStyle to apply to the window frame if window is
in unfocused state.
Inherit
frame_name Specifies a MyFrame to inherit options from. Options from
frame_name will override previously specified options for this
frame. Inherit is a good way to save memory and network
bandwidth if the same BackPixmap is used for several frames,
as the pixmap will only be loaded for the inherited frame.
InheritDefaults
FIXME: add proper description here.
LeftBtnAlign
Defines the alignment of the left buttons in the titlebar.
See Also: Look Alignment flags for further details.
LeftBtnBackAlign
Defines the alignment of the background of the left buttons.
See Also: Alignment flags for further details.
LeftBtnBackground
Defines the background to be used for the left buttons.
LeftSpacerBackAlign
Defines the alignment of the background of the (by default)
leftmost spacer of the titlebar.
See Also: Alignment flags for further details.
LeftSpacerBackground
Defines the background to be used for the (by default)
leftmost spacer of the titlebar.
See Also: Titlebar Layout for further details.
LeftTitleSpacerBackAlign
Defines the alignment of the background of the (by default)
inner spacer, left of the window title.
See Also: Alignment flags for further details.
LeftTitleSpacerBackground
Defines the background of the (by default) inner spacer, left
of the window title.
LeftTitlebarLayout
[Buttons] | [Spacer] | [TitleSpacer] Defines the order of the elements in the titlebar left of the
window title, where default is Spacer - Buttons - TitleSpacer.
See Also: Titlebar Layout Flags for further details.
MyFrame "
frame_name "
frame_option ~MyFrame
Specifies the beginning of a frame definition. The frame can
be referred to later by
frame_name .
~MyFrame ends a frame
definition.
NoBorder
Denotes that beveled borders should not be drawn around the
window frame and titlebar.
NoCorner
FIXME: add proper description here.
NoSide
FIXME: add proper description here.
North
"pixmap_name" Specifies the pixmap to be displayed in the top border of the
window frame, if DecorateFrames is set.
NorthEast
"pixmap_name" Specifies the pixmap to be displayed in the top right corner
of the window frame, if DecorateFrames is set.
NorthWest
"pixmap_name" Specifies the pixmap to be displayed in the top left corner of
the window frame, if DecorateFrames is set.
RightBtnAlign
Defines the alignment of the right buttons in the titlebar.
See Also: Look Alignment flags for further details.
RightBtnBackAlign
Defines the alignment of the background of the right buttons.
See Also: Alignment flags for further details.
RightBtnBackground
Defines the background to be used for the right buttons.
RightSpacerBackAlign
Defines the alignment of the background of the (by default)
rightmost spacer of the titlebar.
See Also: Alignment flags for further details.
RightSpacerBackground
Defines the background to be used for the (by default)
rightmost spacer of the titlebar.
See Also: Titlebar Layout for further details.
RightTitleSpacerBackAlign
Defines the alignment of the background of the (by default)
inner spacer, right of the window title.
See Also: Alignment flags for further details.
RightTitleSpacerBackground
Defines the background of the (by default) inner spacer, right
of the window title.
RightTitlebarLayout
[Buttons] | [Spacer] | [TitleSpacer] Defines the order of the elements in the titlebar left of the
window title, where default is TitleSpacer, Buttons, Spacer.
See Also: Titlebar Layout Flags for further details.
Side
[ South | North | East | West ] "pixmap_name" Specifies the side of the window frame to be decorated and the
pixmap to be used.
SideAlign
FIXME: add proper description here.
See Also: Alignment flags for further details.
SideBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the default bevel of a window s frame sides.
If you need different bevels for the different window states,
use SideFocusedBevel, SideUnfocusedBevel, SideStickyBevel
See Also: Bevel flags for further details.
SideFBevel
Alias for SideFocusedBevel.
See Also: Bevel flags for further details.
SideFocusedBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the bevel of the window s frame sides while window is in
focused state.
If this is not used, values set with SideBevel will be used.
See Also: Bevel flags for further details.
SideSBevel
Alias for SideStickyBevel.
See Also: Bevel flags for further details.
SideSize
FIXME: add proper description here.
SideSlicing
FIXME: add proper description here.
SideStickyBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the bevel of the window s frame sides while window is in
sticky state.
If this is not used, values set with SideBevel will be used.
See Also: Bevel flags for further details.
SideUBevel
Alias for SideUnfocusedBevel.
See Also: Bevel flags for further details.
SideUnfocusedBevel
Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top Sets the bevel of the window s frame sides while window is in
unfocused state.
If this is not used, values set with SideBevel will be used.
See Also: Bevel flags for further details.
South
"pixmap_name" Specifies the pixmap to be displayed in the bottom border of
the window frame, if DecorateFrames is set.
SouthEast
"pixmap_name" Specifies the pixmap to be displayed in the bottom right
corner of the window frame, if DecorateFrames is set.
SouthWest
"pixmap_name" Specifies the pixmap to be displayed in the bottom left corner
of the window frame, if DecorateFrames is set.
TitleAlign
FIXME: add proper description here.
See Also: Alignment flags for further details.
TitleBackground
Defines the background to be used for the window title.
TitleBackgroundAlign
Defines the alignment of the background of the window title.
See Also: Alignment flags for further details.
TitleBevel
Determines the bevel to be drawn around the title bar. If you
wish to have different bevels, depending on the window s
state, use TitleFocusedBevel, TitleUnfocusedBevel or
TitleStickyBevel.
See Also: Bevel flags for further details.
TitleCompositionMethod
FIXME: add proper description here.
TitleFBevel
Alias for TitleFocusedBevel.
See Also: Bevel flags for further details.
TitleFCompositionMethod
Alias for TitleFocusedCompositionMethod.
TitleFHue
Alias for TitleFocusedHue.
TitleFSaturation
Alias for TitleFocusedSaturation.
TitleFStyle
MyStyle Alias for TitleFocusedStyle.
TitleFocusedBevel
Determines the bevel to be drawn around the title bar if
window is in focused state.
See Also: Bevel flags for further details.
TitleFocusedCompositionMethod
FIXME: add proper description here.
TitleFocusedHue
FIXME: add proper description here.
TitleFocusedSaturation
FIXME: add proper description here.
TitleFocusedStyle
MyStyle MyStyle to apply to titlebar if window is in focused state.
TitleHSpacing
value Defines the space in pixel to insert between window title and
the buttons/spacers. Please note that CondenseTitlebar is
influencing the behaviour of this option.
TitleSBevel
Alias for TitleStickyBevel.
See Also: Bevel flags for further details.
TitleSCompositionMethod
Alias for TitleStickyCompositionMethod.
TitleSHue
Alias for TitleStickyHue.
TitleSSaturation
Alias for TitleStickySaturation.
TitleSStyle
MyStyle Alias for TitleStickyStyle.
TitleStickyBevel
Determines the bevel to be drawn around the title bar if
window is in unfocused state.
See Also: Bevel flags for further details.
TitleStickyCompositionMethod
FIXME: add proper description here.
TitleStickyHue
FIXME: add proper description here.
TitleStickySaturation
FIXME: add proper description here.
TitleStickyStyle
MyStyle MyStyle to apply to titlebar if window is in sticky state.
TitleUBevel
Alias for TitleUnfocusedBevel.
See Also: Bevel flags for further details.
TitleUCompositionMethod
Alias for TitleUnfocusedCompositionMethod.
TitleUHue
Alias for TitleUnfocusedHue.
TitleUSaturation
Alias for TitleUnfocusedSaturation.
TitleUStyle
MyStyle Alias for TitleUnfocusedStyle.
TitleUnfocusedBevel
Determines the bevel to be drawn around the title bar if
window is in unfocused state.
See Also: Bevel flags for further details.
TitleUnfocusedCompositionMethod
FIXME: add proper description here.
TitleUnfocusedHue
FIXME: add proper description here.
TitleUnfocusedSaturation
FIXME: add proper description here.
TitleUnfocusedStyle
MyStyle MyStyle to apply to titlebar if window is in unfocused state.
TitleVSpacing
value West
"pixmap_name" Specifies the pixmap to be displayed in the left border of the
window frame, if DecorateFrames is set.
Window frame decorations (aka MyFrame)
Each window is surrounded by so-called frame decoration. each
frame decoration could be built from 9 TBars:
1) Main Titlebar with icons on left, label in the middle and
icons on right. Label may also have special underlying image -
so called Title Background. Ordering of this elements is set
by TitleButtonOrder setting ( see below ).
2) 4 frame sides. Each of this have fixed width that is
determined by SideSize setting or image size if SideSize is
ommited. Second dimension of the TBar changes to match the
size of the window.
3) 4 frame corners. Each of this have both fixed width and
height, as determined by CornerSize setting or image size.
Each of above elements is rendered by generating background
using respective MyStyle, and then overlaying images/buttons
and text on top of it. Default overlaying is done using
composition method alpha-blend. In case of main Titlebar that
could be changed. Bevel is then drawn on top of the image as
specified in respective setting.
MyFrame allows different MyStyles to be used for titlebar and
frame decorations. If any of those are ommited - default
setting from FWindowStyle/UWindowStyle/SWindowStyle will be
used.
Important: If you use semi-transparent images for frame sides
- they will be overlayed on top of MyStyle generated
background, so if you want it to be overlayed over root
background - you should use MyStyle with BackPixmap set to 129
or 149.
Also note that unless you use MYStyle with BackPixmap 126 and
125 - frame decorations will not be shaped. Likewise if you
want frame part to have only the shape of the image, you
specified, with no background at all - use MyStyle with
BackPixmap set like so :
BackPixmap 126 empty.xpm
Where empty.xpm is 1x1 completely transparent image (supplied
as desktop/icons/common/empty.xpm ).
To identify side/corner it is possible to use abbreviations,
such as: N, NW, SW, etc.
All the CompositionMethod settings must have one of the
BackPixmap types from MyStyles ( ie 130-143 )
Align setting may have different meaning/capabilities for
different items. When applied to text - it simply aligns text
to sides mentioned. When applied to image - such as title
background or frame side pixmap - it also specifies if image
should be tiled, scaled or left same size. Make sure that you
use HTiled,VTiled or HScaled,VScaled for frame sides -
otherwise images on they will not be resized to match window
size (this is also a feature :).
To center item specify Align to include both sides. For
example :
Align Left,Right
will center item horizontally.
Note that TitleBackground option allows you to specify an
image to be used under titlebar label in addition to the
MyStyle. This was done for better shaped titlebars. You may
have MyStyle to be completely transparent shape, while
TitleBackground some non-transparent image, and that will
provide better visibility for the titlebar text.
MyFrame "name"
Inherit "name"]
#traditional form :
[North ] [East ]
[South ] [West ]
[NorthEast ]
[NorthWest ]
[SouthEast ] [SouthWest ]
#alternative form : [Side
North|South|East|West|Any []] if pixmap is ommited -
empty bevel will be drawn
[NoSide North|South|East|West|Any]
[Corner
NorthEast|SouthEast|NorthWest|SouthWest|Any ] if pixmap is
ommited - empty bevel will be drawn
[NoCorner
NorthEast|SouthEast|NorthWest|SouthWest|Any]
#new settings :
[TitleUnfocusedStyle ]
[TitleFocusedStyle ]
[TitleStickyStyle ]
[FrameUnfocusedStyle ]
[FrameFocusedStyle ]
[FrameStickyStyle ]
[TitleBackground ] gets overlayed over
background and under the text
[LeftBtnBackground ] gets overlayed over
background and under the left block of buttons
[LeftSpacerBackground ] gets overlayed over
background between left block of buttons and text label
[RightSpacerBackground ] gets overlayed over
background between right block of buttons and text label
[RightBtnBackground ] gets overlayed over
background and under the right block of buttons
#additional attributes : [SideSize
North|South|East|West|Any
3rd Berkeley Distribution AfterStep v.2.2.12 MyFrame(1)
