Toybox 1.3 - and icon-manager with colour pixmaps. Requires Motif, the Xpm-library and a C++ compiler to build. Works under [v]twm (see below), ol[v]wm and mwm. Changes from 1.2 to 1.3: Works with [v]twm, ol[v]wm and mwm : To make it work with [v]twm, include "IconifyByUnmapping", "NoIconManagers" in your .[v]twmrc file to make [v]twm not produce an icon when a window is iconified - toybox will handle it. Also if you're using Doors and their names are (say) door1, door2 etc. then insert the following lines into your .Xdefaults: toybox*door1: DONT_SHOW toybox*door2: DONT_SHOW ! in general, use : toybox*<door-name>: DONT_SHOW The lines above tells toybox not to produce an icon for the doors that you use. You may also want to get rid of the icon-manager that comes with [v]twm. See the man-page of twm for details. To make toybox work with ol[v]wm, you may want to get rid of the flashing lines ol[v]wm draws when windows are iconified. To do this, add these lines to your .Xdefaults: olwm*IconFlashCount: 0 olwm*IconFlashOnTime: 0 ! use "olvwm" instead of "olwm" if you use olvwm. See the man page for ol[v]wm for details. You might also like to set toybox*overrideRedirect: True or, if you're using [v]twm, include "toybox" in the list of windows specified in the "NailedDown" list in your .vtwmrc file. This is so that the window-manager doesn't wait for you to place the window and toybox will persist across all parts of your virtual-desktop in [v]twm. You also might like setting: toybox.x: 0 toybox.y: 0 ! to make toybox appear at the origin . Toybox now supports transparent windows - getting rid of that needless opaque window the icons were sitting in. Define HAVE_SHAPE_EXTENSION when building. See instructions below on how to check if your version of X supports the SHAPE extension. You are advised to use the SHAPE extension if you have it. New resources: toybox*floatOnRoot: YES or: toybox*floatOnRoot: NO enables or disables transparent windows. Effective only when toybox is built with HAVE_SHAPE_EXTENSION defined. toybox*layoutPolicy: top_left or bottom_right or right_top or left_bottom etc. but *not* top_bottom, left_right, bottom_bottom etc. Changes from 1.1 to 1.2: New resources: toybox*window-title-15chars-max: DONT_SHOW tells toybox not to produce an icon for that window. The semantics when windows change names is still undefined. ie I still haven't made up my mind! Clicking the right-mouse-button raises the corresp. window, mapping it first, if necessary. Shift and Button3 on an icon will delete it - you can't get it back! Deleting all icons with Shift+Button3 will make toybox restore (as best it can) mwm's original icons and then exit. Note: Toybox is provided "as-is", without any express or implied warranty. In no event will the author be held liable for any damage arising from the use of this software. If you would like include some of your own enhancements/changes, please email me at thc2@doc.ic.ac.uk and we could work something out. To build toybox, 1. build Xpm-library(get this from export.lcs.mit.edu:/contrib if you need to. It builds pretty easily ). Take note of where the library called libXpm.a is built, along with xpm.h and xpmP.h. 2. Check to see if your version of X has the SHAPE extension: Look into /usr/include/X11/extensions/ for a file called shape.h. If it's there, add "-DHAVE_SHAPE_EXTENSION" on the command-line when building. If you're not sure whether or not you have the SHAPE extension, try running "xeyes" and see if it has a transparent, non-rectangular window. If it does, then you have the extension. Type: <name-of-your-C++-compiler> -DHAVE_SHAPE_EXTENSION -O -o toybox toybox.cc -I<directory-where-the-XPM-header-file-is> -L<directory-where-libXpm.a-is> -lXpm -lXm -lXt -lXext -lX11 Exclude "-DHAVE_SHAPE_EXTENSION" if your version of X doesn't support the SHAPE extension. You're advised to use the SHAPE extension if possible. eg. (a) g++ -O -o toybox toybox.cc -I/usr/include/ -L/usr/lib/ -lXpm -lXm -lXt -lXext -lX11 or: (b) g++ -O -o toybox -DHAVE_SHAPE_EXTENSION toybox.cc -I/usr/include/ -L/usr/lib -lXpm -lXm -lXt -lXext -lX11 if you have g++ and xpm.h,xpmP.h are in /usr/include and libXpm.a is in /usr/lib. Use (a) if you don't have the SHAPE extension, (b) otherwise. 3. Inspect the file called Toybox. It contains sample X defaults for toybox. The format of some of the defaults is like this: toybox*<name-of-the-window>: <full-path-name-of-XPM-file> The <name-of-the-window> should be replaced with the string that appears below the image in toybox's window. To find out the string needed, run toybox first and then the program with the desired window. Check to see the name that toybox labels the image with and use that. The string is 15 chars max. To change this, change the #define in toybox.cc. To register the default XPM-file to use, change the right- hand-side of the line that says toybox*defaultPixmapFile: <right-hand-side> to the full pathname of the default XPM-file. Other defaults: toybox*<name-of-the-window>: DONT_SHOW tells toybox not to produce an icon for that window. toybox*floatOnRoot: YES or: toybox*floatOnRoot: NO enables/ disables transaprent windows. toybox*layoutPolicy: top_left or bottom_right or right_top or left_bottom etc. but *not* top_bottom, left_right, bottom_bottom etc. Specifying "bottom_right" means that icons will stay as close to the "bottom" as possible and to the "right" as far as possible, in that order. Only meaningful when floatOnRoot is "YES". Experiment with top_right, right_top to see the difference. In the distribution, you will find some sample XPM-files that can be used with toybox in the pixmaps/ directory. Some of them are referred to in the X-defaults file, Toybox. Change the pathnames as appropriate. Once you have modified the file "Toybox", append it to your .Xdefaults and use xrdb to register these resources. eg. xrdb -load ~/.Xdefaults 4. Toybox is ready to run! Type "toybox". Note: To make your own XPM-files to use with toybox, build "grabber" : Change the #include for xpm.h in grabber.cc to the appropiate path-name of xpm.h Type: g++ -O -o grabber grabber.cc -I<directory-where-XPM-header-file-is> -L<directory-where-libXpm.a-is> -lXpm -lX11 To run grabber, just type "grabber name-of-file" and draw a rubber-band rectangle over the region of the screen you want to save by pressing the left-mouse-button at the top-left-hand corner of the region and dragging the mouse until the rectangle drawn covers the area you want to grab. Let the mouse-button go and the area covered in the rectangle will be saved in <name-of-file>. Email any suggestions/bug-fixes/kludge-zappers to: thc2@doc.ic.ac.uk There will be the odd bus-error or two. If you think you have found a memory-leak/bug in toybox, please feel free to email me. No flames, please. Tse Huong Choo Dept of Computing, Imperial College, 180 Queens Gate, South Kensington, London SW7 2BZ, London, UK. [ Thanks to: Kenneth "N." Flaxman <kenlaw!knf@uunet.UU.NET> for some bug-fixes ... keep 'em coming! ]
