ZipLabel v2.0  - 1/9/98
Copyright (c) 1997-8
Earle F. Philhower, III
earle@geocities.com

    [search for "-new-" to find the changed sections of this document]
--------------------------------------------------------------------------
Introduction

ZipLabel is a utility for the creation of labels to be placed in
Zip disk cases.  It can generate many different kinds of labels,
containing directory information, images, fonts, and more.

Check out cdrLabel if you have a CD-ROM drive and like the kind of
labels ZipLabel creates:
     http://www.geocities.com/CapeCanaveral/6552/cdrlabel.html

--------------------------------------------------------------------------
What's New                                                           -new-

Version 2.0:
The following new features have been added:
 * QUAD-Length Labels!  4x the fun!
 * Crop marks to make it easier to cut
 * Customizable borders
 * Printer setup dialog, can choose non-default printer and get WYSIWYG
 * Can place label anywhere on printouts
 * Very small font sizes supported
 * Up to 5 columns now available
 * Spine can be custom aligned

The following bugs and annoyances have been addresses:
 * Strings now resize when font is changed
 * Canon BJC-620 driver oddity fixed (rotated text now prints properly)
 * File editor won't crash when operating on an empty label
 * Creates number of copies specified in Print Dialog
 * Subdirectory window crashes on empty label fixed
 * Can read a completely blank disk
 * Cleaned up popup menus

Version 1.8-1.9(internal):
The following new features have been added:
 * Window Scaling
 * Directory-Only Scanning Mode
 * Background Colors for Body and Spines
 * Line Rulings Now Removable
 * File Editing Supports Multiple Selections
 * "Maxspect" Option For Image Scaling
 * Minor Interface Updates

The following bugs have been addressed:
 * Row Height Updates After Every Font Update
 * More PCL Printers Function
 * And others I've forgotten about.

--------------------------------------------------------------------------
Disclaimer

ZipLabel is shareware, (c) 1997-8 by Earle F. Philhower, III.
I make no warranties as to it's correctness or functionality.  Use
it at your own risk.

Finally, I would like to make it clear that I am not affiliated with
Iomega Corp.  All names are copyright of their respective owners.
Iomega and Zip Drive are copyright of Iomega Corp.

--------------------------------------------------------------------------
Shareware

ZipLabel is shareware, the best in "try before you buy."  If ZipLabel
is of use to you, a $15.00 registration fee is requested.  It is
easiest to use the "Print Order Form" from the Help menu to print out
an order form, or print out and fill in the "ORDER.TXT" file.
My mailing address is:
                     Earle F. Philhower, III
                     P.O. Box 6573
                     Laguna Niguel, CA  92607

PLEASE ENCLOSE YOUR EMAIL ADDRESS SO THAT I CAN INFORM YOU WHEN NEW
VERSIONS ARE RELEASED.  Please note that if you've already registered
for one version, you're registered for all newer versions, too.
Registered users will be informed when newer versions are available.

--------------------------------------------------------------------------
International (non-US) Registrations                                 -new-

For international registrations feel free to skip the shareware fee and
just send a postcard to the P.O. Box above.  Make sure to include your
email so I can send any registation codes and inform you of new releases.

--------------------------------------------------------------------------
Registered User Bonus                                                -new-

As an added bonus, registered users will have the option of customizing
their versions of ZipLabel.  The labels produced will then contain the
user's initials instead of "zip."  Just include in your registration
note the initals you'd like to add, and I'll email you the codes necessary
to make ZipLabel do it.

If you've registered but I haven't sent you an email saying that I've
added you to my mailing list, PLEASE contact me before assuming the worst.

--------------------------------------------------------------------------
Requirements

* Windows 95, NT, or 3.1(Win32s)
* 800x600 display recommended
* Printer (laser or inkjet recommended)
* Zip Disks
* Colored Paper (optional)
* Scissors

--------------------------------------------------------------------------
Installation

There are two ways of installing ZipLabel:
 1. Use the included Setup program, which will make program groups
    and allow you to use the Uninstall program, or
 2. Just copy the executable file to any convenient directory.

If there are any problems with the setup program, just perform option
(2) and send me some email (earle@geocities.com).

