home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / msdos / printer / sider.arc / SIDER.DOC < prev    next >
Encoding:
Text File  |  1988-01-12  |  5.8 KB  |  181 lines
  1. SIDER.PAS by Bob MacDonald  Rt#1, Box 849  Lewisport, Ky  42351
  2.  
  3.  
  4.   While working at home one evening recently I had a need to print a
  5.  
  6. spreadsheet sideways.  Not having a copy of Funk Software's SIDEWAYS pro-
  7.  
  8. gram, I started rummaging through a pile of Turbo Pascal(TP) public domain
  9.  
  10. disks in search of a program to accomplish this task. At last there it was.
  11.  
  12. Ready to get on with the business at hand I ran the program.  Whoops, 
  13.  
  14. nothing happened.  After pulling the program into the editor for a quick
  15.  
  16. looksee, I discovered why the program wouldn't work.  It was obviously
  17.  
  18. written using a much earlier version of TP (I use version 3.01) and had
  19.  
  20. some problems.  After making the necessary changes I was able to get the
  21.  
  22. work printed as needed.  At this point the program was functional, but
  23.  
  24. lacked flexibility and an improved user interface.  Since it had definite
  25.  
  26. utility and represented a challenge, I decided to rewrite it to maximize
  27.  
  28. the potential which existed.  Thus it is that SIDER.PAS came to be.
  29.  
  30.   SIDER utilizes the ROM character set located at F000:FA6E to form the
  31.  
  32. first 128 ascii characters rotated clockwise 90 degrees.  This enables
  33.  
  34. you to print a .PRN or ascii file sideways on an EPSON FX/LX-80
  35.  
  36. printer or compatible.  Before going any further I want to point out that 
  37.  
  38. the program should run on any graphics printer, and later on I'll explain
  39.  
  40. how to adapt it to other models.  The program is easy to run and requires
  41.  
  42. minimal documentation.  Simply use the left/right arrow keys to move to the
  43.  
  44. desired option and press enter.  Main menu options are as follows:
  45.  
  46.   VIEW - Toggles writing to screen on or off while printing.  I like it on
  47.  
  48.          soley because it gives me something to look at while waiting for
  49.  
  50.          the system to return.
  51.  
  52.   SIZE - Provides for selection from the three available print sizes.
  53.  
  54.          These sizes are Normal(9 cpi/6 lpi), Short(12 cpi/6 lpi), and
  55.  
  56.          Small(12 cpi/10 lpi).  Line spacings work out to yield 48 
  57.  
  58.          lines/page and 85 lines/page respectively.
  59.  
  60.   PRINT - Enter the path/drive and file to be printed and print  it.
  61.  
  62.   QUIT - Exit program and return to DOS.
  63.  
  64.   HELP - Brief help screen.
  65.  
  66. In order to keep you aware of current settings a status "window" illustrates
  67.  
  68. the current printout variables.             
  69.  
  70.   Those of you who have SYS_STAT.PAS(ref. Soft Sector March,1987 or PCM
  71.  
  72. June, 1987) will see that the include files ($I) are basically the same as 
  73.  
  74. used there.  To simplify things you can copy those needed to a separate
  75.  
  76. subdirectory or floppy and modify as required.
  77.  
  78.   SYSTEM REQUIREMENTS:  In order to run SIDER you'll need an IBM PC/XT/AT
  79.  
  80. or compatible running under DOS 2.XX or above.  Detection of color monitor
  81.  
  82. and proper cursor control is handled by the VIDEO.LIB.  I have used 
  83.  
  84. various TEXTCOLOR options to optimize presentation on a monochrome monitor.
  85.  
  86. Therefore, if you are using CGA, there are several alternatives available.
  87.  
  88. Omit all occurrences of TXT(xx) in the listing; review the table provided
  89.  
  90. with the "txt" function and predetermine your alternatives; or do nothing
  91.  
  92. and accept the colors as written.  None of these options will result in any
  93.  
  94. adverse consequences.  The visual losses are underlining of headings and
  95.  
  96. intensity levels.
  97.  
  98.   PRINTER COMPATIBILITY:  Although written specifically for an EPSON LX80,
  99.  
  100. SIDER has been tested successfully on several 'FX' compatible printers. An
  101.  
  102. easy way to predetermine if it will run on your printer is to look in your
  103.  
  104. owners manual to insure the following codes are applicable:
  105.  
  106.   ESC + 'A' + n   = line spacing in n/72's
  107.   ESC + 'K'       = graphics mode - single density
  108.   ESC + 'L'       = graphics mode - double density
  109.   ESC + '@'       = reset to defaults(optional -if not available reset by 
  110.                     turning off and on after printing)
  111.  
  112. On the other hand, if these features are available for your printer using
  113.  
  114. different codes, your still in luck.  Selection of line spacing and the
  115.  
  116. graph mode occur infrequently  and are noted in the listing so you can
  117.  
  118. modify it to your needs. 
  119.  
  120.   SHORTCUTS:  Frequently I spiffy-up programs more than others care to do.
  121.  
  122. Therefore, I have some tips to shorten the listings as presented without
  123.  
  124. effecting the functionality of the program.  First, the SIDERHLP.INC file
  125.  
  126. is not essential.  Don't bother to type it in and change line 8 of the
  127.  
  128. "main_menu" procedure to "choice := menu123(4,19,25,3,7)", and omit the 
  129.  
  130. three lines so noted in the listing.  Secondly, the ASK.LIB  can also
  131.  
  132. be left out.  To accomplish this delete line 7 in the "do_it" procedure
  133.  
  134. and insert the two following lines:
  135.  
  136.     gotoxy(3,7);write('What file would you like to print sideways: ';
  137.     readln(answer);
  138.  
  139. Remember to  delete the include statements as also noted in the listing.
  140.  
  141. This "striped-down" version will still provide all the features of the
  142.  
  143. complete listing.  Of course you can always add these trimmings by
  144.  
  145. reversing the above steps.
  146.  
  147.   LIMITATIONS:  Sider presently has two limitations which you need to be
  148.  
  149. aware of:
  150.  
  151.   1) In order to obtain a nice looking print-out it is necessary to insure
  152.  
  153.      something is printed on the last available line of the page.  I 
  154.  
  155.      normally use the date issued for this purpose.  For "Normal" printsize
  156.  
  157.      this is line 48, or multiples there of, while the other two are line
  158.  
  159.      85.
  160.  
  161.   2) There is no provision for I/O errors so be careful to use valid file, 
  162.  
  163.      path, and drive descriptions.   
  164.   
  165.  
  166. If you have any problems, improvements, or  suggestions, I'd appreciate
  167.  
  168. hearing from you.
  169.  
  170.  
  171.  
  172.   
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.