home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / vga / vgaprn.arc / VGAPRN.DOC < prev    next >
Text File  |  1988-06-12  |  16KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.             VGAPRN (c) Copr. 1988 Lawrence Gozum & Marvin Gozum
  7.             ───────────────────────────────────────────────────
  8.  
  9.                                 User Manual
  10.  
  11.     DISCLAIMER
  12.  
  13.     This  product  is distributed AS IS.  The authors specifically disclaim
  14.     all  warranties  ,expressed  or implied, including ,but not limited to,
  15.     implied  warranties  of  merchantability  and  fitness for a particular
  16.     purpose  with respect to defects in the diskette and documentation, and
  17.     program  license  granted  herein,  in particular, and without limiting
  18.     operation  of  the  program  license  with  respect  to  any particular
  19.     application  use  or  purpose.  In no event shall the authors be liable
  20.     for  any  loss  of  profit or any other commercial damage including but
  21.     not limited to special,incidental, consequential or other damages.  
  22.  
  23.  
  24.     LICENSING AGREEMENT
  25.  
  26.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  27.     may  freely  evaluate  the  usefulness of this program for a reasonable
  28.     period.    Should  you  find  this program useful, you must register it
  29.     (see  last  section  of  this manual).   You will then be provided with
  30.     the  latest release of VGACAD (VGA Computer-Assisted Design) and latest
  31.     updates of all released utilities.
  32.  
  33.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  34.     state  provided  you do not include it in other software packages, with
  35.     the  exception  of distributing it as part of a bundle of Public Domain
  36.     or  shareware  programs  on a single diskette.  In addition you may not
  37.     charge  more that $3.50 for copying and/or distributing this program in
  38.     the absence of any recognized Users Group guidelines.
  39.  
  40.  
  41.     WHAT IS VGAPRN ?
  42.  
  43.     VGAPRN  is  a printer utility for printing ANY viewable VGA 320x200x256
  44.     color  picture  on  an  Epson  or  IBM-compatible dot matrix printer in
  45.     seven  shades  of  gray  that  are  "user-assignable" from the program.
  46.     VGAPRN  converts  your  256  color pictures to 7 gray shades, which you
  47.     can  then  adjust  the  assignment  of  colors  to optimize the printed
  48.     image's appearance.
  49.  
  50.  
  51.     WHAT IS VGACAP ?
  52.  
  53.     VGACAP  is  a  terminate-stay-resident (TSR) utility that allows you to
  54.     capture  the 256 color palette and screen in the 320x200x256 color mode
  55.     and  save both the palette and screen in "Bloadable" formats.  VGACAP's
  56.     main  purpose  is to capture and "Bsave" the pictures of commercial and
  57.     shareware  viewing  programs  as  well  as  painting/graphics  and  CAD
  58.     programs available now and in the future.
  59.  
  60.     VGACAD  (one  of  the  first  256  color  paint/CAD  shareware programs
  61.     distributed  in  the Public domain) will load the captured pictures for
  62.     extensive image processing and editing.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.     REQUIREMENTS
  73.  
  74.     You  MUST have a VGA or MCGA adaptor (at least BIOS compatible) present
  75.     and  an analog monitor to use VGACAP and VGAPRN.  VGACAP uses less than
  76.     2K  of  your  available memory !  VGAPRN needs about 256KB of memory to
  77.     run succesfully.
  78.  
  79.     Note:    When  in  DOS  or  using  a  picture  viewer (e.g., VGAGIF) or
  80.     application  which  requires a keypress to continue, it is necessary to
  81.     hit  any  key  or  a  specified  key  (e.g.,  spacebar or return) after
  82.     hitting the 'HOTKEY' before VGACAP saves the screen and palette.
  83.  
  84.  
  85.     COMPATIBLE PRINTERS
  86.  
  87.     VGAPRN  was  designed  to run on Epson and IBM compatible printers that
  88.     support 120 dpi (horizontally) and 216 dpi (vertically).
  89.  
  90.               Epson (e.g., LQ,FX,GX,RX,JX, ...)
  91.               IBM (e.g., Graphics Printer, Proprinter, ...)
  92.  
  93.     The  following  partial  list  of  manufacturers  have compatible "ESC"
  94.     codes  to  run  VGAPRN;  if  your printer supports "ESC L" (sets double
  95.     density  graphics)  and  "ESC  J" (sets n/216 inch single line spacing)
  96.     VGAPRN will run on your system.  Check your printer manual.
  97.  
  98.               Canon (e.g., PW series)
  99.               Centronics
  100.               C.Itoh
  101.               NEC (e.g., Pinwriter, ...)
  102.               Okidata (e.g., 92/93, 192/193, 292/293, ...)
  103.               Panasonic (e.g., 1080i,1090i, ...)
  104.               Star (e.g., Gemini, Micronics SG series)
  105.               Tandy DMP
  106.  
  107.     NOTE:     YOU  MUST  DISABLE  AUTO-LINEFEED;   THIS SETTING IS NORMALLY
  108.               'OFF'  (BY  DEFAULT).  IF YOUR PRINTER HAS THIS FEATURE 'ON',
  109.               YOU  MUST  SET  THE  DIP  SWITCHES TO TURN IT 'OFF' OTHERWISE
  110.               YOUR PICTURE WILL BE PRINTED WITH 'SKIPPED' LINES.
  111.  
  112.  
  113.     HOW TO USE VGACAP
  114.  
  115.     Simply  run  VGACAP  before  entering  your  painting/CAD  or digitized
  116.     picture  viewer.    After loading,  press <ALT-F10>, while viewing your
  117.     picture  in  any  drawing/paint/CAD  or  viewing  program. Your current
  118.     screen  and  palette  will be saved in your default drive and directory
  119.     in the standard Bsave format for all BASIC programs.
  120.  
  121.     The  first  time  you  run  the  program  it  will save your screen and
  122.     palette  to SCREEN00.BLD and SCREEN00.PLT respectively.  If there is an
  123.     existing  SCREENxx.BLD  or SCREENxx.PLT file, then it will increment to
  124.     the  next  higher  number.    This  can  be  confusing  if you keep the
  125.     captured  files  without  renaming  them  since  you can have unmatched
  126.     screens  and  palettes.    You can use your favorite memory managers to
  127.     remove this TSR or reboot to release it from memory.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.     LOADING PICTURES INTO VGAPRN
  139.  
  140.     Every  captured  picture  or  picture created with VGACAD will have two
  141.     files:  the  screen  and palette.  The screen should have the extension
  142.     .BLD and .PLT for the palette.
  143.  
  144.          a)   WITH captured screens and palettes using VGACAP
  145.  
  146.               If  your  picture was captured with VGACAP, rename both files
  147.               with  the  same  name with the corresponding extensions.  For
  148.               example  rename SCREEN00.BLD to MYPIC.BLD and SCREEN00.PLT to
  149.               MYPIC.PLT.
  150.  
  151.               e.g. while in DOS type "rename SCREEN00.*  MYPIC.*"
  152.  
  153.          b)   WITH created/edited screens palettes using VGACAD
  154.  
  155.               In  VGACAD you have the flexibility of using a single palette
  156.               for  several  pictures.  If your screen was named "MYPIC.BLD"
  157.               and  you  used  "GRAY64.PLT"  for  the screen, then rename or
  158.               copy "GRAY64.PLT" to "MYPIC.PLT" file.
  159.  
  160.               e.g. while in DOS type "copy GRAY64.PLT MYPIC.PLT"
  161.  
  162.          c)   WITH BASIC Bsaved pictures using hardware palette
  163.  
  164.               In  BASIC, when you invoke SCREEN 13 the VGA card defaults to
  165.               a  standard  hardware  palette.    You  can BSAVE you screens
  166.               using the following lines:
  167.  
  168.               Screen 13: 'init MCGA 256 color mode
  169.               DEF SEG=&HA000: 'point data segment to
  170.                'screen buffer A0000H 
  171.               BSAVE"MCPIC.BLD",0,64000: 'bsave the screen
  172.               DEF SEG: 'restore data segment
  173.  
  174.               Copy  and  rename the included file "BASIC.plt" to match your
  175.               bsaved picture.
  176.  
  177.               e.g. while in DOS type "copy BASIC.PLT MYPIC.PLT"
  178.  
  179.               If  you  are  directly  making pictures from BASIC, I suggest
  180.               using  VGACAP  to  save screen and palette changes instead of
  181.               being  limited  by  the  standard  hardware palette.  BASIC's
  182.               PALETTE  USING  does  not support reading (much more a way to
  183.               bsave) palettes in a BIOS compatible format.
  184.  
  185.     Now  that you have the screen and palette type "VGAPRN MYPIC <return>".
  186.     After  a  few seconds of initialization your picture will appear and it
  187.     will  be  converted  into  256  gray shades then to 7 gray shades.  You
  188.     will see the following menu.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     0   ─────                                                     0  6
  206.     1         ──────                                              7 15
  207.     2                ──────                                      16 21
  208.     3                       ──────                               22 27
  209.     4                              ───────                       28 35
  210.     5                                      ─────                 36 42
  211.     6                                            ───────────     43 63
  212.  
  213.     VGAPRN  converts  all  the  256  colors  in  your  picture  into 7 gray
  214.     dithered  patterns  indicated by the numbers 0 to 6 on the left column.
  215.     The  total  number  of gray shades possible on the VGA card is 64; each
  216.     of  the  7  bands  (0-6)  represent sections of the total 64 gray range
  217.     that  will be assigned one of 7 dithered gray patterns.  The numbers on
  218.     the  right columns are the specific gray colors assigned to each of the
  219.     7  dithered  gray  patterns  which your printer will simulate as a gray
  220.     shade.
  221.  
  222.     By  moving  the  <UP>  and <DOWN> arrow keys one of the 7 bands will be
  223.     highlighted.    The  <LEFT>  and  <RIGHT>  arrow  keys will extend your
  224.     selected  band  to  the left or right;  extending your selected band to
  225.     the  left  decreases  the  bandwidth  of  the  band  preceding it while
  226.     extending  the selected band to the right decreases the band proceeding
  227.     it.   This method allows you to graphically see the distribution of the
  228.     64 gray scale to each of the 7 dithered patterns.
  229.  
  230.     You  will notice that the minimum bandwith is "1"; when a preceeding or
  231.     proceeding  band  is  shortened  to  a  width of "1" an error beep will
  232.     sound  and  adjustment will cease.  To continue extending your selected
  233.     band  beyond  that  point would require extending the preceding band to
  234.     allow  more  room  for  your selected band.  For example, your have the
  235.     following  gray  scale  assignments and would want to extend Band #5 to
  236.     cover more of the lower range.
  237.  
  238.     0   ─────                                                     0  6
  239.     1         ──────                                              7 15
  240.     2                ──────                                      16 21
  241.     3                       ──────                               22 27
  242.     4                              ─                             28 28
  243.     5                              ^ ───────────                 29 42
  244.     6                                            ───────────     43 63
  245.  
  246.     You  would  have  to  adjust  Band #4 to extend over Band #3's range to
  247.     extend Band #5's rnage any further.
  248.  
  249.     0   ─────                                                     0  6
  250.     1         ──────                                              7 15
  251.     2                ──────                                      16 21
  252.     3                       ─                                    22 22
  253.     4                        ───────                             23 28
  254.     5                        ^     ^ ───────────                 29 42
  255.     6                                            ───────────     43 63
  256.  
  257.  
  258.     Now  Band  #5  has  more  "room" to extend itself into Band #4's range.
  259.     Follow these same rules for extending in any direction for and band.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.     Pressing  the <SpaceBar> will convert your picture and reflect your new
  271.     gray  scale  assignments.    The  picture  you  will  view will closely
  272.     approximate  what  you will be actually printed.  Press any key and you
  273.     will be returned to the menus.
  274.  
  275.     If  you  are  satisfied  with  the  gray  scale  assignments,  then hit
  276.     <return>  and you will be presented with two options.  The first option
  277.     is  printer  port selection; you have a choice of using Printer Port #1
  278.     (which  is  normally  the  default for most systems) or Printer Port #2
  279.     for  systems that are using other parallel devices.  The next option is
  280.     the  number  of  passes.    One  pass  will normally be sufficient; two
  281.     passes  are  required if you want to darken the resulting image or when
  282.     your  printer  ribbon has begun to fade.  Press "S" to stop printing at
  283.     any time during the print-out.
  284.  
  285.     Pressing  <ESC>  at the menu prompt will terminate the program and exit
  286.     to DOS.
  287.  
  288.  
  289.     OPTIMIZING YOUR IMAGE
  290.  
  291.     In  my  experience,  not  many colors are assigned to Band #6 (which is
  292.     the  {lightest dithering pattern); you will have to keep extending that
  293.     band  over Band #5's range to "see it" (during preview).  Sometimes you
  294.     may  think  you  have  distributed  all 7 dithering patterns optimally,
  295.     only to find no occurence of Band #6 in your actual print-out.
  296.  
  297.     Every  single  change to any Band's rnage results in drastic changes in
  298.     the  converted  picture.   The only way to find the optimal image is to
  299.     keey  experimenting.    I suggest starting from Band #6 and moving your
  300.     way down to Band #0 in single increments.
  301.   
  302.  
  303.     REGISTRATION
  304.  
  305.     To  register  your  copy,  send  in the registration form and check for
  306.     $14.95 or $19.95 payable to
  307.  
  308.                              Dr. Marvin Gozum
  309.                       2 Independence Place Apt. 303-2
  310.                             6th & Locust Street
  311.                           Philadelphia, PA 19106
  312.  
  313.     For  $14.95 you will be entitled to the latest update of VGACAD without
  314.     reminders  which  pop-up  every  20  minutes  AND the latest updates of
  315.     released  utilities:    VGACAP  (included here), CGA2VGA (converts your
  316.     library  of  CGA  pictures  to  VGA  256  color  format),  and  BLD2GIF
  317.     (converts   ANY   viewable   320x200x256  VGA  pic  or  VGACAD  pic  to
  318.     CompuServe's standard GIF file).
  319.  
  320.     For  $19.95  you  will  be  entitled to the next TWO (2) updates of the
  321.     latest  of everything; this means that from the date of receipt of your
  322.     registration  we will send you the latest version of VGACAD and all the
  323.     related  utilities  developed  and  a  premier  copy of any new utility
  324.     developed  as  well  as the next releases of all the aforementioned and
  325.     any new fonts (with the font editor) and Clipart files when available.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.     You  can  expect  spectacular  enhancements  in  VGACAD's  updates.  At
  337.     present  it  has  sophisticated  color/gray image processing functions,
  338.     auto/variable  sizing/stretching/flipping,  image colorization, Cut and
  339.     Paste,  29 brushes and other featurese.  Future updates will include 3D
  340.     and  2D  transformations, gradient fills and patterns, and more; all of
  341.     these routines are in "C" or assembly and work very fast.
  342.  
  343.     In  the  pipeline  is  QBVGA an extensive library of QuickBASIC VGA 256
  344.     color  graphics  routines,  VGASHW  (a graphics presentation program to
  345.     showoff  your  captured  pictures  or  your  own  paintings  and screen
  346.     design,  EGA2VGA (a TSR to convert any EGA 640x350x16 color pics to VGA
  347.     320x200x256  color  pics),  and  VGA3DM  (3D  object/model  editor  for
  348.     including  models  in  VGACAD).    If  you continue to support maverick
  349.     authors  like  us,  we  will  continue  to  develop these products like
  350.     nothing  ever  seen in commercial packages - otherwise it will, as many
  351.     (sigh!)  good  "shareware" packages have to go commercial or simply die
  352.     from lack of support.   Support us and we'll keep developing.
  353.                                                                            
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.