WINDOWS 3.1 ONLY:  Under Windows 3.1 you NEED to have Win32s v1.30c
installed, if you don't already have it check out the following URL to
get it:
            http://www.microsoft.com/kb/articles/Q122/2/35.htm

--------------------------------------------------------------------------
Popup Menus

ZipLabel brings up a window containing a menubar and a WYSIWYG label
display.  There are also popup menus available inside the label
display by clicking your right mouse button in the window.  If you
right-click within the body of a label the body menu will appear,
and if you right-click in the spine on a label the spine menu
will pop up.  These are basically the same menus you see in the
menubar, but require less mouse-travel to use.

--------------------------------------------------------------------------
Keyboard Shortcuts

The following keyboard shortcuts should make creating labels easier:
  
   +      Increase number of columns
   -      Decrease number of columns
 Return   Load disk into label
   z      Zoom in/out of label
 Delete   Delete image from label
 Arrows   Move from one label to the next when x2 or x4 labels
  1234    Jump to label number #
 Ctrl-P   Print label

--------------------------------------------------------------------------
Templates

ZipLabel can automatically store a small text file, a template, on
disks which it scans.  This template stores the following information:
    * General format, including font and colors
    * Paths to all images
    * Directories displayed/hidden
This is enough information for ZipLabel to create a new label when files
are added or removed.  Best of all, these files are normally under 5Kb!

--------------------------------------------------------------------------
Using Templates

First, select the "Use Templates" option in the "File" menu.  This will
make ZipLabel search for a hidden file, "ZIPLABEL.ZLT", on each disk it
scans and read it's formatting in.

Now, insert your disk and read it in.  Set the font, directory tree, and
the images you want and select "Write Template" from the "Body" menu.
Go on to the next disk you want to set up and perform the same operation.

The next time ZipLabel reads in the disk, it will automatically format
it the way you specified!  Easy and fast!

--------------------------------------------------------------------------
Images and Strings

ZipLabel can import .BMP (Windows Bitmap) and .JPG (JPEG) files into
your labels. Simply select "Insert Image" from the "Body" menu and
you're on your way.  Labels can either be underneath the label text,
or above the text. Text will automatically flow around any images above it.

ZipLabel can also create free-form text strings, via the String menu.
Choose "Insert String," enter text in the dialog box, use the buttons
in the dialog to choose a font and foreground and background color.
If you want your text to appear above an image (as for captions, etc.)
use the String menu and choose "Background Color->Transparent".

To select an image in your label, left-click on it.  Click-and-drag to
move the label around.  Right-click to bring up a menu of options
to delete, center, or change the image's position relative to the
text.  "Above Label" makes the text flow around the image, while 
"On Label" and "Below Label" place an image without text wrapping.

Use the little size-blocks to change an image's size, or use the
Image popup-menu's scaling options.

HINT: If you are having trouble dragging a tiny image, hold down the
      SHIFT key while you click the left button.  This turns off the
      size-blocks and always drags an image.

