home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / vgacad7.zip / VGA2CGA.DOC < prev    next >
Text File  |  1989-12-17  |  12KB  |  331 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 or SQZGIF".
  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.     REQUIREMENTS
  82.  
  83.     VGA2CGA requires, at the minimum, a 100% IBM Hardware Compatible CGA 
  84.     card.  Hercules users with HGCIBM may find that the program works on 
  85.     their system, BUT ONLY WITH OPTION (1) AT THE MAIN MENU.
  86.  
  87.     SVGA and EEGA card users must set CGA hardware emulation to see the 
  88.     unsupported 160x100x16 or 80x100x"405" mode  (e.g, "SETMODE IBMCGA" on 
  89.     STB VGA cards).  About 512KB of memory is required, although it uses 
  90.     about 2/3 of that.
  91.  
  92.  
  93.     LOADING PICTURES INTO VGA2CGA
  94.  
  95.     Two formats are accepted by VGA2CGA: GIF and BLD/PLT files;  At the start 
  96.     of the program, you will be prompted to select [G]IF or [B]LD files to to 
  97.     selected or [Q]uit to exit.
  98.  
  99.     All pictures are interpolated to a 320x200 size.  As such, SuperVGA GIF 
  100.     files (e.g., 640x480x256, 800x600x256 and 1024x768x256) are interpolated 
  101.     to 320x200x256;  SQZGIF is recommended for LARGE GIF pictures to retain 
  102.     more color information and better color rendition.
  103.  
  104.     16-color EGA/EEGA/VGA pictures will also be interpolated; use EGA2VGA to 
  105.     process such pictures before loading into VGA2CGA.
  106.  
  107.     You can select any filename by moving a highlighted bar (with the arrow 
  108.     keys) and pressing the <return> key.  Pressing <Spc> allows you to select 
  109.     a different PATH, while <Esc> exits.  When selecting a *.BLD file, be 
  110.     sure it has a corresponding  *.PLT file or a error message will result.
  111.  
  112.  
  113.     THE MAIN MENU
  114.  
  115.     After loading a picture, these are the viewing options:
  116.  
  117.     (1)  Red-Grn-Yel Plane Dithering 320 x 200 x 4   (IBM-STD w/ GIF save)
  118.     (2)  EGA Low Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  119.     (3)  EGA Med Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  120.     (4)  EGA Hi  Contrast Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  121.     (5)  EGA Monochrome   Emulation  160 x 100 x 16  (NON-STD w/ CGX save)
  122.     (6)  HI Color Averaged Dithering  80 x 100 x 405 (NON-STD w/ CGX save)
  123.     (7)  LO Color Averaged Dithering  80 x 100 x 405 (NON-STD w/ CGX save)
  124.     (8)  Grey     Averaged Dithering  80 x 100 x 13  (NON-STD w/ CGX save)
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     VIEWING & SAVING
  137.  
  138.     Whenever you select a viewing mode you will have the option change the 
  139.     path and file names for saving.
  140.  
  141.               Pathname               : C:\GIF\
  142.               Filename               : NONAME.GIF
  143.  
  144.     While viewing the picture in CGA 320x200x4 mode you can change the 
  145.     palette to alter the tone of the picture by pressing numbers 0-9.
  146.     Pressing [B]inary save, will BSAVE an image in a BASIC 'bload' format; 
  147.     this applies only to the 4-color 320x200x4 mode.
  148.  
  149.     10   SCREEN 1               'CALL CGA 320X200X4 MODE
  150.     20   BLOAD "NONAME.BIN"     'POP IT INTO MEMORY - THAT'S ALL 
  151.  
  152.     With unsupproted modes 2 to 8, only saves to a CGX file are allowed since 
  153.     it is a weird text screen format; the .CGX extension is provided to avoid 
  154.     confusion with your other .BIN files.   To use VGA2CGA as a viewer type 
  155.     "VGA2CGA [picname]" without the extension.
  156.  
  157.     Pressing <return> while viweing saves your converted picture; pressing 
  158.     <Esc> aborts processing and saving.
  159.  
  160.  
  161.     FINE TUNING
  162.  
  163.     To get the BEST color dithering or color matching, interactively adjust 
  164.     the color levels, contrast levels and dither density levels.
  165.  
  166.     When you select (F)ine Tuning, you can adjust the global amounts of Red, 
  167.     Green and Blue in you picture.  At default it is 100%; this can be 
  168.     increased up to 200%  The CGA 320x200x4 color mode uses only red and 
  169.     Green; Blue is disregarded.
  170.  
  171.     While "fine tuning", you can adjust the contrast levels for each of the 
  172.     RGB planes; this has no effect on color-averaging and is limited to the 
  173.     red-green-yellow dithering 320x200x4 mode.  Increasing the contrast will 
  174.     increase the amount of "black" in the picture by making a sharp cutoff 
  175.     (i.e., no color will be plotted).
  176.  
  177.     Dither Density is how closely packed neighboring pixel will be; at 
  178.     default this is set to 1 - the highest density possible.  If you want to 
  179.     "spread the dots" you can increase this level up to 200.
  180.     THE CHAINED VGACAD ENVIRONMENT
  181.  
  182.     REGISTRATION
  183.  
  184.     REGISTRATION OF VGA2CGA IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR 
  185.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL 
  186.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH 
  187.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE TO 
  188.     INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON (NOT A 
  189.     JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE' VGA2CGA.
  190.     ┌───────────────────────────────────────────────────────────────────┐
  191.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  192.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  193.     └───────────────────────────────────────────────────────────────────┘
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     As token of our appreciation (i.e., to registered users), we will send 
  203.     you the the latest version of the VGACAD system; many of the programs 
  204.     listed below do not require a graphics card.
  205.  
  206.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop 
  207.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's 
  208.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.  
  209.     Histogram-equalization.  No graphics card required.
  210.  
  211.     GIFDOT - has all the features of GIFPUB for printing on IBM/Epson 
  212.     printers. Several sizes. 8 pics/page.  Single/Double Pass printing.  
  213.     Preview in CGA/HGC/EGA/VGA/EEGA/SVGA.  No graphics card required.
  214.  
  215.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !) to 
  216.     grey shades for VGACAD image processing, GIFPUB redithering, GIFDOT 
  217.     printing, or VGA2EGA conversion - it edits those "scan line jitters".  
  218.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  219.  
  220.     SQZGIF - converts LARGE GIFs (up to 2048x2048x256) to several sizes and 
  221.     video modes using "color averaging" to blend/smooth "jaggies" and retain 
  222.     a maximum of color information; use outputs in GIFPUB, GIFDOT, VGACAD, 
  223.     MVGAVU, VGA2CGA or VGA2EGA.  No graphics card required.
  224.  
  225.     EGA2VGA - converts GIFs (16 colors and below) or ANY VIEWABLE 2-16 color 
  226.     EGA/EEGA picture to 320x200x256; creates 256 new colors; outputs directly 
  227.     to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  228.     No graphics card required.
  229.  
  230.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an 
  231.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  232.  
  233.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or color 
  234.     and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  235.  
  236.     VGA2EGA - converts 256 color pictures to 16-color EGA.  Error- 
  237.     distributed dithering.  Variable sizing/RGBICMY/contrast/dithering 
  238.     levels.  EEGA support up to 800x600.  GIF or optional PCX save to 4 RGBI 
  239.     planes for Desktop Color Separation.  EGA/MCGA/VGA required.
  240.  
  241.     MVGAVU - EGA/MCGA/EEGA/VGA/SVGA viewer for GIF and BLD/PLT files.  Smart 
  242.     slideshows - picks best mode.  320x400x256, 360x480x256 and 640x400x16 
  243.     modes on regular VGA.  EGA posterization.  EEGA/SVGA support.  
  244.     Auto-sizing.  Contrast/Brightness.  EGA/MCGA/VGA required.
  245.  
  246.     VGACAP - tiny TSR, captures MCGA/VGA/SVGA screens (from 320x200x256 to 
  247.     800x600x256).  MCGA/VGA required.
  248.  
  249.     RAW2GIF - converts SVGA screen captures of VGACAP to GIF.
  250.     BLD2GIF - converts MCGA/VGA screen captures of VGACAP to GIF.
  251.  
  252.     VGACAD - extensive paint/image processing program for VGA/MCGA users 
  253.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image 
  254.     processing functions (smoothing, noise removal, shading, contrast 
  255.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing, 
  256.     256-color gradient/pattern fills, MORE !  MCGA/VGA required.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     WHAT'S NEXT ?
  269.  
  270.     Aside from enhancing existing releases with increased capabilities (e.g., 
  271.     expanded memory, virtual screen, SVGA functions, other graphics formats), 
  272.     we are developing VGACBT, a Computer-Based Training program  and 
  273.     MANNEQUIN for Advertising/Fashion Design or creating your own artistic 
  274.     nudes.
  275.  
  276.     Support maverick authors like us and we will continue developing products 
  277.     like nothing seen commercially - otherwise they will simply "DIE" from 
  278.     lack of support !  Compare the cost/benefit ratio of any of our products 
  279.     with commercial products.  You, and you alone, determine whether it will 
  280.     be worthwhile to continue developing.  Support the User-Supported 
  281.     (Shareware) concept.  Register you Shareware copies.  To register, send 
  282.     the registration form and check or money order payable in USD to:
  283.  
  284.                                Dr. Marvin Gozum
  285.                   2 Independence Place #303-2, 6th & Locust
  286.                             Philadelphia, PA 19106
  287.  
  288.  
  289.     ───────────────────────────────────────────────────────
  290.     Graphics Interchange Format and GIF are trademarks (tm)
  291.     of CompuServe Inc. an H&R Block Company. 
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.