home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / disk / misc / diskprint / english / diskprint.doc < prev    next >
Text File  |  1995-02-27  |  22KB  |  476 lines

  1.      ######  ####  #####  ##   ##  ######  ######  #### ##   ## ######
  2.      ##   ##  ##  ##      ##  ##   ##   ## ##   ##  ##  ###  ##   ##
  3.      ##   ##  ##   #####  #####    ##   ## ##   ##  ##  #### ##   ##
  4.      ##   ##  ##       ## ##  ##   ######  ######   ##  ## ####   ##
  5.      ##   ##  ##  ##   ## ##   ##  ##      ##   ##  ##  ##  ###   ##
  6.      ######  ####  #####  ##   ##  ##      ##   ## #### ##   ##   ##
  7.  
  8.      SHAREWARE                               EVALUATION VERSION 3.58e
  9.  
  10.                          copyright by Jan Geissler
  11.                           Hermann-Rombach-Str. 17
  12.                         D-7120 Bietigheim-Bissingen
  13.                               (West) Germany
  14.                     FIDO: "Jan Geissler" @ 2:2407/106.5
  15.                      InterNet: jan@digit.stgt.sub.org
  16.  
  17. ==========================================================================
  18.  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT
  19. --------------------------------------------------------------------------
  20.  
  21.                         This program is SHAREWARE!
  22.  
  23. This is an  evaluation version.  If you  like  DiskPrint,  please  send me
  24. the contribution of $20/$25 (see registration form). As all other program-
  25. mers, I am also dependent upon the sale of my program, and as I still  be-
  26. lieve in the system of shareware or tryware. There has not been much feed-
  27. back to my program yet, and so I am thinking about to sell future develop-
  28. ments to commercial software companies because it's not worth  working  on
  29. a program for about  two years just to get some 80 bucks out of it (that's
  30. all I got from non-german speaking countries yet).
  31.  
  32. The Amiga  is a  great computer and  its FD  scene is unique, so keep this
  33. software system alive and support programmers to keep on developing share-
  34. ware!
  35.  
  36.  
  37.                              --- DISTRIBUTION ---
  38.  
  39. DiskPrint is shareware. This evaluation version was designed to be redis-
  40. tributed only under the following restrictions:
  41.  
  42. · The whole package is complete and is contained in a separate drawer.
  43.   The package includes the following files:
  44.  
  45.      FredFish_580-650.cc      DiskPrint_NTSC.info    MuchMore
  46.      Disk.info                DiskPrint_PAL          Registration
  47.      DiskPrint.doc            DiskPrint_PAL.info     Registration.info
  48.      DiskPrint.doc.info       InstallLibrary         reqtools.library
  49.      DiskPrint.hlp            InstallLibrary.info    Title
  50.      DiskPrint_NTSC           InstallLibrary.bat     Labels.info
  51.      Title.info               Version                Version.info
  52.      XIcon
  53.  
  54. · None of the files listed is changed in any  way  without  the written
  55.   permission of the author (Jan Geissler). The package may  be archived
  56.   with a program like LHA, LHARC or ZOO as long as the all files of the
  57.   package remain unchanged (= can be extracted to their original state)
  58.   and no files are added to the archive.
  59.  
  60. · Download form BBSs is allowed as long as no download fee is  charged.
  61.  
  62. · A fee may be charged to recover distribution costs. The fee  for this
  63.   distribution must not be more than obtaining a public domain diskette
  64.   from Fred Fish.
  65.  
  66.  
  67. -------------------------------------------------------------------------
  68.  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT
  69. ==========================================================================
  70.  
  71.  
  72. I.       Configuration
  73.  
  74. II.      About DiskPrint
  75.  
  76. III.     Getting started
  77.  
  78. IV.      DiskPrint main window
  79.  
  80. V.       The Directory Tool
  81.  
  82. VI.      The defaults window
  83.  
  84. VII.     Editing the data mem
  85.  
  86. VIII.    Multiple printing / Print a range
  87.  
  88. IX.      DeskJet support
  89.  
  90. X.       Keyboard functions
  91.  
  92. =========================================================================
  93.  
  94.  
  95.  
  96. I .   C O N F I G U R A T I O N
  97.  
  98. This program runs on  all Amigas with  AmigaDos 1.2/1.3/2.0.
  99.  
  100. "reqtools.library" is needed for DiskPrint to run.
  101. "asl.library" (under OS2.0) is optional.
  102.  
  103. The "printer.device" is used so your printer driver should be set properly.
  104. What  you  also  need  are  labels to print on. Possible label formats are:
  105. 70x70 mm, 70x50 mm and 70x36mm (sorry, I don't know the size in inch...)
  106.  
  107.  
  108. I I .   A B O U T   T H E    P R O G R A M
  109.  
  110. DiskPrint is used for  printing 3,5" and 5.25" disk labels. It was designed
  111. mainly for the  public domain area  (for printing labels for FD-disks). The
  112. main featu-re is that label data libraries are included (over  2200  labels
  113. in  the  full  working version) and can be loaded into memory so labels for
  114. special FD-disks, e.g. Fishdisks, are available without  use  of  the  key­
  115. board  and  without  waiting  for AmigaDos until the disk directory is read
  116. in. (though DiskPrint is able to read in disk directories).
  117. The  easiest  way to figure out what advantages DiskPrint has is to run the
  118. program and print out some Fish-labels...
  119.  
  120.  
  121. I I I .   G E T T I N G   S T A R T E D
  122.  
  123. The Program can be started either from Workbench or from CLI.
  124.  
  125. Workbench: Use your mouse and click on the DiskPrint icon or
  126.            double-click (or shift-click) a label data file.
  127.            If the tooltype "CX_PopUp=NO" is given, DiskPrint will open
  128.            up in the iconified state.
  129.  
  130. CLI: "DiskPrint [-m]/[-i]/[-mi]/[-im]"
  131.      Options:
  132.      -m   Allocates 80000 bytes as data mem for label data libraries.
  133.           (Memory requester won't appear)
  134.      -i   Start DiskPrint "sleeping" (=iconify).
  135.      -im or -mi  a combination of -m and -i
  136.      Version 3.5 detaches from the CLI.
  137.  
  138. The prefs entered in the "preferences" window of DiskPrint are being stored
  139. in the s: directory of the disk (or harddisk) you booted from.
  140.  
  141. Note to users of V3.4.3 or earlier versions:
  142. Because the  format of this prefs file has changed, you have to reconfigure
  143. DiskPrint 3.5 once again.
  144.  
  145.  
  146. I V .   T H E   D I S K P R I N T   W I N D O W
  147.  
  148. In  the top of the DiskPrint window there are 21 names of FD-disk series. I
  149. know most of them are german, but only two americans sent me  the share for
  150. diskprint so  there seems to be no interest for my program non-german spea-
  151. king countries. Three of these gadgets on the right are configurable.
  152. If selected, the name of the gadget is copied into the "diskname" gadget.
  153.  
  154. The gadget  containing  a <B>  specifies  the  width of the diskname on the
  155. label (normal width (10 cpi) /  double  width  (5 cpi)). This option is ig-
  156. nored in the printout if in DeskJet mode.
  157.  
  158. Below  this  are  two  gadgets  where  you can skip forward/backward by one
  159. label in data memory. (These functions are also available on the arrow keys
  160. left/right)
  161. Between  these  there's  a gadget with a number in it (described below). If
  162. you  hit  this gadget a label with this number will be searched in data me-
  163. mory.
  164. Below you'll find the "disktype" gadget where general information about the
  165. disk contents should be given, for example "backup disk",  "public domain",
  166. "Amiga FD software". Three descriptions can be defined in the prefs window.
  167. They are copied in the disktype gadget by selecting the @-Gadgetnext to the
  168. disktype. (keyboard equivalent: cursor up)
  169.  
  170. Below the disktype gadget are seven string gadgets  where  detailed  infor-
  171. mation about the contents should be given (for example program names, copy-
  172. right, ...).
  173. All string gadgets can be cleared by selecting the "C" gadget. The disktype
  174. gadget is filled with a default then.
  175. The seven contents gadgets can be reformatted by activating the "R" gadget.
  176. This function can also be activated by activating multiple print  or "print
  177. label" while Auto-Reformat (-> Prefs) is active.
  178.  
  179. Next to these string gadgets are fourteen small gadgets with which boldface
  180. and color printing  can be  enabled/disabled. If  selected,  black  gadgets
  181. mean boldface and blue gadgets mean color on.
  182.  
  183. The  disk number which can be increased/decreased with the proprtional gad-
  184. get above is stored next to the diskname gadget. This number is appended to
  185. the diskname by clicking on the number.
  186. "+500" increased/decreases this number by 500.
  187.  
  188. By clicking on the number below the diskname gadget this number is searched
  189. in a loaded label file.
  190.  
  191. Labels in the data memeory can be marked by changing the "-> D" gadget into
  192. a big "D" and then write the label into the memory. (see below).
  193.  
  194.  
  195. The Sleep/Iconify function closes  the  DiskPrint  screen and opens a small
  196. window on the workbench screen to minimize  CPU and memory usage if running
  197. under OS 1.x. When running OS 2.x,  DiskPrint  shows an  "AppIcon"  instead
  198. which can be double-clicked to reactivate the program.
  199.  
  200. DiskPrint has some more functions:
  201.  
  202. - Clear data mem            Clears the data mem. The labels (currently in
  203.                             memory) will be lost!
  204. - Load label data           Load a label data file from disk into memory
  205.                             (requester will open)
  206.                             This function can also be activated when a file
  207.                             icon is dropped on DiskPrint's AppIcon.
  208. - Save label data           Save a label data file on disk
  209.                             (!!! disabled in demo version)
  210. - Delete file               Delete a label file (-> requester)
  211. - >Label into mem           Write the (in the window) actually displayed
  212.                             label into mem at the position by using the
  213.                             write mode shown in the mode gadget (described
  214.                             below)
  215. - Print label               Normal mode:
  216.                               Print the label on your printer. Uses the
  217.                               printer.device. Your printer should be set
  218.                               correctly with "preferences" !
  219.                             DeskJet mode:
  220.                               Store this label in page buffer. Print page
  221.                               if 21 labels were stored.
  222.                               Klick on this gadget with the right button
  223.                               to get an overview how many labels have been
  224.                               stored.
  225. - Mode: append/edit         This is the mode used at "Write into mem":
  226.                             * if in append mode: the label will be appen-
  227.                               ded after the last label in memory
  228.                               (the actual position in memory is ignored)
  229.                              -> use this to append new labels to the end of
  230.                                 your data file
  231.                             * if in edit mode: the label in the actual
  232.                               position will be overwritten by the displayed
  233.                               label
  234.                              -> use this to edit old label data. But please
  235.                                 be careful...
  236. - Fish Contents             Loads in the contents file of a fishdisk and
  237.                             copies them to the string gadgets.
  238.                             Also loads in version numbers of the files if
  239.                             given in the contents file.
  240.                             The drive where the contents will be loaded from
  241.                             can be specified with the small gadget next to
  242.                             the FishContents gadget (0 means df0:, 1 means df1:
  243.                             and so on, "C" means the drive specified in the
  244.                             prefs window).
  245.                             When running OS2.0, a Contents-File can also be
  246.                             dropped on the AppIcon.
  247. - Search by name            Search for an ASCII text in data memory
  248.                             * Search first: Start searching at the first
  249.                               label in data memory
  250.                             * Search next: Start searching at the actual
  251.                               position in memory
  252. - AutoIncrease              Increase the disk no. by 1 if the "clear"
  253.                             gadget is used
  254. - AutoWrite                 Activates the above listed function "Write
  255.                             into mem" automatically if the "return"-key is
  256.                             pressed in the last contents gadget
  257.                             (be careful: the write mode is relevant)
  258. - Directory tool            Load in a disk directory. See below!
  259. - Preferences               Edit defaults. See below!
  260. - Edit data mem             Edit labels in data mem or change marks; see
  261.                             below.
  262. - Multiprint win            Print one label multiple or
  263.                             print a range of labels. See below.
  264.  
  265.  
  266. V .   T H E   D I R E C T O R Y    T O O L
  267.  
  268. Since release 2.7 of DiskPrint it is also  possible to read in disk  direc-
  269. tories  and  use  them to create disk labels. "Load rootdir" reads the root
  270. directory of the drive specified in the gadget on the right. A  maximum  of
  271. 36 filenames is listed below the string  gadgets. Click  on these  names to
  272. copy them into the  string  gadgets. "Undo" removes  the  last copied name.
  273. "Clear gadgets" clears the string gadgets. "OK" copies the label from this
  274. window  into  the  main window, "Cancel" doesn't. "df0:" changes the drive.
  275. (Only df0, df1, df2, df3 possible - send me a message if other  drives  are
  276. necessary).
  277. Subdirectorys are printed in another color (OS2.0-cols:  white).  Use  left
  278. mousebutton  to  transfer  name  into the contents fields, click with RIGHT
  279. MOUSEBUTTON to change into the subdirectory.
  280. "Root dir" changes into the root, "parent" into the parent dir.
  281.  
  282. The root directory of a disk is being buffered.
  283.  
  284. Since version 3.5, the directory tool has its own preferences where several
  285. filters (filter ".dok",".doc",".txt",".info" files) and the sorting  method
  286. (alphabetically  or  file type) can be enabled. These preferences are  also
  287. stored in the  DiskPrint  preferences  file if saved in the main prefrences
  288. window.
  289.  
  290. Since V3.5 ASCII text files  can be  shown with  the directory  tool  if an
  291. external text viewer (for  example  MuchMore  by Fridtjof  Siebert which is
  292. included  in the  DiskPrint  package)  was  entered in the main preferences
  293. window. To  view an ascii file click on "Textfile" and then on the textfile
  294. to be shown.
  295.  
  296.  
  297.  
  298. V I .  D I S K P R I N T    P R E F E R E N C E S    W I N D O W
  299.  
  300. I tried to make DiskPrint's usage as easy as possible so I created the file
  301. "DiskPrint.def"  which is  stored  in  the S: directory of the SYS-disk (or
  302. harddisk) you booted from.
  303.  
  304. Data to be edited:
  305. Label size:       It is possible to print on three different label sizes.
  306.                   The sizes are 70x70 mm, 70x50 mm and 70x36 mm (with or
  307.                   without  headline).  If  in  DeskJet-Mode  (see below),
  308.                   70x36mm and 70x67mm are possible.
  309. Send additional CR: An additional linefeed is sent to ensure compatibility
  310.                   to some "exotic" labels where the space between the
  311.                   labels is non-standard (ca. 6 mm).
  312. Printer:          If you want to use DeskJet or compatibles for  printing,
  313.                   set this to "DeskJet/LaserJet". Otherwise use "Printer.
  314.                   device/Parallel" to use workbench printer driver.
  315. Filerequester:    Filerequester to be used for loading/saving/deleting.
  316.                   ReqTools is default. ASL only available under OS 2.0
  317.                   and Req only avaible is the "req.library" is available
  318.                   in LIBS:
  319. Pathname:         The pathname of a directory containing all label
  320.                   data files (used by the filerequester)
  321. ASCII Reader:     Enter the path & name of your ascii text reader with
  322.                   "%s" where the filename of the file to be shown
  323.                   will be inserted instead of "%s".
  324.                   For example "Dh0:c/Muchmore %s".
  325.                   (Press the return key in this gadget and DiskPrint will
  326.                   check and correct your entry!)
  327. DiskTypes:        ASCII text, will be copied in the DiskType-Gadget every
  328.                   time the "C" (clear)-Gadget is activated.
  329.                   3 possible contents.
  330. Double height ON: Enter hexcode for double height here (see below)
  331.              OFF: Hexcode to turn double height off (see below)
  332.                   (Ignored in DeskJet mode)
  333. Color #:          Number of the color if color printing is enabled in
  334.                   the main window.
  335.                   (Ignored in DeskJet mode)
  336. Perforation skip OFF:
  337.                   Hexcode to turn perforation skip of your printer off
  338.                   (Or use it for your own purposes, e.g. another linefeed
  339.                   or a color printing). see below.
  340.                   This sequence (if turned on) is sent to the printer
  341.                   before the first linefeed of a label is sent. (When
  342.                   "Print label" is selected.)
  343.                   (Ignored in DeskJet mode)
  344. Test label pos.:  Prints out two lines to help you to center the label in
  345.                   your printer.
  346.                   (Do not use this when in DeskJet mode)
  347. Custom-Names 1-3: 3 self-definable names (out of 21 in the main window)
  348. Default amount of datamem: Enter your preferred amount of mem.
  349.                   (Memwin won't open if entered)
  350. Iconifywin X- and Y-Pos: Position (upper left edge) where the iconify-
  351.                   window will appear.
  352.  
  353. ON/OFF-GADGETS:
  354. Letter Quality      LQ on/off (printer)
  355. Double height       Print diskname normal (off) / double height (on)
  356.                     (if hexcode was entered properly)
  357.                     (Ignored in DeskJet mode)
  358. Headline: 1 blank   Print one blank left of the headline (if "on")
  359.                     (leaves some space to the edge of the label)
  360.                     (Ignored in DeskJet mode)
  361. Headline: 15 cpi    Print headline condensed (on) or normal width (off)
  362.                     (Ignored in DeskJet mode)
  363. Perf. skip off      Send hex-sequence (see above) to printer if "on"
  364. App. # to diskno    Copy "#"-char left of diskno. if arrow gadget (to copy
  365.                     the diskno into the diskname field) is hit (and if
  366.                     turned on)
  367. Send n/60 + lf      Send code entered in "Code for n/60"
  368.                     (Ignored in DeskJet mode)
  369. Create Icons        Create Icons if a label file is saved
  370. Center title        If on, the title is centered on the printout.
  371. Center contents     If on, the seven contents lines are being centered
  372.                     on the label (otherwise  left-justified)
  373. Text on backside    Print information on 70x70 labels whether the disk
  374.                     is write enabled or not.
  375.  
  376.  
  377. * HEXCODES:
  378.  
  379. The printer.device doesn't support some printer functions like double
  380. height or perforation off (or special functions of YOUR printer). You can
  381. enter hexcodes there to use these functions.
  382. Please refer to your printer manual.
  383. An example (here: Epson LQ 850)
  384. In your manual:    Double height
  385.                    ON:  Hex: 1b 77 01
  386.                    OFF: Hex: 1b 77 00
  387. so enter in the "ON:" field: 1b7701
  388. (don't leave spaces, use only chars from 0 to 9 and a to f. Always enter
  389. pairs of two digits, e.g. zero should be entered as "00")
  390. If your input was wrong, the screen flashes and the field is cleared).
  391.  
  392. Hexcodes for Epson LQ-850:
  393. Double height on:  1b7701
  394.              off:  1b7700
  395. Perf.skip    off:  1b4f
  396.  
  397.  
  398.  
  399. V I I .   E D I T I N G    D A T A    M E M
  400.  
  401. In this window you can edit the contents of the data mem. The functions
  402. always depend on the label shown in this window.
  403.  
  404. - Delete label:   Delete the actual label.
  405. - Insert blank:   Insert a blank label at the actual position.
  406. - Clone label:    "double" the actual label (insert the actual label
  407.                   at the actual position)
  408. - Cancel:         Exit this window
  409.  
  410. - Clear all:      Clear all marks in label memory.
  411. - Mark all:       Set all marks (mark all labels) in label memory.
  412. - reverse:        invert all marks.
  413.  
  414.  
  415.  
  416.  
  417. 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
  418.  
  419. - PRINT A LABEL MULTIPLE
  420.   Enter the number of labels to print and use the gadgets to adjust
  421.   the label you wish to print. Then press the "Print labels" gadgets.
  422.  
  423. - PRINT A RANGE OF LABELS
  424.   Adjust the first and last label to print.
  425.   Pressing "Print labels" starts to print all labels from the first
  426.   to the last one.
  427.  
  428. - PRINT MARKED
  429.   All marked labels stored in the data memory are printed.
  430.  
  431.  
  432. IX .  D E S K J E T   S U P P O R T
  433.  
  434. DeskJet and compatibles can only print on single label sheets. Therefore
  435. I  added  a special option for these printers. If in DeskJet mode, Disk-
  436. Print stores 21 labels (70x36 mm) / 12 labels (70x67 mm) in memory until
  437. one page is full. Then, DiskPrint prints out the whole page.
  438.  
  439. To get an overview how many labels have been stored,  press  F5 or klick
  440. on the "print label" gadget with the RIGHT mouse button. This  requester
  441. shows the page and which labels have been "filled" by the program.
  442. If you click on one of  the labels  shown, the label currently shown in
  443. the main window can be copied to this label.
  444.  
  445. Some more functions are:
  446. - Print the page manually before it has been filled by the program
  447. - Clear the page
  448.  
  449.  
  450. X .   K E Y B O A R D
  451.  
  452. When no string gadget is active, some gadget functions are also available
  453. on the keyboard as equivalents to some gadgets.
  454.  
  455. ESC-key            Leave DiskPrint (= Close-gadget)
  456. F1                 Preferences window
  457. F5                 DeskJet window (see above)
  458. F10                Repeat last function
  459. 4 (num. kpd)       Jump to first label in data memory
  460. 6 (num. kpd)       Jump to last label
  461. 5 (num. kpd)       Toggle mark
  462. + (num. kpd)       Increase number by 1
  463. - (num. kpd)       Decrease number by 1
  464. ] (num. kpd)       Increase number by 10
  465. [ (num. kpd)       Decrease number by 10
  466. * (num. kpd)       Increase/Decrease Number by 500
  467. / (num. kpd)       Search number in data memory
  468. TAB-key            Sleep
  469. DEL-key            Clear input fields (= gadget "C")
  470. Cursor-keys lt/rt  One label back/one forward
  471. Cursor-key up      Change disktype
  472.  
  473. ___________________________________________________________________________
  474.  
  475. Enjoy!
  476.