.\" t .\" @(#)fvwm-2.5.30 09 May 2010 .TH FvwmIconBox 1 "09 May 2010 (2.5.30)" Fvwm "Fvwm Modules" .UC .SH NAME FvwmIconBox \- the fvwm icon box module .SH SYNOPSIS \fBFvwmIconBox\fP [\fIname\fP] FvwmIconBox is spawned by fvwm, so no command line invocation will work. .SH DESCRIPTION The FvwmIconBox module provides an icon manager. The user can do operations, like iconify and de-iconify, for each icon shown in the module via mouse and keyboard. .SH COPYRIGHTS The FvwmIconBox program is original work of Nobutaka Suzuki. Copyright 1994, Nobutaka Suzuki. 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. .SH INITIALIZATION During initialization, \fIFvwmIconBox\fP gets config info from \fBfvwm\fP's module configuration database (see .IR fvwm (1), section .BR "MODULE COMMANDS" ). If the FvwmIconBox executable is linked to another name, i.e. ln -s FvwmIconBox MoreIconBox, then another module called MoreIconBox can be started, with a completely different configuration than FvwmIconBox, simply by changing the keyword FvwmIconBox to MoreIconBox. This way multiple clutter-reduction programs can be used. .SH INVOCATION FvwmIconBox can be invoked by binding the action 'Module FvwmIconBox' to a menu or key-stroke in the .fvwm2rc file. Fvwm will search directory specified in the ModulePath configuration option to attempt to locate FvwmIconBox. .SH CONFIGURATION OPTIONS FvwmIconBox shows icons only if NoIcon is applied. Note that the NoIcon attribute should be set after the Icon attribute specification. Otherwise the icon-box module might become nothing but an empty-box module. The module reads the same .fvwm2rc file as fvwm reads when it starts up, and looks for lines as listed below: .IP "*FvwmIconBox: Fore \fIcolor\fP" Tells the module to use \fIcolor\fP instead of white for the window foreground. This option affects only the foreground color of background_bitmap specified in *FvwmIconBox: Pixmap option described below. .IP "*FvwmIconBox: Colorset \fIcolorset\fP" Tells the module to use colorset (See FvwmTheme) in place of Fore and Back. .IP "*FvwmIconBox: IconColorset \fIcolorset\fP" Tells the module to use colorset (See FvwmTheme) in place of IconFore and IconBack. .IP "*FvwmIconBox: IconHiColorset \fIcolorset\fP" Tells the module to use colorset (See FvwmTheme) in place of IconHiFore and IconHiBack. .IP "*FvwmIconBox: Back \fIcolor\fP" Tells the module to use \fIcolor\fP instead of black for the window background. .IP "*FvwmIconBox: IconFore \fIcolor\fP" Tells the module to use \fIcolor\fP instead of black for non-selected icon text. .IP "*FvwmIconBox: IconBack \fIcolor\fP" Tells the module to use \fIcolor\fP instead of white for the non-selected icon background. .IP "*FvwmIconBox: IconHiFore \fIcolor\fP" Tells the module to use \fIcolor\fP instead of black for selected icon text. .IP "*FvwmIconBox: IconHiBack \fIcolor\fP" Tells the module to use \fIcolor\fP instead of white for the selected icon background. .IP "*FvwmIconBox: Pixmap \fIpixmap\fP" Tells the module to use \fIpixmap\fP for the window background_pixmap. .IP "*FvwmIconBox: Font \fIfontname\fP" Tells the module to use \fIfontname\fP instead of fixed for text. .IP "*FvwmIconBox: SortIcons \fIoption\fP" Tells the module to sort all icons in the icon box in alphabetical order. \fIoption\fP can be \fIWindowName\fP, \fIIconName\fP, \fIResClass\fP, and \fIResName\fP. For example, specifying \fIResClass\fP means that icons are sorted by using their resource-class strings. If \fIoption\fP is \fIResClass\fP or \fIResName\fP, an icon having no XA_WM_CLASS property is considered to be the "smallest" element. .IP "*FvwmIconBox: Padding \fInumber\fP" Specifies the number of pixels between icons. The default value is 5. .IP "*FvwmIconBox: SBWidth \fInumber\fP" Specifies the width of horizontal and vertical scrollbars. The default value is 9. .IP "*FvwmIconBox: Placement \fIprimary\fP \fIsecondary\fP" Specifies icon placement policy. \fIprimary\fP and \fIsecondary\fP can be \fITop\fP, \fIBottom\fP, \fILeft\fP and \fIRight\fP. The following eight combinations are available: .nf .sp \fIprimary\fP \fIsecondary\fP Left Top Left Bottom Right Top Right Bottom Top Left Top Right Bottom Left Bottom Right .sp .fi .B "\fITop\fP:" Icons are placed from top to bottom. .B "\fIBottom\fP:" Icons are placed from bottom to top. .B "\fILeft\fP:" Icons are placed from left to right. .B "\fIRight\fP:" Icons are placed from right to left. For example, when the placement is "Left Top", icons are placed from left to right, and new rows are added from top to bottom. The default vale is "Left Bottom". .IP "*FvwmIconBox: UseSkipList" Tells FvwmIconBox to not show the windows that are listed on a WindowListSkip line in the configuration file. .IP "*FvwmIconBox: Lines" Specifies the number of icons placed in a line. If \fIprimary\fP is Left or Right, this value specifies the number of columns. If \fIprimary\fP is Top or Bottom, this value specifies the number of rows. For example, seven icons are placed in a row if *FvwmIconBox: Lines is 7 and *FvwmIconBox: Placement is "Left Top". The default value is 6. .IP "*FvwmIconBox: HideSC \fIdirection\fP" Specifies the un-displayed scroll bar . \fIDirection\fP can be either \fIHorizontal\fP or \fIVertical\fP. .IP "*FvwmIconBox: Geometry \fIx{+-}{+-}\fP" Specifies the location and/or size of FvwmIconBox. \fIwidth\fP and \fIheight\fP are measured in icons, not pixels. The default value is 6x1+0+0. .IP "*FvwmIconBox: MaxIconSize \fIx\fP" Specifies the maximum size of icon bitmap. A bitmap larger than this size is clipped to this size. The default value is 48x48. In particular, if the height is 0, then icon bitmaps are not displayed and only icon labels are drawn. .IP "*FvwmIconBox: Mouse \fIButton\fP \fIAction\fP \fIResponse[, Response]\fP" Tells the module to do \fIResponse\fP when \fIAction\fP is done on button \fIButton\fP. Available \fIResponse\fPs are built-in commands in Fvwm (e.g. Iconify, Delete, Focus) and available \fIAction\fPs are Click and DoubleClick. .IP "*FvwmIconBox: Key \fIKey\fP \fIResponse[, Response]\fP" Tells the module to do \fIResponse\fP when \fIKey\fP is pressed. Available \fIResponse\fPs are, besides Fvwm built-in commands, the following six FvwmIconBox built-in commands: \fINext\fP, \fIPrev\fP, \fILeft\fP, \fIRight\fP, \fIUp\fP, and \fIDown\fP. .B "\fINext\fP:" Change the hilighted icon to the next. .B "\fIPrev\fP:" Change the hilighted icon to the previous. .B "\fILeft\fP:" Move the slider of the horizontal scrollbar to left. Icons move to right accordingly. .B "\fIRight\fP:" Move the slider of the horizontal scrollbar to right. Icons move to left accordingly. .B "\fIUp\fP:" Move the slider of the vertical scrollbar to up. Icons move to down accordingly. .B "\fIDown\fP:" Move the slider of the vertical scrollbar to down. Icons move to up accordingly. .IP "*FvwmIconBox: \fIwindowname\fP \fIbitmap-file\fP" Specifies the bitmap to be displayed in the icon box for \fIwindowname\fP. This option "overrides" bitmap files specified in Style command. \fIWindowname\fP can be window name, class name, or resource name. \fIWindowname\fP can contain "*" and "?" like Fvwm configuration file. The \fIbitmap-file\fP is either the full path name to a bitmap file, or a file in the ImagePath. If \fIbitmap-file\fP is specified to be "-", the icon for a window corresponding to \fIwindowname\fP is not shown in the icon box. .IP "*FvwmIconBox: SetWMIconSize" Tells the module to set XA_WM_ICON_SIZE property of the root window at the size which the module want icon windows to have. If you show icon windows on not the root window but the module, it would be better to specify this option. .IP "*FvwmIconBox: HilightFocusWin" Tells the module to hilight the icon of the window which has the keyboard focus. The fore/back colors of the hilighted icon are those specified in the *FvwmIconBox: IconHiFore and *FvwmIconBox: IconHiBack commands, respectively. .IP "*FvwmIconBox: Resolution \fIresolution\fP" If \fIresolution\fP is Desk, then the module shows only the icons on the current desk. Currently, Desk is the only value \fIresolution\fP can take :) .IP "*FvwmIconBox: FrameWidth \fIwidth1\fP \fIwidth2\fP" Specifies the frame-width of the module. \fIWidth1\fP corresponds to the width from the outer-border to the scroll-bar, and, \fIwidth2\fP corresponds to the width from the scroll-bar to the internal-window displaying icons. The default values are 8 and 6, respectively. .IP "*FvwmIconBox: NoIconAction \fIaction\fP" Tells FvwmIconBox to do \fIaction\fP is when a NoIcon style window is iconified or de-iconified. Relevant coordinates are appended to \fIaction\fP so that the icon can be traced to an FvwmIconBox button. An example action is "*FvwmIconBox: NoIconAction SendToModule FvwmAnimate animate". A blank or null action turns this feature off. .IP "*FvwmIconBox: NoIconifiedParentheses" Tells FvwmIconBox to not enclose the title of an iconified window within parantheses. .IP "*FvwmIconBox: NormalTitleRelief \fInum\fP" Sets the width in pixels of the relief that is put around icon titles for windows that are not iconified. The default if this option is not specified is 2 pixels. .IP "*FvwmIconBox: IconifiedTitleRelief \fInum\fP" Sets the width in pixels of the relief that is put around icon titles for windows that are iconified. The default if this option is not specified is 2 pixels. .IP "*FvwmIconBox: NormalTitleInvertedRelief" This option makes the relief around titles of uniconified windows to appear pressed in. The default is a relief that makes the label look raised from the background (unless a relief width of 0 pixels is specified, see above). .IP "*FvwmIconBox: IconifiedTitleInvertedRelief" This option makes the relief around titles of iconified windows to appear pressed in. .SH SAMPLE CONFIGURATION The following are excepts from a .fvwm2rc file which describe FvwmIconBox initialization commands: .nf .sp ############################################################ # Note that icons are shown in the module # only if NoIcon attribute is applied. Style "*" NoIcon ############################################################ *FvwmIconBox: IconBack #cfcfcf *FvwmIconBox: IconHiFore black *FvwmIconBox: IconHiBack LightSkyBlue *FvwmIconBox: Back #5f9ea0 #*FvwmIconBox: Fore blue *FvwmIconBox: Geometry 5x1+0+0 *FvwmIconBox: MaxIconSize 64x38 *FvwmIconBox: Font -adobe-helvetica-medium-r-*-*-12-*-*-*-*-*-*-* *FvwmIconBox: SortIcons IconName #*FvwmIconBox: SortIcons ResClass *FvwmIconBox: Padding 4 *FvwmIconBox: FrameWidth 9 7 *FvwmIconBox: Lines 10 *FvwmIconBox: SBWidth 11 *FvwmIconBox: Placement Left Top *FvwmIconBox: Pixmap fvwm.xpm #*FvwmIconBox: HideSC Horizontal *FvwmIconBox: SetWMIconSize *FvwmIconBox: HilightFocusWin #*FvwmIconBox: Resolution Desk *FvwmIconBox: NoIconAction SendToModule FvwmAnimate animate # # mouse bindings # *FvwmIconBox: Mouse 1 Click RaiseLower *FvwmIconBox: Mouse 1 DoubleClick Iconify *FvwmIconBox: Mouse 2 Click Iconify -1, Focus *FvwmIconBox: Mouse 3 Click Module FvwmIdent # # Key bindings # *FvwmIconBox: Key r RaiseLower *FvwmIconBox: Key space Iconify *FvwmIconBox: Key d Close # # FvwmIconBox built-in functions # *FvwmIconBox: Key n Next *FvwmIconBox: Key p Prev *FvwmIconBox: Key h Left *FvwmIconBox: Key j Down *FvwmIconBox: Key k Up *FvwmIconBox: Key l Right # # Icon file specifications # # Mostly, you don't have to specify icon files, as FvwmIconBox now # reads icon files specified in Style commands. # *FvwmIconBox: "Fvwm*" - .sp .fi .SH AUTHOR Nobutaka Suzuki (nobuta-s@is.aist-nara.ac.jp).