home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Graphics / graphics-16000.iso / msdos / viewers / vga2cga2 / vga2cga.doc < prev    next >
Text File  |  1989-03-02  |  15KB  |  397 lines
  1.  
  2.  
  3.  
  4.              VGA2CGA (c) Copr. 1989 Lawrence Gozum & Marvin Gozum
  5.           ─────────────────────────────────────────────────────
  6.  
  7.                                  User Manual
  8.  
  9.  
  10.     DISCLAIMER
  11.  
  12.     This product is distributed AS IS.  The authors specifically disclaim all 
  13.     warranties ,expressed or implied, including ,but not limited to, implied 
  14.     warranties of merchantability and fitness for a particular purpose with 
  15.     respect to defects in the diskette and documentation, and program license 
  16.     granted herein, in particular, and without limiting operation of the 
  17.     program license with respect to any particular application use or 
  18.     purpose.  In no event shall the authors be liable for any loss of profit 
  19.     or any other commercial damage including but not limited to special, 
  20.     incidental, consequential or other damages.
  21.  
  22.  
  23.     LICENSING AGREEMENT
  24.  
  25.     You may use this program on a TRIAL BASIS only;  this means that you may 
  26.     freely evaluate the usefulness of this program for 10 DAY TRIAL PERIOD.  
  27.     Should you find this program useful, you must register it (see last 
  28.     section of this manual).   You will then be provided with the latest 
  29.     releases of applications that will run on your system.
  30.  
  31.     You may freely distribute copies of this program in its UNMODIFIED state 
  32.     provided you do not include it in other software packages, with the 
  33.     exception of distributing it as part of a bundle of Public Domain or 
  34.     shareware programs on a single diskette.  You may not charge more that 
  35.     $3.50 for copying and/or distributing this program in the absence of 
  36.     recognized Users Group guidelines (e.g., Association of Shareware 
  37.     Professionals or New York Amateur Computer Club)
  38.  
  39.  
  40.     WHAT IS VGA2CGA ?
  41.  
  42.     VGA2CGA is a utility that converts/views colored GIF pictures (256 colors 
  43.     and less) and any of the following listed below to [1] error-distributed, 
  44.     4-color dithered CGA or 16-Color CGA pictures, with a special unsupported 
  45.     mode; CGA users can convert/view up to 405 colors (from 16 color dither 
  46.     patterns).  VGA2CGA saves to GIF or .CGX (for the unsupported mode); you 
  47.     can use VGA2CGA as a CGA viewer for use in batch (.BAT) files.
  48.  
  49.     1)   ANY colored GIF picture (32 colors and up recommended), with any 
  50.          size (up to 2048 x 2048 x 256).
  51.  
  52.     2)   ANY VIEWABLE VGA/MCGA 320x200x256 picture captured with VGACAP;
  53.  
  54.     3)   VGACAD pictures;
  55.  
  56.     4)   16-color pictures converted to 320x200x256 with EGA2VGA.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     VGA2CGA uses a unique error-distribution algorithm; it uses a Floyd- 
  71.     Steinberg matrix with Stucki filter values (8,4,2,2).  Users can 
  72.     individually adjust the color and contrast levels and dither density.
  73.  
  74.     CGA2VGA supports a "quarter-resolution" mode by direct manipulation of 
  75.     CGA registers.  16 colors can be displayed at any time.  The effective 
  76.     pixel resolution is 640x200x16 with 405 color dither combinations.
  77.  
  78.     SEE THOSE 256 COLOR GIF PICTURES ON CGA !
  79.  
  80.  
  81.     WHAT IS VGACAP ?
  82.  
  83.     VGACAP is a terminate-stay-resident (TSR) utility that captures 256 color 
  84.     palettes and screens in VGA/MCGA 320x200x256 color mode.  VGACAP will 
  85.     capture and "Bsave" the pictures of commercial and other Shareware 
  86.     viewing/painting/graphics/CAD programs.
  87.  
  88.  
  89.     REQUIREMENTS
  90.  
  91.     VGA2CGA requires, at the minimum, a 100% IBM Hardware Compatible CGA 
  92.     card.  Hercules users with HGCIBM may find that the program works on 
  93.     their system, BUT ONLY WITH OPTION (1) AT THE MAIN MENU.
  94.  
  95.     SVGA and EEGA card users must set CGA hardware emulation to see the 
  96.     unsupported 160x100x16 or 80x100x"405" mode  (e.g, "SETMODE IBMCGA" on 
  97.     STB VGA cards).
  98.  
  99.     About 512KB of memory is required, although it uses about 2/3 of that.
  100.  
  101.     You MUST have a VGA or MCGA adaptor (at least BIOS compatible) present 
  102.     and an analog monitor to use VGACAP.  VGACAP uses less than 2K of RAM.
  103.  
  104.  
  105.     HOW TO USE VGACAP
  106.  
  107.     Run VGACAP before entering your painting/CAD or digitized picture 
  108.     viewer.   Press <ALT-F10>, while viewing your picture in any paint/CAD 
  109.     program and your current screen and palette will be saved in your default 
  110.     drive and directory in the standard Bsave format for all BASIC programs.
  111.  
  112.     The first time you run the program it will save your screen and palette 
  113.     to SCREEN00.BLD and SCREEN00.PLT respectively.  If there is an existing 
  114.     SCREENxx.BLD or SCREENxx.PLT file, then it will increment to the next 
  115.     higher number.  You can use your favorite memory managers to remove this 
  116.     TSR or reboot to release it from memory.
  117.  
  118.          Note:  When in DOS or using a picture viewer (e.g., PICEM, VPIC, 
  119.          VGAGIF) or application which requires a keypress to continue, it is 
  120.          necessary to hit another key after hitting the 'HOTKEY'.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     LOADING PICTURES INTO VGA2CGA
  137.  
  138.     Two formats are accepted by VGA2CGA: GIF and BLD/PLT files;  At the start 
  139.     of the program, you will be prompted to select [G]IF or [B]LD files to to 
  140.     selected or [Q]uit to exit.
  141.  
  142.     All pictures are interpolated to a 320x200 size.  As such, SuperVGA GIF 
  143.     files (e.g., 640x480x256, 800x600x256 and 1024x768x256) are interpolated 
  144.     to 320x200x256;  SQZGIF is recommended for LARGE GIF pictures to retain 
  145.     more color information and better color rendition.
  146.  
  147.     16-color EGA/EEGA/VGA pictures will also be interpolated; use EGA2VGA to 
  148.     process such pictures before loading into VGA2CGA.
  149.  
  150.     You can select any filename by moving a highlighted bar (with the arrow 
  151.     keys) and pressing the <return> key.  Pressing <Spc> allows you to select 
  152.     a different PATH, while <Esc> exits.  When selecting a *.BLD file, be 
  153.     sure it has a corresponding  *.PLT file or a error message will result.
  154.  
  155.     PATHs MUST end with a backslash character "\" or your specified PATH will 
  156.     be rejected (an error beep will result).  The following are legal PATH 
  157.     examples:
  158.  
  159.               "A:\"
  160.               "B:\"
  161.               "C:\GIF\"
  162.               "D:\GIF\VGA\LARGE\"
  163.  
  164.     Every captured picture, VGACAD picture, converted EGA2VGA or SQZGIF or 
  165.     MAC2GIF picture will have two files:screen and palette.  The extension 
  166.     .BLD stands for BLoaD and .PLT for PaLetTe.
  167.  
  168.  
  169.     THE MAIN MENU
  170.  
  171.  
  172.     After successful loading of your picture you will see these options:
  173.  
  174.     (1)  Red-Grn-Yel Plane Dithering 320 x 200 x 4   (IBM-STD w/ GIF save)
  175.  
  176.     (2)  EGA Low Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  177.     (3)  EGA Med Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  178.     (4)  EGA Hi  Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  179.     (5)  EGA Monochrome   Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  180.  
  181.     (6)  HI Color Averaged Dithering  80 x 100 x 405 (NON-STD w/ CGX save)
  182.     (7)  LO Color Averaged Dithering  80 x 100 x 405 (NON-STD w/ CGX save)
  183.     (8)  Grey     Averaged Dithering  80 x 100 x 13  (NON-STD w/ CGX save)
  184.  
  185.     (F)ine Tuning
  186.     (N)ew Picture
  187.     (Q)uit
  188.  
  189.     Select the letter or the number to initiate that function or option.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     VIEWING & SAVING
  203.  
  204.     Whenever you select a viewing mode you will have the option change the 
  205.     path and file names for saving.
  206.  
  207.               Pathname               : C:\GIF\
  208.               Filename               : NONAME.GIF
  209.  
  210.     While viewing the picture in CGA 320x200x4 mode you can change the 
  211.     palette to alter the tone of the picture by pressing numbers 0-9.
  212.  
  213.     With unsupproted modes 2 to 8, only saves to a CGX file are allowed since 
  214.     it is a weird text screen format; the .CGX extension is provided to avoid 
  215.     confusion with your other .BIN files.   To use VGA2CGA as a viewer type 
  216.     "VGA2CGA [picname]" without the extension.
  217.  
  218.     Pressing <return> while viweing saves your converted picture; pressing 
  219.     <Esc> aborts processing and saving.
  220.  
  221.  
  222.     FINE TUNING
  223.  
  224.     To get the BEST color dithering or color matching, interactively adjust 
  225.     the color levels, contrast levels and dither density levels.
  226.  
  227.     When you select (F)ine Tuning, you can adjust the global amounts of Red, 
  228.     Green and Blue in you picture.  At default it is 100%; this can be 
  229.     increased up to 200%  The CGA 320x200x4 color mode uses only red and 
  230.     Green; Blue is disregarded.
  231.  
  232.     While "fine tuning", you can adjust the contrast levels for each of the 
  233.     RGB planes; this has no effect on color-averaging and is limited to the 
  234.     red-green-yellow dithering 320x200x4 mode.  Increasing the contrast will 
  235.     increase the amount of "black" in the picture by making a sharp cutoff 
  236.     (i.e., no color will be plotted).
  237.  
  238.     Dither Density is how closely packed neighboring pixel will be; at 
  239.     default this is set to 1 - the highest density possible.  If you want to 
  240.     "spread the dots" you can increase this level up to 200.
  241.  
  242.  
  243.     REGISTRATION
  244.  
  245.  
  246.     BONUS: Registered users of VGACAD v1.4-1.5, VGA2EGA v1-2, SQZGIF 
  247.            v1.0-v1.3, GIFDOT v1.0-1.3, MAC2GIF v1-2 and/or EGA2VGA v1-3 
  248.            and/or GIFPUB v1.0-v1.4 are registered.  Copy your REGISTER.OVL 
  249.            file into the directory of VGA2CGA and it will operate as a 
  250.            registered version.  IF YOU HAVE NOT REGISTERED ANY OF THESE 
  251.            PROGRAMS, DO SO NOW; when VGACAD v1.60 is released, all new 
  252.            releases will require REGISTER.V16 to operate as a non-shareware 
  253.            version.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     For 19.95 (outside of U.S.A. add USD $15.00) you will be entitled to the 
  269.     latest update of VGA2CGA and REGISTER.V16 file (when released).  The 
  270.     following programs listed below are provided (latest copy or update) to 
  271.     registered users.  As much as possible, we are changing all utilities to 
  272.     work with ANY video card; programs that, at present, work with ANY video 
  273.     card are: GIFPUB, GIFDOT, EGA2VGA, MAC2GIF and SQZGIF.  We intend to 
  274.     release as many utilities to with device-independent capabilities. If you 
  275.     upgrade to EGA or VGA, please inform us as soon as possible so that we 
  276.     may send you EGA-dependent and VGA-dependent releases too.
  277.  
  278.  
  279.     * Device-independent utilities
  280.  
  281.     GIFPUB - converts 256 color GIFs to B&W images of varying sizes for 
  282.     desktop publishing/printing as .PCX (ZSoft format for Ventura Desk Top 
  283.     Publisher, First Publisher, Publisher's Paintbrush, PC  Paintbrush+) or 
  284.     rename files to .PCC for importing in Aldus Pagemaker.
  285.  
  286.     GIFDOT - converts 256 color GIFs to B&W images of varying sizes for 
  287.     printing on IBM and Epson compatible printers (separate drivers).  
  288.     Several print sizes with perfect aspect ratios.  Variable Brightness and 
  289.     Contrast Stretching. Single or Double pass printing.  Histogram Analysis
  290.  
  291.     SQZGIF - converts LARGE GIF pictures (up to 2048x2048x256) to 320x200x256 
  292.     using interpolation and "color averaging" techniques to blend/smooth 
  293.     "jaggies" inherent in reducing LARGE GIFS while retaining a maximum of 
  294.     color information.
  295.  
  296.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or color 
  297.     and saves results as .GIF or BLD/PLT file, and other formats; graphics 
  298.     are viewable in VGA, MCGA or EGA - no video card is required for direct 
  299.     Black & White conversion to GIF.
  300.  
  301.     EGA2VGA (v3.0) - converts GIFs (16 colors and below) or ANY VIEWABLE 2-16 
  302.     color EGA/EEGA picture to 320x200x256; creates 256 new colors; outputs 
  303.     directly to GIFPUB, GIFDOT, VGACAD, VGA2CGA or VGA2EGA.
  304.  
  305.  
  306.     * Device-dependent utilities/applications
  307.  
  308.     VGA2EGA - Conversion program for displaying 256 color pictures on 
  309.     EGA-bound systems.  Features extensive control of RGBCMY color, contrast, 
  310.     dithering levels.  Variable Sizing.  Extended EGA support. Saves to GIF.  
  311.     Optional PCX save to 4 RGBI planes for Desktop Color Separation.
  312.  
  313.     VGACAD - extensive paint/image processing program for VGA/MCGA users;  
  314.     v1.50 features extensive paintingcapabilities, an integrated GIF 
  315.     interface, Airbrushes, color and grey image processing functions 
  316.     (smoothing, noise removal, shading, contrast stertching, edge detection, 
  317.     high frequency-boosting, ... more), Bezier/spline curves, multi-featured 
  318.     Cut&Paste, variable sizing, multi-directiona 256-color gradient fills, 
  319.     256 color 16x16 pattern fills, and a LOT of other 256-color capabilities.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     Whats next ?
  335.  
  336.     SYNPCX is utility to convert dithered, monochrome .PCX (Zsoft) files to 
  337.     smooth grey shades.  This utility is primarily designed to convert 
  338.     scanned (e.g., Logitech & DFI hand scanners) Black & White images, saved 
  339.     to a .PCX file, for use and image processing with VGACAD, redithering 
  340.     with GIFPUB, printing with GIFDOT, or EGA conversion with VGA2EGA.  
  341.     SYNPCX will be graphics device independent (No Video Required).
  342.  
  343.      We are also, developing VGASHW (a 256-color presentation system), VGACBT 
  344.     (the PROGRAMMABLE Computer-Based Training counterpart of VGASHW) AND 
  345.     MANNEQUIN (what "Weird Science" tried to do in the movie it will do on 
  346.     the computer screen with potential applications for Advertising and 
  347.     Fashion Design, aside from creating your own artistic nudes).
  348.  
  349.     If you support maverick authors like us, we will continue to develop 
  350.     innovative products like nothing seen commercially - otherwise they will, 
  351.     as many (sigh!) good Shareware programs, simply "DIE" from lack of 
  352.     support !  Compare the cost/benefit ratio of any of our products with 
  353.     commercial products; we want to continue supporting and developing these 
  354.     products.  Please support the User-Supported  (Shareware) concept; you, 
  355.     and you alone, determine whether it will be worthwhile to continue 
  356.     developing.
  357.  
  358.     To register, send in the registration form and check payable to
  359.  
  360.                              Dr. Marvin Gozum
  361.                       2 Independence Place Apt. 303-2
  362.                             6th & Locust Street
  363.                           Philadelphia, PA 19106
  364.  
  365.  
  366.     NEW!      3.5" disk users:  We are now supporting this format.
  367.               If you want your updates in this format, add $10.00.
  368.  
  369.  
  370.  
  371.  
  372.     ───────────────────────────────────────────────────────
  373.     Graphics Interchange Format and GIF are trademarks (tm)
  374.     of CompuServe Inc. an H&R Block Company. 
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.