                             D I S K P R I N T
--------------------------------------------------------------------------
                            DEMO VERSION 3.4.3e

                         copyright by Jan Geissler
                          Hermann-Rombach-Str. 17
                             D-7120 Bietigheim
                              (West) Germany

==========================================================================
SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAR
--------------------------------------------------------------------------

DiskPrint is SHAREWARE.                       THIS IS ONLY A DEMO VERSION!

                      This is only a limited version.

For a fee of 20 US-DOLLARS (only cash, please) you will get the full  wor-
king,  easy-to-install package with the newest version of DiskPrint, about
2100 labels for FD-Disks (i.e. for all fishdisks) and a help utility which
makes creation of label libraries much easier.

You  will also  become a  registred user  of DiskPrint,  so you will get a
message if a new version of DiskPrint is released.
NEW: Since V3.4 updates to foreign countries are available to for a fee of
5 dollars including postage.

-------------------------------------------------------------------------
SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAR
==========================================================================


I.       Configuration

II.      About DiskPrint

III.     Getting started

IV.      DiskPrint main window

V.       The Directory Tool

VI.      The defaults window

VII.     Editing the data mem

VIII.    Multiple printing / Print a range

IX.      Keyboard functions

=========================================================================


I .   C O N F I G U R A T I O N

This program runs on  all Amigas with  AmigaDos 1.2/1.3/2.0.

"req.library" (Version >2.0) is needed for DiskPrint to run.
"asl.library" (OS2.0) is optional.