HINT: To setup a photo to be your label's background, perform the
      following steps.  (Remember, with a dark image it's easiest to see
      white text, and with a light image it's easiest to see dark text):
      * Insert Image
      * Image->Scale->Size To Body
      * Image->Below Label

Bitmaps of greater than 72dpi are supported automatically, so you can
scan an image in at a higher resolution than the screen supports, yet
still print out out at the higher resolution.  This is especially useful
for line art, where 72dpi conversion can cause excessive jaggies.

--------------------------------------------------------------------------
Working on Individual Labels

There are two ways to select a label to work on.  Either click on the
label in the window, or press the corresponding number.  All items in
the "Body" and "Spine" menus only work on the currently selected
label.

--------------------------------------------------------------------------
Double Length Labels

Two double-length label modes are available in ZipLabel, with the
spine either in the middle or on the bottom of the labels.  Choose
"File->Number of Labels->Two, Fold Out" for double length labels that
have the spine on the bottom, and whose second label has to be "folded
out" to read.  Choose "File->Number of Labels->Two, Fold Around" for
labels that have a spine in the center, and are actually folded-around
the Zip disk in the case.

While editing in zoomed-out mode, you can see both sides of the label,
but when you are zoomed in you can only see either the first or second
size.  To toggle between pages, click on the "Up To Page Two" or
"Down To Page One" areas at the bottom of the label.  You can also use
the up and down arrow keys to perform the same function.

The "Up/Down to Page Two/One" will NOT be printed out on your labels.

--------------------------------------------------------------------------
QUAD-Length Labels                                                   -new-

ZipLabel now supports a quad-label mode, allowing you to catalog almost
twice as many files as double-length mode.  Simply choose 
"File->Number of Labels->One, Quad Length" and you're on your way.

DO NOT CUT THE INDIVIDUAL LABELS APART WHEN PRINTED.  Instead, cut around
the labels, then fold the cutout in half along its horizontal center.
This gives a tall, skinny label.  Fold this skinny label down, and insert
into a jewel case.  No staples or glue necessary!

--------------------------------------------------------------------------
Printer Setup                                                        -new-

There is a new Printer Setup dialog available from the File menu.  This
allows you to:
 * Select a Default Printer
     ZipLabel will then use that printer's font metrics to display the
     on-screen versions of labels, making the representation very accurate
 * Turn on and off crop marks
     Crop marks are 1 inch lines along the edge of the sheet indicating
     where cuts need to be made.  Especially handy for use with paper
     cutters.  Note most printers can only print up to within 1/4" of
     the paper's edge.
 * Select a Border Style
     If for some reason you don't like a thick solid border, you can
     specify any of four others, or even turn off the border completely.
 * Position the Printout
     You can specify the upper-lefthand corner of printouts, making it
     easy to use different paper sizes and perforated templates.

--------------------------------------------------------------------------
Menu Items                                                           -new-

FILE
    Select Zip Drive
        Brings up a dialog for you to select the drive letter to catalog.
        THIS DOES NOT READ IN A DISK!  See "Read Zip Disk" below.

    Window Scaling
        On some machines and operating systems (Windows NT, for example)
        the ZipLabel window can be too small or large to work with.  This
        menu allows you to zoom the entire window up to 150% and down to
        50% of "normal" size.  This does NOT affect any printed output.

    Number of Labels
        Select either 1, 2(double length), or 4 labels to print.

    Directory Levels
        Determines how many levels of subdirectory ZipLabel will scan.

    Scan Directories Only
        When checked only the names of directories are scanned into ZipLabel.
        Use this option for disks where you have lots of directories that you
        want to see.

    Use Template Files
        When checked, ZipLabel automatically formats your label according
        to the template file stored on the Zip disk.  If the disk doesn't
        have a template file, no action is taken.  See "Templates" for more
        information.

    Load/Save Label
        Store or retrieve a fully-formatted label from disk. Images, files,
        formatting, etc. are retrieved from the label file.

    Read/Write Template
        Store or retrieve formatting for the current label from the
        currently inserted Zip disk.  (Always read/written to a hidden
        file in the Zip disk's root directory, ZIPLABEL.ZLT.)

    Clear All Labels
        Clears text from ALL LABELS, saves formatting

    Reset To Defaults
        Sets all fonts, colors, and settings to sane defaults.  Use this
        item when you've REALLY messed things up!

    Print
        Presents a printer dialog then prints the labels being edited

    Exit
        Leaves ZipLabel

BODY

    Display File Sizes
        Show or hide the file sizes for current label

    Display Extensions
        Show or hide extensions from the filenames present

    Display Comment
        Show or hide disk comment

    Columns
        Select either 1,2,3,4 or 0(unlined) columns of files
        When the "Lined" option is unchecked there will be no lines drawn
        between rows of files.

    Sorting
        Sort by Name, Extension, or File Size

    Set Fonts And Color
        Chooses the font and it's color for displaying files
        and directories and the disk comment.  With the dialog
        presented you can add additional font and color rules
        for different file types (i.e. all JPG files green, etc.)

    Background Color
        You can set the background color of the label body to be
        printed with this option.  Note that this is actually going to
        print the color on your printer, not just on screen, and may
        consume LOTS of ink.

    Read Zip
        Reads the disk directory into the label.  This can also be
        accomplished by double-clicking on the body of a label.
        If "Use Templates" is selected in the File menu, also reads
        template and applies formatting, images.

    Edit Files and Folders
        Brings up a dialog for editing the label entries.  To modify a
        file, simply click on it in the list, and edit the information
        displayed.  Hit RETURN or click on the Change button to update
        the entry.
        Move entries up and down in the list via the "Move Up" and
        "Move Down" buttons.
        To remove the selected file from the list, click on "Delete."
        Additional lines can be created by clicking on "Add New" and
        entering the new file's information.
        Checking the "Subdirs" box will display the directory's
        contents on the label.
        To edit a subdirectory, click on the directory and then press
        the "Edit Subdirectory" button.

    Edit Label Comment
        Allows you to enter a new comment line.  The comment line is the
        last line printed on the bottom of the label, normally
        containing disk free space, etc.

    Choose Subdirectories
        Brings up a dialog allowing you to select which directories you
        want expanded on the label.

    Clear Label
        Clears everything from this label, both images and text

    Duplicate Style
        Copies FORMATTING ONLY, to ALL LABELS.

    Zoom
        Zooms in or out of an individual label, when in x4 or x2 mode.  To
        switch between labels while zoomed in, use the number or arrow
        keys.

SPINE
    Edit Spine Text
        Change the text printed on the label spine

    Spine Font
    Spine Color
        Chooses the font and it's color for displaying files
  
    Alignment
        Specify how the spine label should be justified

    Background Color
        Sets the background color for the disk spine

    Display "zip 100"
        When checked, shows the "zip 100" box in the spine

    Color ZIP Logo
        Colors the box containing "100" in red

STRING
    Modify Text
        Modify the selected string's text, font, color, etc.

    Font...
        Only change the font of the currently selected string.

    Foreground Color
        Only change the font color of the currently selected string.

    Background Color
        Change the background of the currently selected string
        to/from transparent and colored.

    Automatically Size
        When checked, size the string's bounding box to the minimum
        size.

    Orientation
        Rotate the string 0, 90, 180, and 270 degrees.

HELP

    About ZipLabel
        Information about program and author

    Print Order Form
        Presents a dialog to be filled out with name, address, etc.
        Then prints out a filled-in order form that can be mailed off.

    Enter Registration Codes
        Allows registered users to enter codes to customize the "zip."

--------------------------------------------------------------------------
Using the Printed Labels                                             -new-

Cut out the labels, it should be pretty obvious where to cut and where
to fold.  Remove the boring blue cardboard Zip case insert and place your
shiny new ZipLabel label into your case.  Replace the blue label (it's
normally of much heavier stock than your printer paper, and makes the
label stay put better).  Admire just how cool it looks, and then go make
some more!

See the "Double-Length Labels" and "QUAD-Length Labels" sections for
more info on cutting and folding those types.

Try using some colored heavy-bond copier paper.  Packs of 5 colors can
be bought at any office supply store, and make it very easy to classify
your disks (i.e. RED=backups, GREEN=games, etc.)!

--------------------------------------------------------------------------
Special Thanks

I'd like to thank Michel Lefort for the program icon and Jim Resinger
who actually sent me a Zip Disk!

Also, the JPEG decoding routines are taken from JPEG-6a sources, and
they'd like me to say: "this software is based in part on the work of
the Independent JPEG Group."  These guys make no warranty as to their
JPEG decoder, and neither do I!

Finally, thanks to all the registered users for their feedback and
support.  Keep the suggestions and bug reports coming in!

--------------------------------------------------------------------------
Bug Reports

If ZipLabel crashes on you, or doesn't print out correctly on your
printer I'd like to hear about it.  Please make sure to include the
following information to speed things up:

* Operating System
* Printer Type, Language(PCL, GDI, PS), Connection(network, local, etc)
* Series of operations to cause failure (if it's repeatable)

Just saying "ZipLabel crashed on me!" is about as useful as saying "My
car's broken" to a mechanic over the phone. ;)

--------------------------------------------------------------------------
Future Directions

* Free rotation of images and text?
* In-place editing of strings, selecting of directories?
* Importing file icons?
* User suggestions, of course

--------------------------------------------------------------------------

-Earle F. Philhower, III
 earle@geocities.com
 http://www.geocities.com/CapeCanaveral/6552

