home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / apps / powerbase / PrintLabel / !PrintLbls / !Help < prev    next >
Encoding:
Text File  |  1994-02-23  |  12.2 KB  |  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 default units for the setup window. The 'setup' file (in the PrintLbls directory) is plain text.
  151.  
  152.         Here is an example file, the | is not part of the file, but denotes
  153. comments:
  154.  
  155. Homerton.Medium.Oblique | 'Name' font
  156. Homerton.Medium         | 'Address' font
  157. Homerton.Bold           | 'Last line' font
  158. 24 | 'Name' size (pt)
  159. 12 | 'Address' size (pt)
  160. 18000  | top margin (mp)
  161. 36000  | left margin (mp)
  162. 288000 | horizontal edge-to-edge (mp)
  163. 100800 | vertical edge-to-edge (mp)
  164. 14400  | identation per line (mp)
  165. 2  | labels on page horizontally
  166. 8  | labels on page vertically
  167. in | preferred units for setup window
  168.  
  169.         There is a problem with labels on dot matrix printers. Acorn's
  170. printer drivers are page-based. This is not a criticism of the printer
  171. drivers, it is entirely reasonable. However, most dot matrix printer labels
  172. are continuous rools, perhaps with perforations every six labels or so.
  173. Therefore, it is best to define a special page size for them. It might also
  174. be necessary to define a separate printer for them, so that form feeds come
  175. out right: if the line feed value is 1/6th of an inch (70 line approx. on
  176. A4), then you will need to work out the amount of lines per page and add to
  177. job_prologue:
  178.  
  179.         "<27>C" and then the character for the number of lines. This makes
  180. the form feeding come out right. e.g. if it was 18 lines, do "<27>C<18>".
  181.  
  182.         RiscOS 3 printer drivers now have a way of defining this! You need
  183. to declare the text length of a page if you are using a DP-type printer.
  184.  
  185.         Because of its nature, this problem *only* occurs with continuous
  186. roll labels and sheets.
  187.  
  188.         I think that about sums it up! Please feel free to contact me with
  189. any problems or suggestions for mods. etc.
  190.  
  191. I can be contacted as:
  192.  
  193. Steven Haslam
  194. 112 Keighley Road,
  195. Colne,
  196. Lancashire,
  197. BB8 0PH
  198.  
  199. Arcade BBS              #875
  200. Star-Net BBS            #352
  201.  
  202. ****************************************************************************
  203.  
  204. BUG HISTORY (summary)
  205. -----------
  206.  
  207. 0.90- First released version (23/05/91)
  208. 1.00- Added definable label sizes as part of the 'setup' file. (17/11/91)
  209. 1.10- Added setup window for label sizes
  210.       Improved printing routine, made it faster (than 1.00 anyway)
  211.       Added multi-unit support
  212.       Took away error box from program, was causing trouble
  213. 1.11- Indentation level now changeable (15/12/91)
  214.       Took away second error box if 'ESCAPE' pressed during printing
  215.       Improved point size checking (made it work)
  216.       You don't have to enter units in setupW
  217.       You can now drag files to the icon bar
  218.       Fonts auto-revise
  219. 1.12- New SlidingHeap
  220.       Sig. figs. in label setup window
  221.  
  222. ****************************************************************************
  223.  
  224. CREDITS
  225. -------
  226.  
  227. I wrote !PrintLbls. I also wrote the memory manager (SlidingHeap). Interface
  228. Manager was written by SIMON HUNTIGDON. The printer drivers are copyright
  229. Acorn Computers and outline fonts are copyright whoever made them.
  230.  
  231. ****************************************************************************
  232.  
  233. PLUGS
  234. -----
  235.  
  236. If you have enjoyed using this product (ahem) perhaps you would like to know
  237. of other products I have written or co-written? This includes Powerbase, a
  238. fairly powerful tree-based database, which is already in semi-commercial use
  239. in running a sixth form college. Write to me at an address above.
  240.  
  241. ****************************************************************************
  242.  
  243. COPYRIGHT
  244. ---------
  245.  
  246. This program is copyright © 1991 Steven Haslam. However, I allow it to be
  247. Public Domain. You may copy it, give it to friends or upload it to bulletin
  248. boards as you please so long as (A) it is not altered in any way, except for
  249. tailoring of !Boot or !Run without me seeing it first, and (B) you do not do
  250. so for a profit. I reserve the right to withdraw its Public Domain status at
  251. any time at my own discretion. You are also allowed to use parts of this
  252. program in your own program as long as you inform me and give me suitable
  253. credit.
  254.  
  255. DISCLAIMER
  256. ----------
  257.  
  258. No warranty, express or implied, is given with this product, and I can not
  259. be held responsible for any damage to your health, wealth or marraige due to
  260. the action (or inaction) of this product. Use of it is done at entirely your
  261. own risk. All rights reserved.
  262.  
  263. ****************************************************************************
  264.