It uses the "printer.device" so your printer driver should be set properly.
What  you  also  need  are  labels to print on. Possible label formats are:
70x70 mm, 70x50 mm and 70x36mm (sorry, I don't know the size in inch...)


I I .   A B O U T   T H E    P R O G R A M

DiskPrint is used for printing 3,5" and 5.25" disk labels. It was designed
mainly for the public domain field (for printing labels for FD-disks). The
main featu-re is that label data libraries are included (over  2200  labels
in  the  full  working version) and can be loaded into memory so labels for
special FD-disks, e.g. Fishdisks, are available without  use  of  the  key­
board  and  without  waiting  for AmigaDos until the disk directory is read
in. (though DiskPrint is able to read in disk directories).
The  easiest  way to figure out what advantages DiskPrint has is to run the
program and print out some Fish-labels...


I I I .   G E T T I N G   S T A R T E D

The Program can be started either from Workbench or from CLI.

Workbench: Use your mouse and click on the DiskPrint icon.

CLI: "DiskPrint2.8 [-m]/[-i]/[-mi]/[-im]"
     Options:
     -m   Allocates 80000 bytes as data mem for label data libraries.
          (Memory requester won't appear)
     -i   Start DiskPrint "sleeping" (=iconify).
     -im  a combination of -m and -i
     -mi  the same

After  the  program has started a memory requester appears and asks for the
amount of memory to be allocated. Default is 200000 bytes (data mem for 510
labels).

Some default data can be saved as a default file. This file is  located  in
the  s:  -dir of your bootdisk. DiskPrint tries to load this file everytime
it  is  run.  (File  name: DiskPrint.def). Older Versions of DiskPrint also
used a file like this, but the file format has changed so there's no compa-
tibility between these two versions.


I V .   T H E   D I S K P R I N T   W I N D O W

In  the top of the DiskPrint window there are 21 names of FD-disk series. I
know most of them are german... Only two americans sent me  the  share  for
diskprint  so  there seems to be no interest for my program in englishspea-
king countries Three of them are custom - you can put your own disknames in
there.

If you click on one of them the name will be copied  into  the  "diskname"-
gadget. (i.e. "Fred Fish" or "TBAG"). The gadget  on  the  left  spe-cifies
the width of the diskname on the label (normal width / double width)

Below  this  are  two  gadgets  where  you can skip forward/backward by one
label in data memory. (These functions are also available on the arrow keys
left/right)
Between  these  there's  a gadget with a number in it (described below). If
you  hit  this gadget a label with this number will be searched in data me-
mory.
Below you'll find  the  "disktype" -gadget. Normally  you  should leave the
default in it. It describes the general type of the disk contents (for  ex-
ample  shareware,  backup  disk,  public  domain,  free distributable, data
disk, ...).
3 default disktype contents can be defined in the defaults window. See  be-
low.  To change  the  disktype,  press the arrow gadget on the right of the
disktype field or the "cursor up" key.

Below this there are seven string-gadgets where detailed information  about
the  contents is given (for example the program names, versions, copyright,
...). Load the data files as an example.
All these string gadgets  can  be  cleared  by  clicking  into  the  gadget
described  with  a  "C" (left of the contents gadgets). The disktype gadget
will be set to default then. (Keyboard equivalent: "DEL"-key)

On the right there's the disk nr. It can be increased/decreased by moving
the propotional gadget left/right. "+500" increases this number by 500.
The gadget on the right of the diskname appends the number to the name.

If you want to send DiskPrint to sleep  (="iconify")  click  on  "Iconify".
To wake up DiskPrint, activate the little window and press the right mouse-
button.

DiskPrint has some more functions:

- Clear data mem            Clears the data mem. The labels (currently in
                            memory) will be lost!
- Load label data           Load a label data file from disk into memory
                            (requester will open)
- Save label data           Save a label data file on disk
                            (!!! disabled in demo version)
- Delete file               Delete a label file (-> requester)
- >Label into mem           Write the (in the window) actually displayed
                            label into mem at the position by using the
                            write mode shown in the mode gadget (described
                            below)
- Print label               Print the label on your printer. Uses the
                            printer.device. Your printer should be set
                            correctly with "preferences" !
- Mode: append/edit         This is the mode used at "Write into mem":
                            * if in append mode: the label will be appen-
                              ded after the last label in memory
                              (the actual position in memory is ignored)
                             -> use this to append new labels to the end of
                                your data file
                            * if in edit mode: the label in the actual
                              position will be overwritten by the displayed
                              label
                             -> use this to edit old label data. But please
                                be careful...
- Fish Contents             Loads in the contents file of a fishdisk and
                            copies them to the string gadgets.
                            Also loads in version numbers of the files if
                            given in the contents file.
- Search by name            Search for an ASCII text in data memory
                            * Search first: Start searching at the first
                              label in data memory
                            * Search next: Start searching at the actual
                              position in memory
- AutoIncrease              Increase the disk no. by 1 if the "clear"
                            gadget is used
- AutoWrite                 Activates the above listed function "Write
                            into mem" automatically if the "return"-key is
                            pressed in the last contents gadget
                            (be careful: the write mode is relevant)
- Directory tool            Load in a disk directory. See below!
- Preferences               Edit defaults. See below!
- Edit data mem             Edit labels in data mem; see below.
- Multiprint win            Print one label multiple or
                            print a range of labels. See below.


V .   T H E   D I R E C T O R Y    T O O L

Since release 2.7 of DiskPrint it is also  possible to read in disk  direc-
tories  and  use  them to create disk labels. "Load rootdir" reads the root
directory of the drive specified in the gadget on the right. A  maximum  of
36 filenames is listed below the string  gadgets. Click  on these  names to
copy them into the  string  gadgets. "Undo" removes  the  last copied name.
"Clear gadgets" clears the string gadgets. "OK" copies the label from this
window  into  the  main window, "Cancel" doesn't. "df0:" changes the drive.
(Only df0, df1, df2, df3 possible - send me a message if other  drives  are
necessary).
Subdirectorys are printed in another color (OS2.0-cols:  white).  Use  left
mousebutton  to  transfer  name  into the contents fields, click with RIGHT
MOUSEBUTTON to change into the subdirectory.
"Root dir" changes into the root, "parent" into the parent dir.
            __ The root dir is buffered now and read in once __


V I .  T H E    D E F A U L T    W I N D O W

I tried to make DiskPrint's usage as easy as possible so I created the file
"DiskPrint.def".  DiskPrint  tries  to  load  in this file every time it is
run and uses its contents in several routines.

Data to be edited:
Label size:       It is possible to print on three different label sizes.
                  The sizes are 70x70 mm, 70x50 mm and 70x36 mm (with or
                  without headline)
Pathname:         The pathname of a directory containing all label
                  data files (used by the filerequester)
DiskTypes:        ASCII text, will be copied in the DiskType-Gadget every
                  time the "C" (clear)-Gadget is activated.
                  3 possible contents.
Double height ON: Enter hexcode for double height here (see below)
             OFF: Hexcode to turn double height off (see below)
Perforation skip OFF:
                  Hexcode to turn perforation skip of your printer off
                  (Or use it for your own purposes, e.g. another linefeed
                  or a color printing). see below.
                  This sequence (if turned on) is sent to the printer
                  before the first linefeed of a label is sent. (When
                  "Print label" is selected.)
Test label pos.:  Prints out two lines to help you to center the label in
                  your printer.
Custom-Names 1-3: 3 self-definable names (out of 21 in the main window)
Default amount of datamem: Enter your preferred amount of mem.
                  (Memwin won't open if entered)
Iconifywin X- and Y-Pos: Position (upper left edge) where the iconify-
                  window will appear.
Code for n/60":   Enter the code for n/60" here if your label format
                  is a type of exotic...

ON/OFF-GADGETS:
Letter Quality      LQ on/off (printer)
Boldface            Bold on/off (printer)
Double height       Print diskname normal (off) / double height (on)
                    (if hexcode is entered properly)
Headline: 1 blank   Print one blank left of the headline (if "on")
                    (leaves some space to the edge of the label)
Headline: 15 cpi    Print headline condensed (on) or normal width (off)
Perf. skip off      Send hex-sequence (see above) to printer if "on"
App. # to diskno    Copy "#"-char left of diskno. if arrow gadget (to copy
                    the diskno into the diskname field) is hit (and if
                    turned on)
Send n/60 + lf      Send code entered in "Code for n/60"
Use ASL-Filreq.     Only OS2.0: Use ASL-Filereq. instead of REQ-Filereq.

* HEXCODES:

The printer.device doesn't support some printer functions like double
height or perforation off (or special functions of YOUR printer). You can
enter hexcodes there to use these functions.
Please refer to your printer manual.
An example (here: Epson LQ 850)
In your manual:    Double height
                   ON:  Hex: 1b 77 01
                   OFF: Hex: 1b 77 00
so enter in the "ON:" field: 1b7701
(don't leave spaces, use only chars from 0 to 9 and a to f. Always enter
pairs of two digits, e.g. zero should be entered as "00")
If your input was wrong, the screen flashes and the field is cleared).

Hexcodes for LQ-850, NEC P6+, NEC P60:
Double height on:  1b7701
             off:  1b7700
Perf.skip    off:  1b4f
Linefeed           0a


V I I .   E D I T I N G    D A T A    M E M

In this window you can edit the contents of the data mem. The functions
always depend on the label shown in this window.

- Delete label:   Delete the actual label.
- Insert blank:   Insert a blank label at the actual position.
- Double label:   "double" the actual label (insert the actual label
                  at the actual position)
- Cancel:         Exit this window


V I I I .   M U L T I P L E    P R I N T  /   P R I N T    A   R A N G E

- PRINT A LABEL MULTIPLE
  Enter the number of labels to print and use the gadgets to adjust
  the label you wish to print. Then press the "Print labels" gadgets.

- PRINT A RANGE OF LABELS
  Adjust the first and last label to print.
  Pressing "Print labels" starts to print all labels from the first
  to the last one.


I X .   K E Y B O A R D

When no string gadget is active, some gadget functions are also available
on the keyboard as equivalents to some gadgets.

ESC-key            Leave DiskPrint (= Close-gadget)
HELP-key           Open default window (= gadget "defaults")
DEL-key            Clear input fields (= gadget "C")
ARROW-keys lt/rt   One label back/one forward (= +/- -gadgets)


___________________________________________________________________________

Enjoy!



