Pager(1)                 AfterStep X11 window manager                 Pager(1)



NAME
       Pager - AfterStep module for virtual desktop navigation PagerDecoration
       options Pager[standard options]first_desktoplast_desktop BASE
       CONFIGURATION OPTIONSThe following two configuration options are in
       thebasefile:*DeskTopSizeColumns x RowsDefines the number of
       viewColumnsby the number of viewRowsof the desk(s) in proportional
       units, i.e. 2x1 would show 2 views of one desk, one beside
       another.*DeskTopScalenumberIf the geometry is not specified, then a
       desktop reduction factor is used to calculate the pager's size. Things
       in the pager window are shown at 1/numberof the actual size.  MyStyle
       DEFINITIONSStarting with version 1.7.60 Pager supports definition of
       most of it's visual parameters in look file as MyStyles. Styles can
       also be defined in pager config file, but main contents of the look
       file will override them. Include them in your pager config to make sure
       that you get nice looking Pager even if styles are not defined in look
       file. The following standard MyStyle names are used
       :*PagerUWindowStyle(defaults to "unfocused_window_style") - unfocused
       window representation's style. Background pixmap and gradient can be
       used here.*PagerFWindowStyle(defaults to "focused_window_style") -
       focused window representation's style. Background pixmap and gradient
       can be used here.*PagerSWindowStyle(defaults to "sticky_window_style")
       - sticky window representation's style. Background pixmap and gradient
       can be used here.*PagerActiveDeskactive (selected) desk's label style.
       This style - defines only look of the desk's LABEL - to define how your
       actual desk window will look like - you should use*PagerStyleoption -
       see below. Background pixmap, gradient and transparency can be used
       here.*PagerInActiveDeskSame as above, only for inactive desk's label.
       Background pixmap, gradient and transparency can be used here.


