home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d567 / diskprint.lha / DiskPrint / English / DiskPrint.doc next >
Text File  |  1991-11-21  |  14KB  |  324 lines
  1.                              D I S K P R I N T
  2. --------------------------------------------------------------------------
  3.                             DEMO VERSION 3.4.3e
  4.  
  5.                          copyright by Jan Geissler
  6.                           Hermann-Rombach-Str. 17
  7.                              D-7120 Bietigheim
  8.                               (West) Germany
  9.  
  10. ==========================================================================
  11. SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAR
  12. --------------------------------------------------------------------------
  13.  
  14. DiskPrint is SHAREWARE.                       THIS IS ONLY A DEMO VERSION!
  15.  
  16.                       This is only a limited version.
  17.  
  18. For a fee of 20 US-DOLLARS (only cash, please) you will get the full  wor-
  19. king,  easy-to-install package with the newest version of DiskPrint, about
  20. 2100 labels for FD-Disks (i.e. for all fishdisks) and a help utility which
  21. makes creation of label libraries much easier.
  22.  
  23. You  will also  become a  registred user  of DiskPrint,  so you will get a
  24. message if a new version of DiskPrint is released.
  25. NEW: Since V3.4 updates to foreign countries are available to for a fee of
  26. 5 dollars including postage.
  27.  
  28. -------------------------------------------------------------------------
  29. SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAREWARE  *  SHAR
  30. ==========================================================================
  31.  
  32.  
  33. I.       Configuration
  34.  
  35. II.      About DiskPrint
  36.  
  37. III.     Getting started
  38.  
  39. IV.      DiskPrint main window
  40.  
  41. V.       The Directory Tool
  42.  
  43. VI.      The defaults window
  44.  
  45. VII.     Editing the data mem
  46.  
  47. VIII.    Multiple printing / Print a range
  48.  
  49. IX.      Keyboard functions
  50.  
  51. =========================================================================
  52.  
  53.  
  54. I .   C O N F I G U R A T I O N
  55.  
  56. This program runs on  all Amigas with  AmigaDos 1.2/1.3/2.0.
  57.  
  58. "req.library" (Version >2.0) is needed for DiskPrint to run.
  59. "asl.library" (OS2.0) is optional.
  60.  
  61. It uses the "printer.device" so your printer driver should be set properly.
  62. What  you  also  need  are  labels to print on. Possible label formats are:
  63. 70x70 mm, 70x50 mm and 70x36mm (sorry, I don't know the size in inch...)
  64.  
  65.  
  66. I I .   A B O U T   T H E    P R O G R A M
  67.  
  68. DiskPrint is used for printing 3,5" and 5.25" disk labels. It was designed
  69. mainly for the public domain field (for printing labels for FD-disks). The
  70. main featu-re is that label data libraries are included (over  2200  labels
  71. in  the  full  working version) and can be loaded into memory so labels for
  72. special FD-disks, e.g. Fishdisks, are available without  use  of  the  key­
  73. board  and  without  waiting  for AmigaDos until the disk directory is read
  74. in. (though DiskPrint is able to read in disk directories).
  75. The  easiest  way to figure out what advantages DiskPrint has is to run the
  76. program and print out some Fish-labels...
  77.  
  78.  
  79. I I I .   G E T T I N G   S T A R T E D
  80.  
  81. The Program can be started either from Workbench or from CLI.
  82.  
  83. Workbench: Use your mouse and click on the DiskPrint icon.
  84.  
  85. CLI: "DiskPrint2.8 [-m]/[-i]/[-mi]/[-im]"
  86.      Options:
  87.      -m   Allocates 80000 bytes as data mem for label data libraries.
  88.           (Memory requester won't appear)
  89.      -i   Start DiskPrint "sleeping" (=iconify).
  90.      -im  a combination of -m and -i
  91.      -mi  the same
  92.  
  93. After  the  program has started a memory requester appears and asks for the
  94. amount of memory to be allocated. Default is 200000 bytes (data mem for 510
  95. labels).
  96.  
  97. Some default data can be saved as a default file. This file is  located  in
  98. the  s:  -dir of your bootdisk. DiskPrint tries to load this file everytime
  99. it  is  run.  (File  name: DiskPrint.def). Older Versions of DiskPrint also
  100. used a file like this, but the file format has changed so there's no compa-
  101. tibility between these two versions.
  102.  
  103.  
  104. I V .   T H E   D I S K P R I N T   W I N D O W
  105.  
  106. In  the top of the DiskPrint window there are 21 names of FD-disk series. I
  107. know most of them are german... Only two americans sent me  the  share  for
  108. diskprint  so  there seems to be no interest for my program in englishspea-
  109. king countries Three of them are custom - you can put your own disknames in
  110. there.
  111.  
  112. If you click on one of them the name will be copied  into  the  "diskname"-
  113. gadget. (i.e. "Fred Fish" or "TBAG"). The gadget  on  the  left  spe-cifies
  114. the width of the diskname on the label (normal width / double width)
  115.  
  116. Below  this  are  two  gadgets  where  you can skip forward/backward by one
  117. label in data memory. (These functions are also available on the arrow keys
  118. left/right)
  119. Between  these  there's  a gadget with a number in it (described below). If
  120. you  hit  this gadget a label with this number will be searched in data me-
  121. mory.
  122. Below you'll find  the  "disktype" -gadget. Normally  you  should leave the
  123. default in it. It describes the general type of the disk contents (for  ex-
  124. ample  shareware,  backup  disk,  public  domain,  free distributable, data
  125. disk, ...).
  126. 3 default disktype contents can be defined in the defaults window. See  be-
  127. low.  To change  the  disktype,  press the arrow gadget on the right of the
  128. disktype field or the "cursor up" key.
  129.  
  130. Below this there are seven string-gadgets where detailed information  about
  131. the  contents is given (for example the program names, versions, copyright,
  132. ...). Load the data files as an example.
  133. All these string gadgets  can  be  cleared  by  clicking  into  the  gadget
  134. described  with  a  "C" (left of the contents gadgets). The disktype gadget
  135. will be set to default then. (Keyboard equivalent: "DEL"-key)
  136.  
  137. On the right there's the disk nr. It can be increased/decreased by moving
  138. the propotional gadget left/right. "+500" increases this number by 500.
  139. The gadget on the right of the diskname appends the number to the name.
  140.  
  141. If you want to send DiskPrint to sleep  (="iconify")  click  on  "Iconify".
  142. To wake up DiskPrint, activate the little window and press the right mouse-
  143. button.
  144.  
  145. DiskPrint has some more functions:
  146.  
  147. - Clear data mem            Clears the data mem. The labels (currently in
  148.                             memory) will be lost!
  149. - Load label data           Load a label data file from disk into memory
  150.                             (requester will open)
  151. - Save label data           Save a label data file on disk
  152.                             (!!! disabled in demo version)
  153. - Delete file               Delete a label file (-> requester)
  154. - >Label into mem           Write the (in the window) actually displayed
  155.                             label into mem at the position by using the
  156.                             write mode shown in the mode gadget (described
  157.                             below)
  158. - Print label               Print the label on your printer. Uses the
  159.                             printer.device. Your printer should be set
  160.                             correctly with "preferences" !
  161. - Mode: append/edit         This is the mode used at "Write into mem":
  162.                             * if in append mode: the label will be appen-
  163.                               ded after the last label in memory
  164.                               (the actual position in memory is ignored)
  165.                              -> use this to append new labels to the end of
  166.                                 your data file
  167.                             * if in edit mode: the label in the actual
  168.                               position will be overwritten by the displayed
  169.                               label
  170.                              -> use this to edit old label data. But please
  171.                                 be careful...
  172. - Fish Contents             Loads in the contents file of a fishdisk and
  173.                             copies them to the string gadgets.
  174.                             Also loads in version numbers of the files if
  175.                             given in the contents file.
  176. - Search by name            Search for an ASCII text in data memory
  177.                             * Search first: Start searching at the first
  178.                               label in data memory
  179.                             * Search next: Start searching at the actual
  180.                               position in memory
  181. - AutoIncrease              Increase the disk no. by 1 if the "clear"
  182.                             gadget is used
  183. - AutoWrite                 Activates the above listed function "Write
  184.                             into mem" automatically if the "return"-key is
  185.                             pressed in the last contents gadget
  186.                             (be careful: the write mode is relevant)
  187. - Directory tool            Load in a disk directory. See below!
  188. - Preferences               Edit defaults. See below!
  189. - Edit data mem             Edit labels in data mem; see below.
  190. - Multiprint win            Print one label multiple or
  191.                             print a range of labels. See below.
  192.  
  193.  
  194. V .   T H E   D I R E C T O R Y    T O O L
  195.  
  196. Since release 2.7 of DiskPrint it is also  possible to read in disk  direc-
  197. tories  and  use  them to create disk labels. "Load rootdir" reads the root
  198. directory of the drive specified in the gadget on the right. A  maximum  of
  199. 36 filenames is listed below the string  gadgets. Click  on these  names to
  200. copy them into the  string  gadgets. "Undo" removes  the  last copied name.
  201. "Clear gadgets" clears the string gadgets. "OK" copies the label from this
  202. window  into  the  main window, "Cancel" doesn't. "df0:" changes the drive.
  203. (Only df0, df1, df2, df3 possible - send me a message if other  drives  are
  204. necessary).
  205. Subdirectorys are printed in another color (OS2.0-cols:  white).  Use  left
  206. mousebutton  to  transfer  name  into the contents fields, click with RIGHT
  207. MOUSEBUTTON to change into the subdirectory.
  208. "Root dir" changes into the root, "parent" into the parent dir.
  209.             __ The root dir is buffered now and read in once __
  210.  
  211.  
  212. V I .  T H E    D E F A U L T    W I N D O W
  213.  
  214. I tried to make DiskPrint's usage as easy as possible so I created the file
  215. "DiskPrint.def".  DiskPrint  tries  to  load  in this file every time it is
  216. run and uses its contents in several routines.
  217.  
  218. Data to be edited:
  219. Label size:       It is possible to print on three different label sizes.
  220.                   The sizes are 70x70 mm, 70x50 mm and 70x36 mm (with or
  221.                   without headline)
  222. Pathname:         The pathname of a directory containing all label
  223.                   data files (used by the filerequester)
  224. DiskTypes:        ASCII text, will be copied in the DiskType-Gadget every
  225.                   time the "C" (clear)-Gadget is activated.
  226.                   3 possible contents.
  227. Double height ON: Enter hexcode for double height here (see below)
  228.              OFF: Hexcode to turn double height off (see below)
  229. Perforation skip OFF:
  230.                   Hexcode to turn perforation skip of your printer off
  231.                   (Or use it for your own purposes, e.g. another linefeed
  232.                   or a color printing). see below.
  233.                   This sequence (if turned on) is sent to the printer
  234.                   before the first linefeed of a label is sent. (When
  235.                   "Print label" is selected.)
  236. Test label pos.:  Prints out two lines to help you to center the label in
  237.                   your printer.
  238. Custom-Names 1-3: 3 self-definable names (out of 21 in the main window)
  239. Default amount of datamem: Enter your preferred amount of mem.
  240.                   (Memwin won't open if entered)
  241. Iconifywin X- and Y-Pos: Position (upper left edge) where the iconify-
  242.                   window will appear.
  243. Code for n/60":   Enter the code for n/60" here if your label format
  244.                   is a type of exotic...
  245.  
  246. ON/OFF-GADGETS:
  247. Letter Quality      LQ on/off (printer)
  248. Boldface            Bold on/off (printer)
  249. Double height       Print diskname normal (off) / double height (on)
  250.                     (if hexcode is entered properly)
  251. Headline: 1 blank   Print one blank left of the headline (if "on")
  252.                     (leaves some space to the edge of the label)
  253. Headline: 15 cpi    Print headline condensed (on) or normal width (off)
  254. Perf. skip off      Send hex-sequence (see above) to printer if "on"
  255. App. # to diskno    Copy "#"-char left of diskno. if arrow gadget (to copy
  256.                     the diskno into the diskname field) is hit (and if
  257.                     turned on)
  258. Send n/60 + lf      Send code entered in "Code for n/60"
  259. Use ASL-Filreq.     Only OS2.0: Use ASL-Filereq. instead of REQ-Filereq.
  260.  
  261. * HEXCODES:
  262.  
  263. The printer.device doesn't support some printer functions like double
  264. height or perforation off (or special functions of YOUR printer). You can
  265. enter hexcodes there to use these functions.
  266. Please refer to your printer manual.
  267. An example (here: Epson LQ 850)
  268. In your manual:    Double height
  269.                    ON:  Hex: 1b 77 01
  270.                    OFF: Hex: 1b 77 00
  271. so enter in the "ON:" field: 1b7701
  272. (don't leave spaces, use only chars from 0 to 9 and a to f. Always enter
  273. pairs of two digits, e.g. zero should be entered as "00")
  274. If your input was wrong, the screen flashes and the field is cleared).
  275.  
  276. Hexcodes for LQ-850, NEC P6+, NEC P60:
  277. Double height on:  1b7701
  278.              off:  1b7700
  279. Perf.skip    off:  1b4f
  280. Linefeed           0a
  281.  
  282.  
  283. V I I .   E D I T I N G    D A T A    M E M
  284.  
  285. In this window you can edit the contents of the data mem. The functions
  286. always depend on the label shown in this window.
  287.  
  288. - Delete label:   Delete the actual label.
  289. - Insert blank:   Insert a blank label at the actual position.
  290. - Double label:   "double" the actual label (insert the actual label
  291.                   at the actual position)
  292. - Cancel:         Exit this window
  293.  
  294.  
  295. 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
  296.  
  297. - PRINT A LABEL MULTIPLE
  298.   Enter the number of labels to print and use the gadgets to adjust
  299.   the label you wish to print. Then press the "Print labels" gadgets.
  300.  
  301. - PRINT A RANGE OF LABELS
  302.   Adjust the first and last label to print.
  303.   Pressing "Print labels" starts to print all labels from the first
  304.   to the last one.
  305.  
  306.  
  307. I X .   K E Y B O A R D
  308.  
  309. When no string gadget is active, some gadget functions are also available
  310. on the keyboard as equivalents to some gadgets.
  311.  
  312. ESC-key            Leave DiskPrint (= Close-gadget)
  313. HELP-key           Open default window (= gadget "defaults")
  314. DEL-key            Clear input fields (= gadget "C")
  315. ARROW-keys lt/rt   One label back/one forward (= +/- -gadgets)
  316.  
  317.  
  318. ___________________________________________________________________________
  319.  
  320. Enjoy!
  321.  
  322.  
  323.  
  324.