
    Cris' widgets - readme
    ======================

    This is a little collection of rexx widgets written to work with
    Martin Lafaix' Widget Library.
    
    Included are:  a Z! controller widget (actually two cooperating widgets)
                   a clock widget
                   a swap-file-monitor widget
                   
    Since XWorkplace' XCenter still doesn't support installing widgets via
    setup strings, you'll have to install them manually by copying the code
    and resources provided and pasting it in the respective widgets.
    
   
    Then look in the provided text files.. you'll see how it's simple.
    
    
    Z! Controller
    =============
    
    This is a controller for the Z! mp3 player.
    
    To install Z! Controller you'll have to install first a Rexx-button and a 
    gauge (or two, read more below).
    
    Since version 0.4, this widget comes as two cooperating widgets: the main
    "Z! Controller" part, which is a rexx button, and a "Z! Monitor" part,
    which is a rexx gauge. I've also set up a second rexx gauge that does
    nothing but adds to the "eyecandy". See the screenshot named zctrl.png
    to see what I mean... the second gauge is simply an empty gauge, 3 pixel
    wide (fixed), with black background, put to the left of the rexx button.
    You may find it simply useless or stupid... :-)
    
    Features: All the usual operations (skpi fwd, skip backwd, pause, stop,
              vol+, vol-) can be carried out by clicking on the icon in the
              XCenter.
              
              New MP3s can be added to the Z! play-list by dropping them on
              the icon.
              
              You can save a playlist in Z!, and later recall it with a single
              drag-n-drop on the icon.
              
              If you drop an MP3 file on the icon while Z! is not playing, it
              will start playing the dropped file immediately.
              
              The "Monitor" part will show the title field from the tag info
              of the file being played. If the title is wider than 10 chars,
              it will scroll it in the visible part. You may get a smoother
              or coarser scroll by adjusting the refresh rate of the gauge,
              but keep in mind that updating the gauge too frequently may add
              significantly to you CPU load. I'm using a refresh rate of 1
              second (1000 ms).
              
              Double-clicking on the "Monitor" part will start Z!. If it is
              already running, it will resurface.
              
    In the "wider" subdirectory, you'll find an alternate setup for the main
    widget part. Look at the "wider.txt" file in that directory to learn more.

    
    Clock
    =====
    
    This is a simple clock. It has slight enhancements over the clock built-in
    wigets in XCenter.
    
    To install Clock, you'll have to install first a rexx gauge.
    
    Features: It only shows hours:minutes, to conserve XCenter space.
              
    		  It can change his background color based on the hour of the 
    		  day.
              
    		  It shows the weekday and the date in the tooltip.
              
    
    Swap File Monitor
    =================
    
    This is a monitor for your swap file.
    
    To install Swap-Monitor, you'll have to install first a rexx gauge.
    
    Since version 0.4, the calculation of the percentage has changed (it was
    incorrect previously, and could lead to percentages > 100)... you'll
    probably find that it is lower now. I've also slightly changed the
    behaviour: since the percentage varies when you're writing to the disk
    where the swap-file is held, I was constantly moving my mouse to the
    widget to see (from the tooltip) if it was the swapper that was growing 
    or the free space that had dropped. Now, if the swapper grows past its
    initial size, the bar graph will change its color, and the text will turn
    blue.
    
    Features: It shows the percentage of space occupied by the swap file,
              with respect to the free space on the swap drive.
              
              It changes its color when the swapper starts growing, and
              then again when the percentage goes over 90%.
              
              It shows the real size (in megabytes) of the swap file in
              the tooltip.
