Wharf-classic.1x

Langue: en

Version: 314959 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

Wharf-Classic - the AfterStep Classic application "dock" module

SYNOPSIS

Wharf-Classic is spawned by asclassic, so no command line invocation will work.

DESCRIPTION

The Wharf-Classic module is a free-floating application loader that can execute programs, "Swallow" running programs, and contain "Folders" of more applications, among other things. The user can press the first button at any time to trigger invocation of one of these functions, or the user can press button two in order to cause the entire Wharf-Classic to withdraw to the nearest corner in an iconized state. Wharf-Classic only works when asclassic is used as the window manager.

COPYRIGHTS

The Wharf-Classic module is copyright 1995 and 1996 by a variety of contributors. They are, in alphabetical order, Beat Christen, Frank Fejes, Alfredo Kenji Kojima, Dan Weeks, and Bo Yang

The GoodStuff program, and the concept for interfacing this module to the Window Manager, are all original work by Robert Nation

No guarantees or warranties or anything are provided or implied in any way whatsoever. Use this program at your own risk. Permission to use this program for any purpose is given, as long as the copyright is kept intact.

INITIALIZATION

During initialization, Wharf-Classic will search for a configuration file which describes the button panel geometry, color, icons, and actions. The format of this file will be described later. The configuration file will be the one which asclassic used during its initialization.

If the Wharf executable is linked to another name, ie ln -s Wharf Pier, then another module called Pier can be started, with a completely different configuration than Wharf-Classic, simply by changing the keywords Wharf??? to Pier???. This way multiple button-bars can be used.

INVOCATION

Wharf-Classic can be invoked by inserting the line 'Module Wharf' in the .steprc file. This can be placed on a line by itself, if Wharf-Classic is to be spawned during AfterStep Classic's initialization, or can be bound to a menu or mouse button or keystroke to invoke it later. AfterStep Classic will search directory specified in the ModulePath configuration option to attempt to locate Wharf-Classic.

CONFIGURATION OPTIONS

The following options can be placed in the .steprc file
*WharfAnimate
If specified, the opening and closing of Folders will be animated, rather than simply drawn in one frame.
*WharfAnimateMain
Designates that full-length Wharf windraws will be animated.
*WharfBgColor color
If *WharfTextureType 0 is specified, Wharf's buttons will be filled with color.
*WharfColumns columns
Specifies the number of columns of buttons to be created. 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 buttons.
*WharfForceSize
If specified, will force pixmaps larger than 64x64 to the default size. Pixmaps smaller than 64x64 are not supported.
*WharfFullPush
If specified, the entire Wharf button background will be moved down and to the right when pushed. Especially useful with *WharfNoBorder textures.
*WharfGeometry geometry
Specifies the Wharf window location and/or size. If the size is not specified, Wharf will auto-size itself in a reasonable manner. The geometry is a standard X11 window geometry specification; if you change it, you may wish to adjust the arguments passed to AfterStep's Maximize command so that maximized windows will avoid covering the Wharf. The geometry is pre-set in the NEXTSTEP(tm) style section for a consistent look and feel with NEXTSTEP(tm). Secondary Wharf invocations from links may have their own geometry.
*WharfMaxColors number
Specifies the maximum number of colors to use on a gradient fill.
*WharfNoBorder
Denotes that beveled borders should not be drawn around the Wharf button. Useful with textures that include their own bevels.
*WharfPixmap pixmap
Sets the pixmap file to be used as Wharf's button. To be used with *WharfTextureType 128.
*WharfTextureColor from to
When used with a *WharfTextureType of 1 to 5, designates the ends of the gradient range to be used on Wharf's buttons.
*WharfTextureType type
Specifies the type of gradient fill to be used on Wharf's buttons. Valid values are:
 0 - No texture - use WharfBgColor to set the desired color
 1 - Gradient from upper-left to lower right
 2 - Horizontal one way gradient from top to bottom
 3 - Horizontal cylindrical gradient from top/bottom to center
 4 - Vertical one way gradient from left to right
 5 - Vertical cylindrical gradient from left/right to center
 128 - User specified pixmap
 
The default is the builtin Wharf-Classic texture pixmap.
*Wharf label icon command
Specifies a window manager built-in command or folder to activate (folders will be discussed below), as described in the asclassic man page, which should be executed when a button is pressed. The label field is an internal item that is still around from the GoodStuff module. The icon field specifies an X11 bitmap file, XPM color icon file, or a comma-delimited set of pixmaps containing the icon(s) to display on the button. Wharf will search through the path specified in the afterstep IconPath or PixmapPath configuration items to find the icon file.

NOTE: Icons must have one transparent pixel or the definition of a transparent color in order to be valid.

If command is an asclassic Exec command, then the button will appear pushed in until the mouse button is released.

A single extension to the asclassic built-in command set is provided. A command of the form:

 
 *Wharf junk clock.xpm Swallow "Clock" asclock -shape -12 &
 
 
will cause Wharf-Classic to spawn an asclock process, and capture the first window whose name or resource is "Clock", and display it in the button-bar. This is handy for applications like xclock, xbiff, xload, asclock, and asmail. Modules can be swallowed by specifying SwallowModule instead of just "swallow" NOTE: if you use xclock for this application, you will want to specify xclock -padding 0.

For certain applications that overrun the 48 pixel by 48 pixel boundary of Wharf icons and Swallowed programs there is a special option called MaxSwallow. MaxSwallow will allow the application to draw itself larger than the 48x48 boundary. It is invoked the same way Swallow is.

To create folder "slide-outs" in Wharf-Classic the following format must be used:

 
 *Wharf files Folders.xpm Folder
 *Wharf xftp 3DRings.xpm Exec "" xftp &
 *Wharf xdir FolderDeposit.xpm Exec "" xdir &
 *Wharf moxfm FilingCabinet.xpm Exec "" moxfm &
 *Wharf ~Folders
 
 
The first line of this set tells Wharf-Classic that this button definition will be a folder. All of the button definitions between the Folder and the line with the definition of *Wharf ~Folders will appear on the "files" folder when it is exposed. To expose the "files" folder simply click on the Wharf button with the Folders.xpm icon showing. A button bar will appear perpendicular to your Wharf bar and toward the center of the screen. On this smaller bar will be the three icons that were configured between the Folder and ~Folder parts of the Wharf-Classic configuration. As many folder buttons may be configured as is room on your screen. The only items that may not be configured within folders are Swallowed applications and more folders.
 

DRAG AND DROP

Wharf-Classic supports the OffiX Drag and Drop standard. In order to have Drag and Drop enabled on a particular button, the following syntax must be adhered to:
 
 *Wharf  nil      nil         DropExec "program" program %s
 *Wharf  program  iconname       Exec "program" program
 
 

The button will call program when pushed. If a file is dragged onto into it, program will be called with %s being replaced by the dropped filename.

AUTHORS

 Beat Christen (bchriste@iiic.ethz.ch)
 Frank Fejes (frank@ssax.com)
 Alfredo Kengi Kojima (kojima@inf.ufrgs.br)
 Dan Weeks (dan@mango.sfasu.edu)
 Bo Yang (eric@coeus.ucsd.edu)