home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsp / printlbls / !PrintLbls / !Help < prev    next >
Text File  |  1994-02-23  |  13KB  |  264 lines

  1. ----------------------------------------------------------------------------
  2. File:           Help text file (ASCII)
  3. Date:           23rd February 1994
  4. Application:    !PrintLbls
  5. Version:        1.12 (23rd February 1994)
  6. Author(s):      Steven Haslam
  7. Purpose if any: Label printing using outline fonts and RISC-OS PDrivers
  8. ----------------------------------------------------------------------------
  9.  
  10.         !PrintLbls I wrote to be able to print labels of a standard rather
  11. superior to draft printed labels usually found on mailshots, council letters
  12. etc. etc. The idea was to take a simply-structured file and convert it to
  13. labels that were in outline fonts, to allow maximal impression on
  14. recipients.
  15.  
  16.         I decided that it was best to use the outline fonts for this, and
  17. also to use the RISC-OS printer drivers, despite all the problems this may
  18. cause.
  19.  
  20.         I decided on Comma Separated Value files for input: this is fairly
  21. standard for many applications, and is easy to create and understand. (it is
  22. also incidentally the format for !1stMail merging)
  23.  
  24.         Version 0.90, which was uploaded to various bulletin boards and
  25. dated 23 May, was very poor and only just worked in a very limited fashion.
  26. It allowed user-selectable fonts for the first line, middle lies and last
  27. line. it also allowed the first line to be bigger (or smaller). However, it
  28. assumed that the user used the same labels as I did and that they set up the
  29. printer driver right! (This printer driver problem still exists).
  30.  
  31.         Then, I was sent a letter by someone who was having trouble with it,
  32. because they were using it on a two-stock label page with a laser printer.
  33. Therefore, I decided that since it might be used, it ought to be usable.
  34.  
  35.         Versions 1.00 and 1.10 came into being on the same day. Version 1.00
  36. allowed setting up by writing a text file containing the label measurements.
  37. In 1.10 (this afternoon) I added a window, sprite and icons so that
  38. measurements could be entered straight into the program.
  39.  
  40.         Version 1.11 allows the user to set the indentation per line,
  41. allowing labels to be printed with each line starting at the same position
  42. on the left. It is even possible to get the address to slope backwards by
  43. using a negative value. There has been some internal tidying up, including
  44. bugfixes if a ridiculous point size is entered, or no units are put on.
  45. Version 1.11 does not require that you open the window at any time if you
  46. have set up the options as you like them. I have also added an auto-revise
  47. option, which checks every second for a change in the list of fonts. If it
  48. finds a difference, it re-assembles the font menu. If you remove all the
  49. fonts, PrintLbls will complain!
  50.  
  51.         Version 1.12 uses version 2.00 of the sliding heap manager and hence can be used alongside applications such as PowerBase &c. that also use SlidingHeap 2.00. Also, the labels setup window now enforces that measurements (apart from those in points and millipoints) are given only to 3 signifcant figures: avoiding long trails of decimals that may occur when units are converted.
  52.  
  53. Using !PrintLbls
  54. ----------------
  55.  
  56.         The input file is a simple CSV file. Each 'record' for a single
  57. person (or other entity) is terminated by a 'null', e.g. a linefeed or a
  58. carraige return. Each line for the address is separated by a comma. If the
  59. first character of a line is character 34 (") then all commas are skipped
  60. until a second 34. This allows commas to occur in a line, and also fits in
  61. with many programs' idea of a CSV file.
  62.  
  63.         Here is an example record:
  64.  
  65. Steven Haslam,"112, Keighley Road",Colne,Lancashire,BB8 0PH
  66.  
  67.         In !Edit, each record would be a separate line in the file.
  68.  
  69.         The filetype can be either &FFF (text) or &DFE (offical CSV
  70. filetype)
  71.  
  72.         !PrintLbls is loaded by double-clicking on its icon in the Filer.
  73. When it has loaded it checks that some fonts are present, and if some are it
  74. checks them against the list it holds of fonts to be used. If any fonts are
  75. to be used that are not present, you will be informed and a present font
  76. will be substituted. (0.90 may have contained a font in itself that was
  77. added to the Path, this is not done with 1.10).
  78.  
  79.         So, you should now have the PrintLbls icon on your icon bar. Click
  80. on it with SELECT and you will get the main window. This contains: a load
  81. target for a CSV file, a box with information about the current printer
  82. driver, a 'Print' button, a box with information about the current fonts and
  83. a 'revise font list' button and also a 'Set up labels' button.
  84.  
  85.         To load a CSV file, drag it to the lad target (the large arrow). The
  86. text icon will change from "« None »" to the file name, or "Data from
  87. TaskName" if it has been dragged straight from a task (e.g. !Edit).
  88.  
  89.         If you have a printer driver installed, then you can 'press' the
  90. Print button and the labels will be printed through your printer driver. If
  91. all the labels can not be fitted onto one page, then more than one page will
  92. be used.
  93.  
  94.         Alternatively, if all your options have been set up as below, you
  95. can simply drag your CSV file to the icon on the icon bar. A confirmation
  96. box will ask you if you want to print it as the current printer resolution.
  97. Therefore you do not have to open the window at any time.
  98.  
  99.         It is unlikely that your labels will be the same size as they are by
  100. default, or that you will want the same font types & sizes as I use. To
  101. cahnge the label sizes, click on the 'Set up labels' button. This opens the
  102. setup window. It contains a diagrammatic sprite of the label relative the
  103. the top left of a page. The measurements are in writeable icons, click on
  104. them and use the keyboard to alter them. Allowed units are: "in", "pt", "mp"
  105. (millipoints), "mm" and "cm". All units are stored as millipoints
  106. internally, so rounding errors may occur when using millimetres or
  107. centimetres.
  108.  
  109.         You will also see two writeable icons for how many labels there are
  110. across and down the page. When printing, the program goes across before
  111. going down, so you can use half a page at first and then another half later.
  112.  
  113.         The 'Identation per line' icon allows the 'tabbing' of each line to
  114. be changed. I generally use 0.1 or 0.2 inches. Setting this to 0 makes each
  115. line start at the same place, setting it to a negative value allows the
  116. lines to slope backwards!
  117.  
  118.         There are three buttons at the bottom: 'Cancel' closes the window
  119. and makes no changes to theinternal variables, 'OK' closes the window and
  120. updates the internal variables as does 'Save' which also re-saves the
  121. configuration file.
  122.  
  123.         To set up the fonts, click MENU over the main window and go to
  124. sub-menu 'Fonts'. This leads to a submenu containing 'Name', 'Address' and
  125. 'Last line'. You can have a font for the name, a font for the address and a
  126. font for the last line (i.e. put the postcode {!} in bold). There are two
  127. writeable icons in the main window that control the size (in points) of the
  128. font used for the name and the address (including the last line). Presing
  129. 'Revise font list' rescans the fonts, useful if you load in more fonts while
  130. the program is still running.
  131.  
  132.         On the main window's menu is the option 'Remove CSV' which removes
  133. the CSV file from memory
  134.  
  135.         Also on the main window's menu is the sub-menu option 'Units'. This
  136. controls which units are used by default in the setup window. Notice that
  137. because clicking OK in the setup window changes the strings to real numbers,
  138. rounding error may occur if the window has been displayed in metric measure
  139. when the measurements are intended for imperial lengths. Notice that any
  140. measuring system can be used in the setup window, you can even combine
  141. points, millimetres, inches and centimetres all at the same time, although
  142. this is not good for your sanity!
  143.  
  144.         From the icon bar menu, there are three options: 'Info' leads to the
  145. standard info box, 'Save setup' re-saves the configuration file and 'Quit'
  146. has the expected effect.
  147.  
  148.         Information kept in the configuration file is as follows:
  149.  
  150.         The three font names, the two font sizes, the label measurements, the number of labels across and down, and the def