CONFIGURATION OPTIONS
       ActiveDeskBevelDefines how border around Pager desk representation of
       the current desk should be drawn.See Also:Bevel flagsfor further
       details.*PagerActiveDeskBevel Left,Top# draws thick bevelled lines at
       the top and left of the desk AlignDefines how Pager's desk title should
       be aligned on desk titlebar. SeeAlign optionsfor further
       details.*PagerAlign Center# places title in the center both vertically
       and horizontally BalloonBorderHiliteDefines the bevel to be drawn
       around balloons - replaces the BorderWidth setting.See Also:Bevel
       flagsfor further details.  BalloonCloseDelaynumberSpecifies the period
       in milliseconds to delay the disappearance of the balloon when leaving
       window with the mouse.  BalloonDelaynumberSpecifies the period in
       milliseconds to delay the appearance of theballoon.
       BalloonStyleMyStyleMyStyle to be used to draw balloon. Note that
       balloons could be shaped (BackPixmap 125 and 126).  BalloonTextPaddingX
       sizewidth of the border around the text in balloons.
       BalloonTextPaddingY sizeheight of the border around the text in
       balloons.  BalloonXOffsetoffsetSpecifies the horizontal offset (in
       pixels) to use when displaying balloons.  BalloonYOffsetoffsetThe
       balloon window is positioned to be horizontally centered against the
       application window it is describing. The vertical position may be set
       as an offset. Negative offsets of -N are placed N pixels above the
       pager window, positive offsets of +N are placed N pixels below.
       Defaults to +2.  BalloonsTurns on the balloon feature. A "balloon" is
       displayed showing the name of the window the pointer is resting on in
       thePager. Currently only the window's icon name is shown. Note that
       balloons are not shown for the iconified pager. The balloon background
       and text are configured with the MyStyle "*PagerBalloon".See
       Also:MyStyle definitionfor details.  ColumnsTells afterstep how many
       columns of desks to use when laying out the pager window. Set to 1 for
       vertical Pager and define PagerRows.
       Decorationparam1[,param2[,...]]Allows you to decorate your pager to
       your liking. The following parameters can be specified : NoDeskLabel,
       NoPageSeparator, NoSelection, SelectionColor, GridColor,
       DeskBorderWidth, DeskBorderColor, LabelBelowDesk, HideInactiveLabels,
       VerticalLabel.See Also:Pager Decoration optionsfor further details.
       DontDrawBgIf specified, will not display background image, use this
       with xearth or xfishtank.Please note that this is deprecated, use
       DontDrawBackground (Look option) instead.  GeometryCompletely or
       partially specifies the pager window location and geometry, in standard
       X11 notation. In order to maintain an undistorted aspect ratio, you
       might want to leave out either the width or height dimension of the
       geometry specification.  IconGeometrySpecifies a size (optional) and
       location (optional) for the pager's icon window. Since there is no easy
       way for Pager to determine the height of the icon's label, you will
       have to make an allowance for the icon label height when using negative
       y-coordinates in the icon location specification (used to specify a
       location relative to the bottom instead of the top of the screen).
       InActiveDeskBevelDefines how border around Pager desk representation of
       the inactive desk(s) should be drawn.See Also:Bevel flagsfor further
       details.  LabelAssigns the text label to desk desk in the pager window.
       Useful for assigning symbolic names to desktops MyStyleStyles for
       different Pager properties are called from the file "pager", and the
       associated MyStyle definitions are located in a selected Look file.
       Fonts, foreground and background colors, gradients, pixmaps, and
       transparencies can be specified for Pager's components.See Also:MyStyle
       definitionfor further details.  NoBalloonsFIXME: add proper description
       here.  RowsTells afterstep how many rows of desks to use when laying
       out the pager window. Set to 1 for horizontal Pager and define
       PagerColumns.  ShadeButton"unpressed_image"["pressed_image"]You should
       be able to "shade" row or column of desks by pressing special Shade
       button on desk's title. Define images to be used for it with this
       option. If no images are defined - then there will be no button and
       feature will be disabled.  SmallFontSpecifies a font to use to label
       the window names in the pager. It overrides font specified in
       Focused/Unfocused/Sticky window style in look file. It also displays
       text on background color - which can be usefull if BackPixmap is
       specified in window style. Window labels seem to be fairly useless for
       desktop scales of 32 or greater.  StartIconicCauses the pager to start
       iconified.  StickyIconsSpecifies that icons should stick to the
       screen's glass and follow it from desk/view to desk/view.  Styledesk
       styleSets the style to be used for the desk desk representation in the
       Pager. Where style can be the name of any style definition in the look
       file, and desk is a number coresponding to the desktop number:
       0,1,2,3,N.... Use it if you want to specify a different style for Pager
       background other than the default; which is the scaled down
       *PagerDesktopImage.  USAGEAlthoughPagercan be run from the command
       line, it is normally spawned by afterstep in theautoexecfile, in the
       following manner:Module "I" Pager beginning_desktop# ending_desktop#
       Wait "I" PagerIn case you use Pager to switch your root
       backgroundsWaitcan be used as shown above. This will insure that
       thePagerhas set the root background before you start any furthur apps
       (like transparent aterms and Eterms).or from within an afterstep menu
       file by 'Pager':% cat "~/.afterstep/start/Modules/Pager" Module "Pager"
       Pager first_desktop last_desktop MiniPixmap "mini-as.xpm"To stop
       thePagermodule, a menu item can be used:% cat
       "~/.afterstep/start/Modules/Pager_Stop" KillModuleByName "Stop Pager"
       Pager MiniPixmap "mini-as.xpm"DESCRIPTIONThePagermodule shows a
       miniature view of the Afterstep desktops which are specified in the
       command line. This is a useful reminder of where your active windows
       are. Windows in the pager are accordingly to MyStyle definitions
       "*PagerUWindowStyle" - for unfocused windows, "*PagerFWindowStyle" -
       for focused windows and "*PagerSWindowStyle" - for sticky windows. If
       you never defined those MyStyles, Pager will default to same styles as
       used for actual windows.ThePagercan be used to change your viewport
       into the current desktop, to change desktops, or to move windows
       around.Pressing mouse button 1 or 2 in thePagerwill cause your viewport
       to change to the selected page of the selected desk. If you click with
       button 1 in the desk-label area, you will switch desks but not pages
       within the desk.Clicking and dragging with mouse button 2 on a
       miniature window in thePagerwill cause that window to be move to the
       location where you release the mouse button, but your viewport will not
       change. If you drag the window out of the pager and onto your desktop,
       a full size image of the window will appear for you to place. There is
       no way to pick up a full size image of the window and move it into
       thePager, however. Since some mice do not have button 2, provisions
       have been made to drag windows in thePagerby pressing modifier-1
       (usually Alt) and dragging with button 3.When iconified, the pager will
       work as a fully functional current page only pager. Windows and
       viewports can be moved within the icon of the pager. Users will want to
       make sure that they have no lines similar toStarting with version
       1.7.122 Pager no longer loads background images into the memory. Module
       asetroot should be used to accomplish that task. But Pager will still
       be able to switch backgrounds as you switch between desks, after you've
       run asetroot to load images. Use *PagerDontDrawBg option in pager
       config file to TURN background switching OFF.See asetroot man page for
       more information.Style "Pager" Icon myIcon.[xpm|jpg|png]in their feel
       files.INITIALIZATIONDuring initialization,Pagerwill search for a
       configuration file which describes the images, locations and actions to
       take. This file will be the one specified by the-foption (if given).
       Else, the ~/.afterstep/pager file will be used if it exists. Else,
       /usr/local/share/afterstep/pager will be used.If thePagerexecutable is
       linked to another name, ie ln -sPagerOtherPager, then another module
       calledOtherPagercan be started, with a completely different set of
       configurations thanPager, simply by adding*OtherPageroptions following
       the same*Pagerconfiguration options below to thepagerfile. This way
       multiple Pager programs can be used.KEYBOARD FOCUS CONTROLYou can
       direct the keyboard focus to any window on the current desktop by
       clicking with button 2 on its image in the pager. The window does not
       need to be visible, but it does need to be on the current
       page.INVOCATIONPagercan be invoked from theautoexecfile or from a menu
       item as shown in the Synopsis section above.AfterStep will search
       through the directories specified in theModulePathconfiguration in
       thebase(where # is your colordepth) to attempt to
       locatePager.CONFIGURATION FILESPagerreads thebasefile andpagerfile when
       it starts up and looks for its configuration options.





3rd Berkeley Distribution      AfterStep v.2.2.9                      Pager(1)
