home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc / jobsdump.lzh / JOBSDUMP.DOC < prev   
Text File  |  1985-12-18  |  7KB  |  146 lines
  1. ***********************************************************************
  2. *                                                                     *
  3. *                           JOBSDUMP V2.0                             *
  4. *                                                                     *
  5. *                   A GRAPHICS SCREEN-DUMP PROGRAM                    *
  6. *                     FOR THE DEC RAINBOW 100 PC                      *
  7. *                                                                     *
  8. *                                 by                                  *
  9. *                          James A. O'Brien                           *
  10. *                                                                     *
  11. *                      4519 Pine Street, Apt. 4                       *
  12. *                      Philadelphia, Pa. 19143                        *
  13. *                                                                     *
  14. *                                                                     *
  15. *                   Tel: (215) 898-4698 (Day)                         *
  16. *                        (215) 747-9196 (Evening)                     *
  17. *                                                                     *
  18. *                       (completed 11/08/85)                          *
  19. ***********************************************************************
  20.     
  21.  
  22.  
  23.     This software may be copied and the copies distributed without 
  24. restriction for non-commercial civilian use.  Copyright is retained by the 
  25. author, and the source code will not be distributed.  If you find this software
  26. useful, you may feel like sending a $15 donation to the author at the above 
  27. address. 
  28.  
  29.  
  30. Hardware Requirements:  (a) DEC Rainbow with Rainbow Graphics Option (RGO)
  31.                             and 128k of random access memory (at least 192k
  32.                             in order to run from within GW-BASIC).  
  33.  
  34.                         (b) DEC LA50 or DEC LA100 dot matrix printer.
  35.  
  36.  
  37.  
  38.                                 (1) GENERAL
  39.                                 ***********
  40.  
  41.        JOBSDUMP is a utility program designed to give the Rainbow computer
  42. an important ability not included with the system - the ability to print out
  43. graphics screens directly on DEC printers.  It prints out both medium and high
  44. resolution graphics screens on DEC LA50 or LA100 printers in either of two 
  45. formats :
  46.  
  47.         (a) Small, which is a dot-for-dot representation of the graphics
  48. screen and is smaller than the screen since printer dots are smaller than
  49. screen pixels for the Rainbow computer.  A small printout takes 3 to 3.5
  50. minutes.
  51.  
  52.         (b) Large, which is a double-size printout rotated 90 degrees counter-
  53. clockwise.  Thus, the right-hand-side of the screen picture is the first part
  54. to arrive at the printer.  Large printouts barely fit on a page, so that some
  55. experimentation is necessary to decide where to position the paper at the start
  56. of a printout.  Actually, the high resolution large printout is a little too
  57. big for the page, so JOBSDUMP neglects the rightmost eight pixels in each
  58. line.  Thus, for high resolution large printouts, the graphics screen is
  59. effectively only 792x240 instead of the usual 800x240.  All other screens, in
  60. both large and small printouts, are reproduced exactly.  A large printout takes
  61. about 7 minutes.
  62.  
  63.  
  64.         The program is interactive, prompting for the resolution and the 
  65. printout size.  At any time, you have the option of aborting the printing
  66. by pressing the "A" key.  This is useful when you are not interested in
  67. printing the remainder of the graphics screen.  
  68.  
  69.         Since printers are monochrome devices, there is no simple way to 
  70. distinguish among the various colours or shades of grey visible on the 
  71. screen.  Any color which differs from black on the screen is therefore
  72. printed out in black on the printer.
  73.  
  74.         A minor problem exists with the DEC LA100 printer, since it cannot
  75. be set to the required aspect ratio of 2:1 for this application.  This will
  76. cause LA100 printouts not to be proportional to the screen.  The worst case 
  77. of this effect will occur when printing out circles, which will appear as
  78. ellipses.  The recommended way of dealing with this is to draw circles on the
  79. screen as ellipses in the first place, if possible, to get the correct
  80. results on paper.
  81.  
  82.  
  83.  
  84.                              (2) Use with GW-BASIC
  85.                              *********************
  86.  
  87.  
  88.         JOBSDUMP is used as follows inside GW-BASIC:
  89.  
  90.  
  91.                            
  92.                        XX SCREEN 2                 'or "SCREEN 1"
  93.                               .                                                   
  94.                               .
  95.               
  96.                        XX REM User's graphics program, etc.              
  97.                               .
  98.                               .
  99.  
  100.                        XX REM The next line is all you need
  101.                        XX SCREEN 0 : SHELL"JOBSDUMP"          
  102.  
  103.  
  104.         As shown in the example above, the program is invoked as a child process
  105. running under GW-BASIC in DOS.  It is very important to include the statement
  106. "SCREEN 0", since otherwise the program will interfere with the graphics
  107. screen.  This is since the "SHELL" command emulates DOS in whatever graphics
  108. mode it happens to be in at the time the command is encountered.  The "XX" in
  109. the example just refers to an arbitrary line number.
  110.  
  111.         The binary code, JOBSDUMP.COM, should be kept in the same diskette
  112. directory as the command processor, COMMAND.COM, in order to function properly. 
  113. Recall that you may tell the system that COMMAND.COM is to be found in the
  114. file X:\PATHNAME\COMMAND.COM by giving it the command
  115.  
  116.                     SET COMSPEC=X:\PATHNAME\COMMAND.COM
  117.  
  118. This is useful, for example, when you are placing COMMAND.COM and JOBSDUMP.COM
  119. on the MDRIVE to eliminate disk access during their operation.
  120.  
  121.  
  122.  
  123.  
  124.                    (3) Use directly from the MS-DOS prompt
  125.                    ***************************************
  126.  
  127.     JOBSDUMP may instead be run directly from the MS-DOS prompt, and it
  128. will print out whatever data remains in the RGO memory, even if it has not
  129. been generated by a GW-BASIC program.  Once an application (such as Lotus
  130. 123, GW-BASIC etc.) has written data into graphics memory, it remains there
  131. until the computer has been turned off unless it is deliberately erased. 
  132. The graphics memory will even survive a <SETUP><CTRL><SETUP> reset operation,
  133. as long as the power is not interrupted.  You must know what the resolution
  134. of the graphics data is, in order to get the correct results the first time. 
  135. However, if the wrong choice is made and garbage is printed out, it is possible
  136. to abort and try again with the correct resolution.  This is possible since
  137. JOBSDUMP was written to be unable to modify graphics memory. 
  138.  
  139.         For example, instead of the last line in the GW-BASIC example above, you
  140. could use the statement:
  141.  
  142.                                 XX SYSTEM
  143.  
  144.  
  145. which takes you back to MS-DOS.  Now, typing "JOBSDUMP" has exactly the same
  146. results as you would have got using the GW-BASIC example above.