    -------------------------------------------------------------------------
    INTRODUCTION
    -------------------------------------------------------------------------

    Wouldn't it be nice to easily print diskette labels for backup
    disks and other software?  Or, print personalized mailing labels
    quickly and easily?  'Labeler' allows you to do all these things!
    With 'Labeler', you can quickly design & print diskette & mailing
    labels which can include both text and graphics.  If your printer
    has color capability, 'Labeler' supports as many colors as the
    screen where 'Labeler' resides can support.  By simply changing the
    output type (diskette -> mailing: for example) you can print the
    same label design in on a different sized label without redoing
    any graphics!  The printing system will automatically rescale the
    label for you!  'Labeler' can also be used to print index cards
    and post cards.


    -------------------------------------------------------------------------
    FEATURES
    -------------------------------------------------------------------------

    --------------------------
    Standard features include:
    --------------------------
    o - Multitasks.
    o - Uses standard INTUITION interfaces.
    o - Adjusts to different WORKBENCH environments.
    o - Uses the system printer's graphic preferences.


    -------------------------
    Special features include:
    -------------------------
    o - Uses the 'SOFTCONFIG' environment.
    o - Uses the 'PRINTERPREFS' environment.


    -------------------------
    Program features include:
    -------------------------
    o - Uses standard ILBM/IFF format when loading & saving labels.
    o - Editing features: draw, line, box, circle, fill, cut & paste.
    o - Place text anywhere within the label using any Amiga
        bitmapped font & style (bold, italics , underline).
    o - Printable area (label size) is displayed.
    o - Automatically scale background image to fit the printable
        area.
    o - Automatically uses the current background image's colors.
    o - Uses current system printer graphic preferences when printing
        the label.
    o - Single level undo (except for 'cut').
    o - Quickly select label or card size via a pull-down menu.


    -------------------------------------------------------------------------
    USING LABELER
    -------------------------------------------------------------------------

    ----------------
    Getting Started:
    ----------------
    You can start 'Labeler' from the supplie icon, of from the CLI/ Shell
    using:

    >Run Labeler

    ... this will bring up the label editing window.


    --------
    Options:
    --------
    The following options are available from the CLI/ Shell.

    (none).

    (For information on 'TOOLTYPES' please refer to the online help file.)


    ----------------
    Pull-Down Menus:
    ----------------

    Project Menu:
    -------------
    New .............. Erase/ clear current label.
    Load... .......... Load an existing label.
    Save ............. Save the current label.
    Save As... ....... Save the current label specifying the name.
    Print/Print One .. Print the current label.
    Print/Print... ... Print the current label specifying copies.
    Print/Aspect'ed .. Print using proper image aspect.
    About ............ Program credits & info.
    Quit ............. Exit 'Labeler'.


    Edit Menu:
    ----------
    Clear ............ Erase the current label.
    Clear to Bkgr. ... Erase the current lable to the current background.
    Select Text... ... Select text/ styles to place on the label.
    Transparency ..... Toggle text/ image transparency on/ off.
    Undo Last Chge. .. Undo the last change.


    Backgrounds Menu:
    -----------------
    Load Picture... .. Load a background image.
    Fit Label ........ Scale background image to fit the label.


    Formats Menu:
    -------------
    Diskette Label ... Print diskette labels.
    Mailing Label .... Print mailing labels.
    Index Card ....... Print index cards.
    Post Card ........ Print post cards.


    ---------------
    Loading Labels:
    ---------------
    All labels loaded are IFF BRUSH files saved with 'Labeler' or a
    popular paint program supporting the IFF file standard.


    --------------
    Saving Labels:
    --------------
    All labels are saved as IFF BRUSH files and can be loaded into
    any painting program supporting the IFF file standard.  These
    programs allow greater flexibility and have more options available
    to complete your label or card design.  After editing your
    label or card with a paint program, be sure to use the program's
    "Brush/Save" option.  The size of the label or card should be
    exactly the same as when it was saved by 'Labeler'.  If the label
    or card is too large, 'Labeler' will not allow you to load it.  In
    that case, re-load it into the paint program, the 're-cut' it to
    the proper dimensions before saving it.

    You can specify the file name to save the current label or card
    as by using the "Project/Save As..." option.


    --------
    Drawing:
    --------
    The number of colors available to 'Labeler' is only limited by
    the 'depth' of the screen where 'Labeler' resides.  You might
    want to open a PUBLIC SCREEN (Don't forget to make it the
    DEFAULT PUBLIC SCREEN other 'Labeler' will not open it's editing
    window on it: 'PSX' Steve Tibbett is a good program to do this.)
    that has the highest number of colors offered by your current
    system.  You will also need to set the USE PUBLIC SCREEN software
    configuration flag to 1.

    If you select "Edit/Clear" or "Project/New" then the default
    label or card colors will return to that the screen where the
    editing window resides.

    The following drawing tools are in order of appearance in the
    drawing 'toolbox':

    DRAW .... Draw continous lines in the color selected.
    FILL .... Fill areas in the colors selected.
    LINE .... Draw lines in the selected color.
    CIRCLE .. Draw outlined ovals in the selected color.
    SQUARE .. Draw outlined or solid rectangles in the selected color.
              (Click on SQUARE again to toggle back and forth between
               outlined and solid rectangles.)
    CUT ..... Cut out a section of the label or card: use the cut out
              image just like a loaded background image.
    n/a ..... (This option is available for future use)
    COLORS .. Select the color to use.

                                  ----------

    WARNING: When using the drawing commands, the editing window should
    be 'in-front' of all other windows!


    ---------------
    Selecting Text:
    ---------------
    You can select the font and style for the text to place on the
    label or card by selecting the "Edit/Select Text..." option.
    This will display the "Select Text" window.

    To select a different font, click on the "[ Select Font ]"
    gadget (button).  Each "text image" placed on the label or card
    can be in a different font/ style.

    Here are a list of styles available on the "Select Text" window.

    B ... Bold text.
    I ... Italic text.
    U ... Underline text.

    Once text has been selected, the resulting image behaves just like
    a loaded background image.

    Compugraphic fonts are not supported as of this release.


    -----------------
    Background Image:
    -----------------
    You can load as many IFF BRUSH images you want for your label or
    card.  These images are considered to be background images.  The
    label or card's current colors will always be that of the last
    background image loaded.  If you use the 'Fit Label' option, then
    the background image will be 'scaled' to fit the printable area.

    The current image will always over-lay all other images placed
    upon the label or card.

                                  ----------

    Note:  This following section refers to background images, text
    images and cut-out images.

    Once you've selected a background image, move the mouse pointer
    around the label or card: this will move the background image.
    Click on the left mouse button to place the image on the label
    or card, or click the right mouse button to cancel.

    The TRANSPARENCY option will cause the resulting background image's
    BACKGROUND color to either be transparent (if 'activated') or
    solid (color #0).  Use this option to achieve different effects
    for different background images.


    ---------------
    Printable Area:
    ---------------
    If 'right margin' & 'lower margin' lines appear on the editing window,
    this represents the printable area: only the graphics contained within
    this area will be printed.  Some label or card format(s) do not use
    this feature.  Be sure to remove these lines before printing by using
    either the FILL or LINE drawing options as these will show up on the
    the printed label or card if not removed or drawn over.


    ---------
    Printing:
    ---------
    'Labeler' uses the system's printer graphic preferences ('PrinterGFX')
    when printing either a label or a card.  Be sure these preferences
    are set properly before printing.  Use 'SYS:Prefs/PrinterGFX' to set
    these preferences options.

    If you want to print a single label or card, possibly to test the
    printed design, use the "Project/Print/Print One" option.  However,
    you should use the "Project/Print/Print..." option if you are going
    to print multiple copies, since this option allows you to specify the
    number of copies you would like to print.

    You can cancel printing pending copies by clicking on the close
    window gadget (button) for the "Print Info!" window.  Be patient, you
    will have to wait until the current label or card has printed before
    all pending copies will be canceled.

    You can change the selected output media, diskette labels to mailing
    labels for example, without re-doing the actual label graphics.  The
    new size will be automatically adjusted when the same label is
    printed.


    -----------------------
    Software Configuration:
    -----------------------
    The following variables (flags) are used:

    SCREEN TO FRONT
    USE PUBLIC SCREEN
    INITIALIZE PRINTER
    MAGNIFICATION FACTOR%
    DON'T ASK TO QUIT
    DISABLE PRINTER

    (Please refer to the help file(s) for 'SoftConfig' for more information.)


    -------------------------------------------------------------------------
    FOR ADVANCED USERS
    -------------------------------------------------------------------------

    -------------
    Label Format:
    -------------
    'Labeler' uses the standard ILBM/IFF format when saving labels.
    Any 'Labeler' label can be loaded into any painting program supporting
    this format allowing the greater editing flexibility these programs
    provide, then, reloaded back into 'Labeler' for printing.  However,
    the labels width & height should not change.  When saving the label
    from a painting program, cut out the label (keeping the original width
    & height of the label), then save it using the 'Save Brush' option.


    -----------
    Final Note:
    -----------
    'FKEY' can be used to 'launch' this program via pre-determined
    keystroke(s).


    -------------------------------------------------------------------------
    CREDITS
    -------------------------------------------------------------------------

    This program was designed and coded by Michael Thomas Hurt  of
    MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
    available from Acid Software.

    Software testing was done using:

      o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.

      o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
          Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
          GVP Series II hard card w/ 100MEG HD.

      o - Amiga 3000: AmigaDOS 2.1, 6MEGS.

      o - Amiga 4000: AmigaDOS 3.0


    -------------------------------------------------------------------------
    PROGRAM HISTORY
    -------------------------------------------------------------------------

    v1.0    06/23/1995    Original program.