Wharf(1) AfterStep X11 window manager Wharf(1)NAMEWharf - AfterStep module for launching or docking applications aka but‐
ton bar Module:Wharf sound definition
SYNOPSISWharf [ standard options ]
MyStyle DEFINITIONS
MyStyle "*WharfTile"
Specifies the style of the wharf button tiles, including back‐
ground color, background pixmap (which may be transparent), and
background gradient. This method of specifying the background is
preferred over the BgColor, MaxColors, Pixmap, TextureColor, and
TextureType options, although those (older) options do still
work. See MyStyle format for details.
MyStyle "*WharfOddTile"
Specifies the style of every odd wharf button tile. See MyStyle
format for details.
MyStyle "*WharfFocusedTile"
Specifies the style of the wharf button tile under the mouse
pointer, including background color, background pixmap (which
may be transparent), and background gradient. See MyStyle format
for details.
MyStyle "*WharfOddFocusedTile"
Specifies the style of every odd wharf button tile under the
mouse pointer. See MyStyle format for details.
CONFIGURATION OPTIONS
AlignContents Left,Top,Right,Bottom,HTiled,VTiled,HScaled,VScaled,HCen‐
ter,VCenter
That will force contents of each Wharf's button to be aligned to
either side of the button, when FitContents is not used.
See Also: Alignment flags for further details.
Animate
If specified, the opening and closing of Folders will be ani‐
mated, rather than simply drawn in one frame.
AnimateDelay
Specifies the delay in milliseconds that the animation will
pause between each move when opening or closing a folder.
AnimateMain
Designates that full-length Wharf withdraws will be animated.
AnimateSteps
Specifies the steps a Folder takes in animating while opening or
closing. This translates into the Folder button moving button-
size/ steps pixels each step.
AnimateStepsMain
Specifies the steps the main Wharf takes in iconification or de-
iconification upon mouse button 3 being pressed. This translates
into the main Wharf moving <button-size>/ steps pixels each
step.
BalloonBorderHilite
Defines bevel to be drawn around balloons - replaces the Border‐
Width setting.
See Also: Bevel flags for further details.
BalloonCloseDelay number
Specifies the period in milliseconds to delay the disappearance
of the balloon when leaving window with the mouse.
BalloonDelay number
Specifies the period in milliseconds to delay the appearance of
the balloon.
BalloonStyle MyStyle
MyStyle to be used to draw balloon. Note that balloons could be
shaped (BackPixmap 125 and 126).
BalloonTextPaddingX size
width of the border around the text in balloons.
BalloonTextPaddingY size
height of the border around the text in balloons.
BalloonXOffset
The balloon window is positioned to be horizontally centered
against the Wharf window it is describing. The horizontal posi‐
tion may be set as an offset. Negative offsets of-Nare placed N
pixels left of the Wharf window, positive offsets of +N are
placed N pixels right of the window. Defaults to +2.
BalloonYOffset
The balloon window is positioned to be horizontally centered
against the Wharf window it is describing. The vertical position
may be set as an offset. Negative offsets of-Nare placed N pix‐
els above the Wharf window, positive offsets of +N are placed N
pixels below. Defaults to +2.
Balloons
Turns on the balloon feature. A "balloon" is displayed showing
the name of the button the pointer is resting on in the Wharf .
The balloon background and text are configured with the MyStyle
"*WharfBalloon". See afterstep(1x) for more information on
MyStyles.
Bevel None|[Left,Top,Right,Bottom,Extra,NoOutline]
Determines exact size and shape of the 3D bevel drawn around
each button. This option is somewhat synonymous to NoBorder. If
NoBorder is encountered after Bevel - then it will override
Bevel, otherwise Bevel will override NoBorder.
See Also: Bevel flags for further details.
Columns
Specifies the number of columns of buttons to be created. This
will give your Wharf a vertical layout, with the number of col‐
umns equal to the number specificed in columns . If unspecified,
the number of columns will be set to 1. If the columns are set
to a number greater than 1, then there will be that number of
columns with enough rows to satisfy the requested number of but‐
tons. Only one of *WharfRows or *WharfColumns should be speci‐
fied.
CompositionMethod testure_type
Determines algorithm used to blend all the icons and Wharf back‐
ground to form the button's image. Valid es are 130-145 ( see
MyStyles section ). The default value is 131 ( alpha-blending )
FitContents
Wharf will draw each button so that it fits its contents per‐
fectly (icon or swallowed app ). That will cause some of the
Wharf's buttons to differ in size from others. Use in conjunc‐
tion with ShapeToContents.
FlipLabel
Will cause Wharf to draw vertical label text.
FolderOffset size
sets the distance between opened folder and its parent.
ForceSize Size
If specified, will force pixmaps to Size instead of the default
of 64x64. This has no effect on the Size of the displayed icons
(they will be croped if larger).
Geometry
Specifies the Wharf window location and/or size. If the size is
not specified, Wharf will auto-size itself in a reasonable man‐
ner. The geometry is a standard X11 window geometry specifica‐
tion; see XParseGeometry(3x) , and EXAMPLES (below) for further
details.
LabelLocation number
Specifies the location of the label. Correct values are integers
from 0-32. label could be drawn on each side of the button and
just on top of icon. It could also be aligned to different
sides.
MyStyle
Specifies the style of the wharf button tiles, including back‐
ground color, background pixmap (which may be transparent), and
background gradient. This method of specifying the background is
preferred over the BgColor, MaxColors, Pixmap, TextureColor, and
TextureType options, although those (older) options do still
work.
See Also: MyStyle definition for further details.
NoBalloons
FIXME: add proper description here.
OrthogonalFolderOffset size
sets the offset of an opened folder relative to its parent
orthogonal to the opening direction. In other words this can be
used to move the opened folder parallel to its parent
Rows
Specifies the number of rows of buttons to be created. This will
give your Wharf a horizontal layout, with the number of rows
equal to the number specified in rows . If unspecified, the num‐
ber of rows will be set to 1. If the rows are set to a number
greater than 1, then there will be that number of rows with
enough columns to satisfy the requested number of buttons. Only
one of *WharfRows or *WharfColumns should be specified.
ShapeToContents
Will cause Wharf to use X Shaped extentions and have a window of
non-rectangular shape. Shape is composed from the overall geome‐
try of buttons ( see FitContents ), shape of the MyStyle used to
draw Wharf background ( if BackPixmap 126 or 125 is used ), con‐
tents of each button - such as swallowed app's shape, label and
icons.
ShowHints
FIXME: add proper description here.
See Also: Balloon Contents flags for further details.
ShowLabel
Tells Wharf to render a label on each of its buttons, effec‐
tively immitating the behaviour of the discontinued Zharf mod‐
ule.
Sound
FIXME: add proper description here.
See Also: Wharf sound definition for further details.
StretchBackground
This should allow for all kinds of skins where each button is
just a part of large shaped figure.
WithdrawStyle
Specifies the circumstances under which button 3 should cause
the Wharf to withdraw to a corner. If style is 0, button 3 will
do nothing. If style is 1 (the default), a click on any button
in the toplevel bar will cause Wharf to withdraw to the nearest
corner. If style is 2, a click on either the first or the last
button in the toplevel bar will cause the withdrawal.
3rd Berkeley Distribution AfterStep v.2.2.11Wharf(1)