home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / prntutil.zip / LINES.DOC < prev    next >
Text File  |  1987-04-29  |  9KB  |  172 lines
  1. .en      This file is formatted for IMAGEPRINT
  2. .nw
  3. .lm 5
  4. .ef
  5. .ef LINES V2.0 INSTRUCTIONS...&&...4/29/87
  6. .ef
  7. .ef
  8. .ef
  9. .ef
  10. .ef
  11.  
  12.                        INSTRUCTIONS FOR LINES V2.0
  13.                            By Mike Callahan
  14.                National Weather Service, Louisville, KY
  15.                             April 29, 1987
  16.  
  17. One of the greatest things about the IBM extended character set is the
  18. line drawing characters.  Using these, one can make very professional
  19. looking forms right on the screen.  However, many word processors cannot
  20. display these characters, and even in the ones that do, the process of
  21. looking up which of the 38 characters to use for line intersections and
  22. entering these characters using the Alt key quickly becomes a chore.
  23.  
  24. LINES changes all of that.  Using any word processor or editor, the user
  25. simply includes special marks of where they want horizontal or vertical
  26. lines and intersections.  The marks are as follows:
  27. - for single horizontal lines,
  28. = for double horizontal lines,
  29. | for single vertical lines,
  30. " for double vertical lines,
  31. + for intersections which connect to other intersections with single lines,
  32. # for intersections which connect to other intersections with double lines,
  33. * for intersections which are not connected to other intersections.
  34.  
  35. After this is done, the user saves this information in an ASCII file and
  36. runs the program.  LINES will scan the file and intelligently converts
  37. the marks to the line drawing characters in a few seconds.
  38.  
  39.  
  40.                           HOW THE PROGRAM WORKS
  41.  
  42. To run the program, type the following line:
  43.  
  44. LINES INNAME OUTNAME      where:
  45.  
  46. INNAME is the name of the input file.  If omitted the program will not work
  47. and will remind you to type an INNAME.
  48.  
  49. OUTNAME is the name of the output file.  If omitted the program will write
  50. over INNAME.  If OUTNAME is PRN, the line drawings will go to the printer
  51. if your printer can handle line drawing characters.
  52.  
  53. Here is an example of what lines will do.  Imagine TEST.TXT contains the
  54. following text:
  55.  
  56. *=*=============*=*===============##================#
  57. "a| | is a bar  |d| = is a equals ""connecting boxes"
  58. *-*-------------*-*---------------++----------------#
  59. "b| + is a plus |e| # is a pound  "
  60. *-*-------------*-*---------------**--------------------*
  61. "c| - is a dash |f| " is a quote  ""non-connecting boxes"
  62. *=*=============*=*===============**====================*
  63.  
  64. .pa
  65. After typing: LINES TEST.TXT TEST.PIC, TEST.PIC will look like this:
  66.  
  67. ╔═╤═════════════╤═╤═══════════════╦╦════════════════╗
  68. ║a│ | is a bar  │d│ = is a equals ║║connecting boxes║
  69. ╟─┼─────────────┼─┼───────────────╫╨────────────────╜
  70. ║b│ + is a plus │e│ # is a pound  ║
  71. ╟─┼─────────────┼─┼───────────────╢╓────────────────────╖
  72. ║c│ - is a dash │f│ " is a quote  ║║non-connecting boxes║
  73. ╚═╧═════════════╧═╧═══════════════╝╚════════════════════╝
  74.  
  75. Notice that the program has intelligence.  Whenever it finds a mark, it
  76. looks behind, ahead, above and below that character.  If it does not
  77. find another mark, it leaves the character alone.
  78.  
  79. When using WYSIWYG (What You See Is What You Get) word processors, make
  80. sure that printer control codes (such as boldface, underline, etc.) do not
  81. mess up how characters line up. Sometimes, it is best to convert text to
  82. line drawing characters first, and then insert the codes.
  83.  
  84. For an example of a real application, here is a sample input file named
  85. FORM.TXT:
  86.  
  87.                               A SAMPLE FORM
  88. ========*=============================*===========================*========
  89. NAME    "                             |                           |
  90. --------*------------*-last-----------*------------first----------*-middle-
  91. ADDRESS "            |                                            |
  92. --------*---number---*-----------street---------------*-----------*--apt---
  93. TOWN    "                                             |           |
  94. --------*--city----------------*-------------*--------*---state---*--zip---
  95. STORE   "                      " SALESPERSON "
  96. ========*======================*=============*=============================
  97. ========*====================================================*=============
  98.    QTY  |                     ITEM                           |     COST
  99. ========*====================================================*========*====
  100.         |                                                    |        |
  101. --------*----------------------------------------------------*--------*----
  102.         |                                                    |        |
  103. --------*----------------------------------------------------*--------*----
  104.         |                                                    |        |
  105. --------*----------------------------------------------------*--------*----
  106.         |                                                    |        |
  107. --------*----------------------------------------------------*--------*----
  108.         |                                                    |        |
  109. ========*========================================*===========*========*====
  110.      *------------------------*                  " SUBTOTAL  |        |
  111. VISA |                        |                  *-----------*--------*----
  112.      *------------------------*                  " SALES TAX |        |
  113. MC   |                        |                  *-----------*--------*----
  114.      *------------------------*                  " TOTAL     |        |
  115.                                                  *===========*========*====
  116.  
  117. .pa
  118. And here is what the converted form looks like:
  119.  
  120.                               A SAMPLE FORM
  121. ════════╦═════════════════════════════╤═══════════════════════════╤════════
  122. NAME    ║                             │                           │
  123. ────────╫────────────┬─last───────────┴────────────first──────────┼─middle-
  124. ADDRESS ║            │                                            │
  125. ────────╫───number───┴───────────street───────────────┬───────────┼──apt───
  126. TOWN    ║                                             │           │
  127. ────────╫──city────────────────╥─────────────╥────────┴───state───┴──zip───
  128. STORE   ║                      ║ SALESPERSON ║
  129. ════════╩══════════════════════╩═════════════╩═════════════════════════════
  130. ════════╤════════════════════════════════════════════════════╤═════════════
  131.    QTY  │                     ITEM                           │     COST
  132. ════════╪════════════════════════════════════════════════════╪════════╤════
  133.         │                                                    │        │
  134. ────────┼────────────────────────────────────────────────────┼────────┼────
  135.         │                                                    │        │
  136. ────────┼────────────────────────────────────────────────────┼────────┼────
  137.         │                                                    │        │
  138. ────────┼────────────────────────────────────────────────────┼────────┼────
  139.         │                                                    │        │
  140. ────────┼────────────────────────────────────────────────────┼────────┼────
  141.         │                                                    │        │
  142. ════════╧════════════════════════════════════════╦═══════════╪════════╪════
  143.      ┌────────────────────────┐                  ║ SUBTOTAL  │        │
  144. VISA │                        │                  ╟───────────┼────────┼────
  145.      ├────────────────────────┤                  ║ SALES TAX │        │
  146. MC   │                        │                  ╟───────────┼────────┼────
  147.      └────────────────────────┘                  ║ TOTAL     │        │
  148.                                                  ╚═══════════╧════════╧════
  149.  
  150. There are some possible intersections of single and double lines that
  151. are not included in the IBM line characters.  If this is the case, LINES
  152. will leave the mark in the file.  For these rare cases, one can simply
  153. insert a substitute intersection character using the Alt key.
  154.  
  155. It is possible to get a printer copy of any LINES converted files using
  156. IMAGEPRINT from Image Computer Systems.  This is an excellent user-
  157. supported program that lets printers produce near-letter quality text
  158. in several fonts and pitches as well as the entire IBM extended character
  159. set.  The cost is $20.
  160.  
  161. Have fun and let me know if you enjoy it and/or make any improvements.  By
  162. the way, there is absolutely no restrictions or fees on this program.
  163. However, I would like some credit if you use my code.  That is only fair!
  164. The entire C source is in lines.c on this disk.  I used generic C as much
  165. as possible so porting should be no problem.
  166.  
  167.                                      Mike Callahan
  168.                                      National Weather Service
  169.                                      1020 Standiford Lane
  170.                                      Louisville, KY  40213
  171.  
  172.