ICONBAR(1)                                                          ICONBAR(1)




NAME

       iconbar - a desktop utility for managing icon windows


SYNOPSIS

       iconbar [-option1 value1] [-option2 value2] [...]


DESCRIPTION

       iconbar  is  intended  to  be a drop-in replacement for the (OSF/Motif)
standard iconbox application that is included as part of the 4dwm(1X) window manager running under the IRIX(tm) operating system. It uses OSF/Motif, X Toolkit Intrinsics and Xlib functions to manipulate win- dows on the desktop. Iconbar creates an unmanaged window at the bottom of the screen that Since version 0.8, Iconbar will automatically center itself in channel zero on those system that have multiple channels per pipe. Multi-Desks Iconbar does not explicitly support the 4dwm concept of multiple desk-
tops. However, since it is not managed by the window manager it does
appear on every desktop and is capable of managing icons of top-level
windows across all desktops. Since version 0.8, Iconbar will automati-
cally center itself in channel zero on those system that have multiple
channels per pipe.



Disclaimer 4dwm and IRIX are trademarks of Silicon Graphics Inc. The iconbar
application is not endorsed by or affiliated with Silicon Graphics
Incorporated.


Copyright Iconbar is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. Iconbar is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Iconbar; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

OPTIONS/RESOURCES

       The following added resources are intended for user customization. They
may be set using either a command line syntax as shown below, or in a
resources file such as the site default resources (/usr/lib/X11/app-
defaults/Iconbar) or the users personal default resources ($HOME/.Xde-
faults).



-animate increments An integer value that specifies the number of increments used in the animated pop-up of the iconbar. In this context 1 is fastest and 20 is slowest. The default is 5. Resource: animate.


-border None|Default|<filename> controlled by the animate resource, the hidden height by the
hideheight resource and the delay before the hide occurs by the
hidecount resource. Pressing either the Esc or space keys trig-
gers and immediate hide. Resource: hide.


-hidecount count An integer value that specifies that the application should wait count number of 200 millisecond update intervals after the cur-
sor is moved out of the bar windows, before hiding the iconbar.
The default is 10 which equates to a 2 second delay. Resource:
hidecount.


-hideheight pixels An integer value determines the height in pixels of the hidden iconbar. The default is 1. Resource: hideheight.


-highlightFG color A string describing the color that the foreground text is
changed to when the cursor enters a particular icon window. The
default is blue. Resource: highlightFG.


-horzmin pixels An integer value indicating the minimum horizontal screen loca- tion for the center of the iconbar. The default is 0. Resource:
horzmin.


-horzmax pixels An integer value indicating the maximum horizontal screen loca- tion for the center of the iconbar. The default is 0. Resource:
horzmin.


-horzshift [-]pixels An integer value indicating the number of pixels to displace the iconbar from the center of the screen. The default is 0.
Resource: horzshift.


-ignoreApps app_list app_list is a colon delimited string listing the window names of
applications that the iconbar program will ignore (i.e. not man-
age). The window name is the WM_NAME window manager hint prop-
erty that can be retrieved for a particular window using the
xprop(1) command. The default string is ToolChest (iconbar
always ignores itself). Resource: ignoreApps.


Iconbar retrieves the icon pixmaps for each application by
sequentially attempting the following methods: (WMHINTS)
retrieving an icon window hint property (currently not func-
tional see BUGS), retrieving an icon pixmap hint property (FILE)
an rgb(4) format image file in the user's $HOME/.icons directory
named with the application's instance name and the .icon suffix,
a similar file in the /usr/lib/images directory, a file in
$HOME/.icons with the application's class name, class-name.icon
file in /usr/lib/images (DEFAULT) the default icon file in
$HOME/default.icon /usr/lib/images/default.icon (SCREEN) a last
resort of copying the pixmap from the screen after a "quick"
minimization of the top-level window. The order that Iconbar
tries each of these methods in an attempt to resolve the appli-
cation's icon is specified as a colon separated string for this
option. The default is WMHINTS:FILES:DEFAULT:SCREEN. Resource:
path.


-raise True|False If True (default) causes the iconbar window to be continuously
raised to the top of the window stack, prevented it from being
covered by overlapping windows. Resource: raise.


-scale factor A floating point scale factor in the range from 0.1 to 1.0 that
is used to determine the size of the "non-magnified" (small)
icon pixmap in the iconbar window. Recall that the nominal (big)
4dwm(1X) icon size is 85x67 pixels. The default value is 0.75.
Resource: scale.


-shape True|False A boolean value that determines if the X SHAPE extension will be used to trim the magnified icon windows with smaller than full size icons (typically those with icon_mask hints). The default value is True. Resource: shape.


-tint True|False A boolean value that determines if applications running on remote hosts will have their icons automatically tinted. The default value is True. Resource: tint.



-toolchestManage True|False A boolean value that determine if iconbar will attempt to manage the state of the IRIX application /usr/bin/X11/toolchest. If
True, iconbar will perform two window management tasks: it will
attempt to raise the toolchest window when it is obscured, and
it will force the window to remain at the geometry (root window
default value is 1. Resource: toolchestY.



USAGE

       Iconbar may be invoked from the command line. It's a good idea to first
disable the iconbox from the desktop. This can be done graphically via
the toolchest(1X) menus Desktop->Customize->Windows and unchecking the
box next to Display Windows Overview.

To access a graphical menu that controls the toggling of some of the
interface options and also allows the icons to be rearranged, use the
Right or Middle mouse-button when over an icon pixmap.

To exit iconbar in a controlled manner either use the pop-up option
menu described above or else simply send a SIGHUP to the process using
the kill(1) command with argument -HUP followed by the process id num-
ber.

If iconbar terminates unexpectedly, the desktop icon windows may be
left in an inaccessible state. To rectify this, restart the window man-
ager. The restart can be accomplished from the toolchest(1X) or via the
command tellwm(1X) with the argument restart.



EXAMPLES

       A  sample  shell  command line launch of iconbar that would disable the
magnification and auto-hide options, eliminate the icon margins and
ignore the toolchest(1X), gr_osview(1) and ov(1) applications is as
follows:


iconbar -magnify False -hide False -margin 0 -ignoreApps ToolCh-
est:gr_osview:Desks Overview

Alternately, a user could place in his or her .Xdefaults file and
achieve identical results:


Iconbar*magnify: False
Iconbar*hide: False
Iconbar*margin: 0
Iconbar*ignoreApps: ToolChest:gr_osview:Desks Overview



FILES

       /usr/lib/images/*.icon
              system directory searched for rgb(4) format icon image files

$HOME/.icons/*.icon user directory searched for rgb(4) format icon image files

/usr/lib/images/default.icon

AUTHORS

       Steven Queen, Antony Fountain, and Bryan Sawler



ACKNOWLEDGMENTS

       Thanks to all of  the  testers  at  http://www.nekochan.net  for  their
patience, feedback and support.



SEE ALSO

       4dwm(1X),   toolchest(1X),   kill(1),   xprop(1),  tellwm(1X),  rgb(4),
gr_osview(1), ov(1)

v0.8 27                                        May 2006                            ICONBAR(1)



Man(1) output converted with man2html