home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / B_A_BOX1.LZH / SCRDMP24.FOL / SCRDMP24.TXT < prev   
Text File  |  1991-05-29  |  10KB  |  226 lines
  1.                   24-pin Printer Screen Dump Utility v. 2.0          10/18/88
  2.                                     by
  3.                                 Dan Wilga
  4.  
  5.  
  6.  
  7. This program is designed as a replacement for the screen dump function built-
  8. into GEM, for people who, like me, went out and bought a 24-pin printer only
  9. to discover that GEM was not designed to take full advantage of the higher
  10. resolutions offered by these printers. The program includes the ability to
  11. choose various sizes for the output, send the printout in "landscape" mode,
  12. or even directly to a disk file so that multiple copies of the same dump
  13. can be made easily.
  14.  
  15.  
  16. Changes from version 1.0:
  17.  
  18.   The default scaling for high resolution has been corrected.
  19.   Scaling factors may now range from 1 to 9, not just 1 to 4 or 8. Using a
  20.       number that cannot be evenly divided into 24 for the y-scaling
  21.       (5, 7, or 9) produces extra lines of dots. They are really barely
  22.       noticeable though.
  23.   Landscape dumps can be made.
  24.   A configuration file can be used to specify new default values.
  25.   Output to disk is slightly faster now that it is buffered.
  26.   Previously, sending two screen dumps of different lengths without
  27.       deleting the disk file in between would cause the file to be
  28.       garbaged if the second output was shorter than the first.
  29.   Also, in the first version, pressing Control-C to stop a program would
  30.       cause a system re-boot under TOS 1.4.
  31.  
  32.  
  33. Use:
  34.  
  35.   To install the screen dump program, either place SCRDMP24.PRG in the AUTO
  36.   folder of the disk you boot your system with, or click on this file from
  37.   the desktop. If you are using a configuration file for the default settings,
  38.   place this file in the same folder as the program, unless you have placed
  39.   SCRDMP24.PRG in an AUTO folder for automatic execution at boot in which case
  40.   you should place the config file in the *root* directory. See below for a
  41.   description of the contents of the configuration file.
  42.   
  43.   From that point on, whenever you hold down the Alt key and press Help (or
  44.   select "Print Desktop" ) my program takes over.
  45.   
  46.   This program also intercepts any calls to the XBIOS command Scrdmp(), or
  47.   the VDI function v_hardcopy(). This is possible because Atari provided
  48.   one vector that would take care of all these situations. The only programs
  49.   this one is incompatible with are those that also intercept the Atl-Help
  50.   key combination.
  51.   
  52.  
  53. Scaling:
  54.  
  55.   This program has the ability to expand the image being printed in both the
  56.   horizontal and vertical directions. This is necessary because if no scaling
  57.   is done on a 24-pin printer then, at 360 dpi, a medium resolution image
  58.   ends up being 640/360, or 1.8 inches wide!
  59.   
  60.   Scaling causes the data for each row or column of dots that make up the
  61.   picture to be duplicated. For instance, a scaling factor of (2,2) -- the
  62.   first '2' refers to the horizontal direction, and the second to the
  63.   vertical -- will mean that each row and column of dots is duplicated once,
  64.   (3,3) means each is duplicated twice.
  65.   
  66.   Because of the way 24-pin printers work, you will probably not be that
  67.   thrilled with the quality at (1,1) scaling anyway, not to mention the
  68.   size of the picture. In order to give the printer head time to shoot-out
  69.   enough ink, you usually have to use a scaling of atleast (2,2).
  70.   
  71.   For landscape printing, the x-scale refers to the scaling of the image
  72.   across the narrow edge of the printed page. Please note that a y-scale
  73.   of nine in landscape mode produces unusual results.
  74.  
  75.   If you want to get a printout that does not look distorted, you should set
  76.   the ratio of the scaling as follows. The "Largest" column shows you the
  77.   largest scaling that will fit completely on an 8.5 x 11" page for that
  78.   resolution and mode, while maintaining the appropriate ratio:
  79.   
  80.                   -- Normal Mode --     -- Landscape Mode --
  81.   Resolution:     Ratio:    Largest:    Ratio:      Largest:
  82.   ----------      -----     -------     -----       -------
  83.      low           2:1       (8,4)       2:1         (4,4)
  84.     medium         1:1       (4,4)       4:1         (4,2)
  85.      high          2:1       (4,2)       2:1         (2,2)
  86.  
  87.  
  88. Landscape Mode:
  89.  
  90.   Sometimes it is preferable to have the picture sideways on the page. This
  91.   is referred to as "Landscape Mode". This is the opposite of "Normal" or
  92.   "Portrait Mode".
  93.   
  94.  
  95. Changing options:
  96.  
  97.   If a configuration file is not present when this program has been first
  98.   run, then the scaling factors are set for the resolution you booted in,
  99.   according to the first "Largest" column of the chart above. Also, output
  100.   defaults to the printer and in Normal mode.
  101.   
  102.   To change these settings, you simply have to do the following:
  103.   
  104.     1.  Press Alt-Help.
  105.     2.  You then have a few seconds to enter parameters. Begin by typing a
  106.         horizontal scaling factor from 1 to 9 by simply pressing the
  107.         appropriate key on either the numeric keypad or the main keyboard.
  108.         If a correct key has been pressed, you will see the screen flicker
  109.         briefly to show you that your input has been accepted.
  110.     3.  If you selected a horizontal scaling factor, you can then do the
  111.         same for the vertical. Again, this is a number from 1 to 9.
  112.     4.  The next parameter determines where the output is to be sent. Press
  113.         the "d" key to send it to a disk file, or the "p" key to send it to
  114.         the printer.
  115.     5.  The final parameter chooses Portrait or Normal modes. Press either
  116.         the "p" or the "n" key.
  117.     5.  When all parameters have been entered, or too much time has elapsed
  118.         between keypresses, a bell will sound. This means that output is
  119.         about to begin.
  120.  
  121.   If you skip a setting, it will retain its previous value. For example:
  122.   
  123.     You have just re-booted in medium resolution without a configuration file.
  124.         The default settings for this resolution are "4", "4", "p", and "n".
  125.     You press Alt-Help.
  126.     Then, you hit the "2" key and wait for the bell to sound.
  127.     The result would be 2-times scaling in the horizontal direction, 4-times
  128.         in the vertical, and output going to the printer in 
  129.  
  130.   This also means that if you send one printout to a disk file and then want
  131.   to revert to using the printer, you will have to use the "p" option.
  132.  
  133.   The one disadvantage to this method is that if you just want to change the
  134.   y-scaling, you must first set the x-scaling, since the order is critical.
  135.  
  136.  
  137. Disk Output:
  138.  
  139.   When the "d" option is active, the output is redirected from the printer
  140.   to a disk file. The name of the file will always be "SCRDMP24.DAT" and it
  141.   will always be in the root directory of the drive that SCRDMP24.PRG was on
  142.   when you first ran it.
  143.  
  144.   If, for some reason, the file could not be opened, output is sent to the
  145.   printer. Beware that there is very little error handling for this feature.
  146.   
  147.  
  148. Stopping:
  149.  
  150.   Since any screen dump can be time consuming (not to mention noisy) you
  151.   will be glad to know that a very responsive method of aborting has been
  152.   included. Simply hold down the Control key and press "c". This will free-up
  153.   the mouse almost immediately.
  154.   
  155.   One caution about stopping:  If you have aborted a screen dump and you then
  156.   send something else to the printer (even another screen dump) without
  157.   clearing its internal buffers, you will most likely get alot of garbage.
  158.   To clear the printer's buffer, either turn it off and back on again or
  159.   refer to your manual on how this can be done from the printer's front
  160.   panel controls.
  161.   
  162.  
  163. Configuration File:
  164.  
  165.   When the program is first run, it looks in the folder where it is for a
  166.   file called SCRDMP24.CFG. (if the program is run from the AUTO folder at
  167.   boot time, then the config file must be in the *root* directory of the
  168.   boot disk, this is a system limitation) If this file is found then its
  169.   contents are read and the default settings are changed accordingly. The
  170.   new defaults are displayed on the screen.
  171.   
  172.   The format for config files is very rigid, due to the simplicity of the
  173.   code that reads the file. All data must appear in the first column after
  174.   the carriage return. Numbers for scaling must be only one digit each and
  175.   must be separated with a sigle space or other character.
  176.   
  177.   Comments can also be entered in the file by starting the line with a
  178.   semi-colon (;) character.
  179.   
  180.   The general format for the options within the file is as follows:
  181.   
  182.       ;comments
  183.       [low-rez scaling in "x y" format]
  184.       [med-rez scaling]
  185.       [high-rez scaling]
  186.       ["d" or "p" to set Disk or Printer]
  187.       ["l" or "n" to set Landscape or Normal]
  188.   
  189.   The order of the lines is not important for the most part. If you want to
  190.   put the Disk option before the comments and the Landscape option in between
  191.   medium and high-rez scaling, that is fine. The only important thing is that
  192.   the low-rez scaling is followed by the medium-rez, which is in turn followed
  193.   by the high-rez, somewhere within the file.
  194.   
  195.   The following example is the one that should be included with this program
  196.   and its values match those that would be present even if no config file
  197.   was found:
  198.   
  199.       ; This is a comment
  200.       8 4       The rest of the line is ignored. Set low-rez scaling to (8,4)
  201.       4 4       Medium rez.
  202.       4 2       High rez.
  203.       l         Choose Landscape mode.
  204.       p         Choose Printer output.
  205.       
  206.  
  207. Potential Problems:
  208.  
  209.   The only possible problem I can see would arise in different interpretations
  210.   of the code used to line feed the printer to the next line. This program
  211.   was tested on a Star NX-2400 which has both a "native" mode, and an "IBM"
  212.   mode. In IBM mode this code will result in the carriage not moving down
  213.   far enough past the line that was just printed and the next line will
  214.   overlap the previous one. For this reason, this utility should only be
  215.   used when your printer is in "native" mode, not "IBM" mode. The code used
  216.   to do this is "ESC J".
  217.   
  218.  
  219.                                   Enjoy it!
  220.  
  221.                                   Dan Wilga
  222.  
  223.                                   GEnie:  GRIBNIF
  224.                                   Bitnet: Gribnif@UMASS.Bitnet
  225.  
  226.