home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / vgacad1.zip / VGACAD16.DOC < prev    next >
Text File  |  1989-05-04  |  106KB  |  2,179 lines

  1.                                 VGACAD v1.60
  2.           Copyright (c) 1988-89 Lawrence Gozum & Marvin Gozum, MD.
  3.  
  4.                             U S E R  M A N U A L
  5.  
  6.       DISCLAIMER
  7.  
  8.       This product is distributed AS IS.  The authors specifically disclaim 
  9.       all warranties, expressed or implied, including, but not limited to, 
  10.       implied warranties of merchantability and fitness for a particular 
  11.       purpose with respect to defects in the diskette and documentation, and 
  12.       program license granted herein, in particular, without limiting 
  13.       operation of the program license with respect to any use or purpose.  
  14.       In no event shall the authors be liable for any loss of profit or 
  15.       damage including but not limited to special, incidental, consequential 
  16.       or other damages.  
  17.  
  18.  
  19.       LICENSING AGREEMENT
  20.  
  21.       You may use this program and freely EVALUATE ITS USEFULNESS for a 
  22.       10-DAY TRIAL PERIOD.  Should you find it useful, you MUST REGISTER by 
  23.       sending registration form and check payable to Marvin Gozum.  See last 
  24.       section of this manual for details and benefits.
  25.  
  26.       You may freely distribute UNMODIFIED copies (which include all files 
  27.       listed in README.1st) provided you do not include it with commercial 
  28.       software, and charge no more than $3.50, in lieu of recognized User 
  29.       Group guidelines (e.g., Association of Shareware Professional, New 
  30.       York Amateur Computer Club), for copying/distribution costs.
  31.  
  32.  
  33.       1.   Requirements
  34.  
  35.       IBM PS/2 or IBM PC/XT/AT with VGA compatible graphics card capable of 
  36.       displaying mode 13H (MCGA 300x200x256 color mode), 512k free memory, 
  37.       analog or multifrequency monitor.  We strongly suggest you get a mouse 
  38.       since VGACAD was designed with a mouse device in mind.
  39.  
  40.       Users with 512kb RAM (or less) must use the command line "/R" option 
  41.       to reduce the RAM requirement.  Variable disk space is required 
  42.       (depending on Virtual Screen size used).  A Hard Disk is highly 
  43.       recommended but not required.  High density dual drive users (1MB AT 
  44.       drives or 720KB 3.5 inch drives) would have adequate space to run the 
  45.       program and work on regular GIF files.
  46.  
  47.       If you have extended or expanded memory, we suggest using a RAMDISK 
  48.       for the Virtual Screen; also, if you have a cache program, that too 
  49.       will help accelerate the program since this version uses a "chained 
  50.       environment".  We can no longer support dual 360KB users; in any case, 
  51.       it is highly unlikely that you have VGA or a PS/2 and are using dual 
  52.       360KB floppies !
  53.  
  54.          PLEASE READ 'README.2ND' REGARDING HARDWARE COMPATIBILITY.
  55.  
  56.  
  57.  
  58.  
  59.       Page ... 1
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.       2.   Installation
  68.  
  69.       All required files (listed in README.1st) MUST be in the default drive 
  70.       and/or directory.  To use the keyboard, run "KEYME.com" prior to 
  71.       running VGACAD; you can review the keyboard commands at start-up.
  72.  
  73.       If you have insufficient RAM, remove resident programs or use the "/R" 
  74.       command line option is discussed below.  After initialization, the 
  75.       total amount of free memory will be shown - this approximates how much 
  76.       resident software, or RAMDISK, can be installed before running VGACAD.
  77.  
  78.  
  79.       3.   Command Line Options
  80.  
  81.       Switch "/Q" ("Quiet") will silence all the audio feedback beeps except 
  82.       error or warning messages.  To totally "cut" all audio; we suggest 
  83.       using a Shareware program called SILENCE.ARC (.ZIP).
  84.  
  85.       Switch "/R" ("Reduced Memory") will cut VGACAD's memory allocation by 
  86.       64KB and utilize a buffer called "UNDO.TMP" during certain operations.
  87.  
  88.       Switch "/FM" ("Force Mouse") maintains your current mouse settings and 
  89.       assumes a mouse is properly initialize; this allows initializing your 
  90.       mouse with ANY program.  We suggest initializing with 320x200x4 CGA or 
  91.       320x200x256 MCGA mode; make sure that the text cursor is set OFF !
  92.  
  93.       Switch "/FK" ("Force Keyboard") will disregard any mouse device and 
  94.       operate in mouse emulation mode through the keyboard.  "KeyME.com" 
  95.       MUST be resident if you use this switch or the system will HANG !
  96.  
  97.       Switch "/SL:n" "SLow Mode" will require release of the mouse button to 
  98.       proceed.  The value "n" will determine a delay factor for the Spray 
  99.       Paint function; a value of 1000 will be sufficient for Fast machines.
  100.  
  101.       Switch "/MX:n" adjusts the mickeys/8 pixels ratio on the X axis.  The 
  102.       default is 8/8.  "n" is any number from 1 and 16.  "1" will make your 
  103.       mouse travel 8x faster while 16 will make your mouse travel 2x slower 
  104.       on the x axis.
  105.  
  106.       Switch "/MY:n" adjusts the mickeys/8 pixel ration on the Y axis.  The 
  107.       default is 16 mickeys / 8 pixels.
  108.  
  109.       Switch "/MT:n" adjusts the "motion threshold"; the default setting is 
  110.       64 mickeys/second.  If your mouse seems to be returning to its same 
  111.       position or seems restrained after zipping quickly from any direction, 
  112.       its movement was successively doubled resulting in the mouse returning 
  113.       to its former location; this is a function of your CPU speed.  "n" is 
  114.       any number between -32767 to 32767.  Refer to your mouse manual for 
  115.       more information.
  116.  
  117.       Use a batch file to keep your desired settings.  The sample "*.BAT" 
  118.       entry below, turns the sound off, reduces the memory by 64K, triggers 
  119.       the SLow Mode with a 1000 delay loop, doubles the speed in both the x 
  120.       and y axes, and keeps the motion threshold at its maximum.
  121.  
  122.                 VGACAD /R /Q /SL:1000 /MX:4 /MY:8 /MT:-32767
  123.  
  124.  
  125.  
  126.  
  127.  
  128.       Page ... 2
  129.  
  130.  
  131.  
  132.  
  133.       4.   Testing
  134.  
  135.       VGACAD was tested on a 8MHz IBM XT compatible with a STB VGA Extra E/M 
  136.       (w/ Princeton Ultrasync) and a PS/2 Model 50 (w/ 8513 Monitor).   For 
  137.       comments, particularly bug reports, we would appreciate E-Mail at 
  138.       CompuServe for Lawrence Gozum [73437,2372].
  139.  
  140.  
  141.       5.   Main Menu
  142.  
  143.       Click your RIGHT mouse button, the Main Menu screen will pop-up.  
  144.       There are 8 boxes: Undo, ImgP(Image Processing Menu), Edit Menu, Text 
  145.       Menu, Shps (Shapes Menu), Color Menu and File Menu.
  146.  
  147.                 ┌──────────────────────────────────────────┐
  148.      Main Menu  │┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐ ┌───┐ ┌───<┼current
  149.      option   ──┼┼>  ││   ││   ││   ││   ││   │ │   │ │   ││background
  150.      filled with│└───┘└───┘└───┘└───┘└───┘└───┘ └───┘ └───┘│color
  151.      current    │ Undo ImgP Edit Text Brsh Shps Color File │
  152.      foreground │{▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒▒░░▓▓▒▒░░▓▓██▓} │ <─┐
  153.      color      └──────────────────────────────────────────┘   ├─ Color
  154.                  {▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒▒░░▓▓▒▒░░▓▓██▓}   <─┘  Bars
  155.                  ^                                       ^
  156.                  └───────────── Scroll Arrows ───────────┘
  157.  
  158.       You will, immediately, be in 'brush' mode and can begin painting.  If 
  159.       you move your cursor below the Main Menu, the menu will disappear and 
  160.       will reappear when you press the RIGHT mouse button.  Clicking a Main 
  161.       Menu box will operate immediately or display another menu.  To exit 
  162.       without choosing any option, put your cursor below the menu.  As a 
  163.       rule, the RIGHT button will EXIT or ABORT, while the LEFT will be do 
  164.       everything else or ACCEPT a change.
  165.  
  166.       Use the color bars to select foreground or background colors.  Place 
  167.       the "arrow" cursor over a desired color and click the LEFT button for 
  168.       a new foreground color or the RIGHT for background.
  169.  
  170.       The color bars provide 32, 64 or 128 colors from your 256 color 
  171.       palette at any time.  At default, each color bar contains 16 colors.  
  172.       Use the scroll arrows to change the colors selections.  The upper and 
  173.       lower color bars play an important role in colorizing grey pictures.  
  174.       This will be explained further.
  175.  
  176.  
  177.       6.   Undo Function
  178.  
  179.       When the Main Menu screen pops-up, your current screen is saved and 
  180.       your can 'undo' all the changes from the last time the Main Menu was 
  181.       invoked.  Regardless of changes made, your screen will be restored.  
  182.       If the Main Menu is invoked and no options are selected, your next 
  183.       UNDO will be based on that screen; the UNDO screen is generally the 
  184.       screen last modified BEFORE invoking the Main Menu.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.       Page ... 3
  195.  
  196.  
  197.  
  198.  
  199.       7.   Brush Menu
  200.  
  201.                ┌───────────────────────────────────────────────┐
  202.                │┌────┐┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  203.            ────┼┼>   ││   │ │███│ │   │ │   │ │   │ │   │ │   ││
  204.        Active  │└────┘└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  205.        BRUSH ┌─>normal  <>   MODE  Rect  Circ  Line  Diag  MASK│
  206.              │ └───────────────────────────────────────────────┘
  207.             current mode
  208.  
  209.       The Active box will show the current "brush" selected.  The "<>" box 
  210.       cycles through the different brush sizes or variations.  There are 6 
  211.       RECTangular sizes, 3 CIRCular, 3 Horizontal LINEs, 3 Vertical LINEs, 
  212.       and 6 DIAGonal brushes.  The "MODE" box cycles through five different 
  213.       brush modes: normal, spray, air#1, air#2 and eraser.
  214.  
  215.       Spray paint and airbrush (Air#1 and Air#2) modes work only with the 
  216.       RECTangular or CIRCular brush; these brush modes will operate on the 
  217.       rectangular areas defined by the brushes; future versions will be  
  218.       shape-specific.
  219.  
  220.       Air#1 is a REAL airbrush that "adds" a color mixture as you paint over 
  221.       your picture, following the principle of Additive Color Mixtures (see 
  222.       "Notes on Additive Color Mixtures" in Appendix C).  Air#2 mixes colors 
  223.       in a more gradual fashion.  With Air#1, if you spray yellow over a red 
  224.       area, the closest color to orange in your palette will be painted; 
  225.       with Air#2, the closest color to yellow-orange in your palette will be 
  226.       painted.  Spray will paint random dots over a defined area; if used 
  227.       with the MASK flag on, you will be able to spray over a selected color 
  228.       as if you placed a stencil over the area to be painted.
  229.  
  230.       Eraser mode uses the color BLACK (color 0) as the foreground color; 
  231.       you cannot choose BLACK as a foreground color.  Use large RECTangular 
  232.       brushes for quicker erasures.
  233.  
  234.       The MASK flag acts as a stencil; when this flag is set, only pixels 
  235.       with the current background color will be replaced with the current 
  236.       foreground color; this will work in all modes except Air#1 and Air#2.
  237.  
  238.  
  239.       8.   Color Menu
  240.  
  241.       Selecting "COLOR" from the Main menu brings you to this sub-menu.
  242.  
  243.               ┌───────────────────────────────────────────────┐
  244.               │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  245.               ││   │ │   │ │   │ │███│ │   │ │   │ │   │ │   ││
  246.               │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  247.               │ OVRL  SWAP  FILL  CBAR  ZOOM  AREA COLOR  UNDO│
  248.               │ - Color  -  Menu  - Colorization -  MAP   mode│
  249.               └───────────────────────────────────────────────┘
  250.  
  251.       "OVeRLay" replaces all pixels with background color with foreground. 
  252.       "SWAP" exchanges all pixels with background color with foreground and 
  253.       vice-versa. "UNDO" mode cancels "OVRL" and "SWAP" implementation.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.       Page ... 4
  261.  
  262.  
  263.  
  264.  
  265.       Clicking "ColorBAR" (CBAR) will make the Scroll Arrows cycle through 
  266.       16, 32, or 64 COLOR RANGE colorbars.  Use the 32 or 64 COLOR RANGE to 
  267.       view and select more colors at any time.  COLOR RANGES are extensively 
  268.       used by the "AREA colorization" and "ZOOM" functions.
  269.  
  270.            │{▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒█▓▒▒░██░░▓▓▒▒░░▓▓██▓}│ <─┐  
  271.            └───────────────────────────────────────────────┘   Color
  272.             {▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒▒░░▓▓▒▒░██▓▓█▓▓▓▓██▓} <──Bars
  273.             ^                                             ^
  274.             └───────────────  Scroll Arrows ──────────────┘
  275.  
  276.       In "Area" (colorization), the upper and lower colorbar selections are 
  277.       significant.  When selected, all colors in the lower colorbar will be 
  278.       replaced by all the colors from the upper colorbar with a one-to-one 
  279.       correspondence.  Once selected, on exit, the arrow cursor will appear 
  280.       instead of your current brush.
  281.  
  282.       AS A RULE, THE APPEARANCE OF THE ARROW CURSOR INDICATES A BLOCK FORM 
  283.       OF EDITING OR SETTING OF A STARTING POSITION WHEN PERFORMING ANY AREA  
  284.       PROCESSING FUNCTION.  Pick a starting point on your screen and drag  
  285.       the cursor (pressing LEFT button).  Upon releasing the LEFT button, 
  286.       all colors in the upper colorbar will replace all the colors in the 
  287.       lower colorbar.  The "colorized" area will be have a blinking outline; 
  288.       click RIGHT to reject or the LEFT to accept.
  289.  
  290.       Grey images provide the luminance information of your picture (16, 32 
  291.       or 64 grey scales); by altering color ranges, you can select/replace 
  292.       the colors within the range with any other color range defined in the 
  293.       COLOR MAP.  The minimum range you can affect is 16.  Use the OVeRLay 
  294.       color function or MASKed brushes to replace individual colors.
  295.  
  296.       "ZOOM" (colorization) works like "Area" but on a "zoomed area".  ZOOM 
  297.       has three modes - NORMAL, XCOLOR and PROCESS.  XCOLOR (eXchange COLOR) 
  298.       mode replaces individual colors using the colorbars as reference; only 
  299.       selected colors on lower color bar are replaced with upper colorbar.  
  300.       ZOOM (in XCOLOR mode) lets you change those "difficult areas" where 
  301.       objects border other objects or the background.
  302.  
  303.       NORMAL mode is like any other ZOOM function where your paint over any 
  304.       color;other options while "ZOOM" editing.  The PROCESS mode uses color 
  305.       image processing algorithms; these are discussed later.
  306.  
  307.       "COLOR MAP" shows all 256 colors.  Colors are arranged in 8 rows of 16 
  308.       color boxes.  The first 128 colors are arranged from the LEFT to RIGHT 
  309.       starting from TOP to BOTTOM (COLORS 0 to 127).  The next 128 colors 
  310.       (COLORS 128 to 255) are arranged in the reverse order from RIGHT to 
  311.       LEFT starting from the BOTTOM to the TOP; this shows its inverse 
  312.       organization.  See Appendix A (Palette Organization Map) for details.  
  313.       Each color box is configured to show its complimentary or inverse 
  314.       color for experimenting with creative "color inversing" techniques.
  315.                                 ┌────────┐
  316.              Main Color    ─────┼>████   │
  317.                                 │█████   │
  318.                                 │       <┼───── Inverse color
  319.                                 └────────┘
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.       Page ... 5
  327.  
  328.  
  329.  
  330.  
  331.       You can pick any foreground color EXCEPT COLOR 0 (see Appendix A); to 
  332.       use COLOR 0 (normally BLACK), you will have to use the ERASER brush.  
  333.       Click LEFT over any color to select a foreground color or RIGHT to 
  334.       select background; these will be appear at RGB boxes (at lower left).
  335.  
  336.             ┌─────────────────────────┐
  337.             │  R=10    G=20    B=30   │
  338.             │ ┌────┐  ┌────┐  ┌────┐  │
  339.             │ │ ^  │  │ ^  │  │  ^ │ <┼───── background color
  340.             │ └─┼──┘  └─┼──┘  └──┼─┘  │
  341.             └───┼───────┼────────┼────┘
  342.                 │       │        │
  343.                 └── foreground color
  344.  
  345.       Palette editing is accomplished by altering the RGB values of the 
  346.       foreground color.  Place your cursor on any of the 3 boxes labelled 
  347.       [R]ed, [G]reen or [B]lue.  Clicking the RIGHT quickly increases RGB 
  348.       values.  Clicking the LEFT decreases RGB values by one.  As you modify 
  349.       the mixture, you'll see the color change.  You cannot select COLOR "0" 
  350.       as foreground; if you want to modify it, use editing functions below.  
  351.       See Appendix C for more information on color mixing. IF YOUR COLOR 
  352.       MIXTURE RESULTS IN TWO INVERSELY RELATED COLORS IN A COLOR BOX TO BE 
  353.       EXACTLY ALIKE, YOUR CHANGE WILL BE REJECTED !
  354.  
  355.       To the lower right corner are four boxes.  Copy, Swap, Digi and Reset 
  356.       provide extensive palette editing functions.
  357.  
  358.       COPY is very useful in making very subtle color changes since an 
  359.       increase in the "quanta" of R(ed), G(reen) or B(lue) by 1 may not be 
  360.       noticeable.  To copy a color, select the source color as BACKGROUND 
  361.       then select the destination color as FOREGROUND.  Click the COPY box 
  362.       with your LEFT mouse button.  SWAP works like COPY but exchanges the 
  363.       selected foreground color with the selected background color; use this 
  364.       to rearrange your entire palette.
  365.  
  366.       RESET restores a selected color's registers or the whole palette after 
  367.       any modification BEFORE selecting a new foreground or background color 
  368.       to edit.
  369.  
  370.       DIGI will "fill-in" or "spread" all colors between selected foreground 
  371.       and background colors.  The colors generated between the two "anchors" 
  372.       follow the Principle of Additive Color Mixture (see Appendix C).  To 
  373.       select a range, pick a foreground color as the start of the range, and 
  374.       a background color as the end of the range.  Click the DIGI box and 
  375.       all the colors in the range will "spread" between the two "anchors".  
  376.       CLICK THE RESET BOX TO RESTORE YOUR PALETTE IMMEDIATELY AFTER THIS 
  377.       FUNCTION; THIS IS YOUR ONLY CHANCE TO UNDO !
  378.  
  379.       To exit, click EXIT box with the LEFT button; for quicker exits, click 
  380.       both buttons in succession.  After selecting a new foreground color, 
  381.       BEFORE releasing the LEFT button, click the RIGHT; OR after selecting 
  382.       a new background color; click the LEFT button before releasing the 
  383.       RIGHT button.
  384.  
  385.       The last option in this menu is the "Fill Menu"; clicking this box 
  386.       transfers you to the border tracing, pattern/gradient fill functions.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.       Page ... 6
  393.  
  394.  
  395.  
  396.  
  397.       9.   Fill Menu
  398.  
  399.               ┌───────────────────────────────────────────────┐
  400.               │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  401.               ││   │ │   │ │   │ │   │ │   │ │   │ │███│ │   ││
  402.               │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  403.               │ CBAR  UpDn  DnUp  LfRt  RtLf  PTRN TRACE  EXIT│
  404.               │ ------ Gradient Fill  ------  Pick Shape  Menu│
  405.               └───────────────────────────────────────────────┘
  406.  
  407.       The FIRST box you MUST select is TRACE Shape.  Select any object with 
  408.       a solid color or the background; place your cursor at the center of 
  409.       the shape; press the LEFT button.  The shape will be filled with the 
  410.       foreground color.  All pixels in that shape with the same color (i.e., 
  411.       whatever was under the cursor) will be filled.  Keep that filled 
  412.       object as is, or pick a new color and repeat the process indefinitely.
  413.  
  414.       TRACE Shape was designed for complex shapes NOT complex patterns 
  415.       within pictures.  INTRICATE PATTERNS INSIDE PICTURES HAVE COMPLEX 
  416.       'TRAPS' OR REQUIRE TOO MUCH MEMORY - RESULTING IN A WARNING BEEP. You 
  417.       can always retrace and fill 'unfilled' portions; be patient and wait 
  418.       for the warning beep in rare cases when the 'fill' seems 'trapped'.
  419.  
  420.       Gradient fills are ranges of colors spread evenly throughout your 
  421.       traced shape.  The range of the gradient fill is determined by CBAR 
  422.       (ColorBAR); four types of gradient fills are available: UpDn, DnUp, 
  423.       LfRt and RtLf.  The selected range is the upper Color Bar; use the 
  424.       scroll arrows to select different color gradients.
  425.  
  426.       Pattern fills can be selected by invoking the PTRN (PaTteRn) PICK box; 
  427.       when you slide your cursor out of the menu, an entire screen of 16x16 
  428.       patterns (256 colors maximum) will be presented.  Point your arrow 
  429.       cursor over any pattern; the LEFT button will underline your selected 
  430.       pattern.  Press the RIGHT button to EXIT and fill your shape with the 
  431.       selected pattern.  Pressing the RIGHT button over any pattern will 
  432.       immediately select that pattern and EXIT to fill your shape.
  433.  
  434.       You can fill a traced shape with any gradient or pattern fill option 
  435.       indefinitely !  If EXIT is selected or another shape traced then the 
  436.       fill is set; you can UNDO fills ONLY from the Main Menu.  GRADIENT OR 
  437.       PATTERN FILL FILLS REQUIRE A COMPLETELY TRACED OBJECT.  If you get the 
  438.       'warning beep' then the object was not completely traced.  Use the 
  439.       ZOOM functions to simplify the 'object' by removing intricate 'traps'; 
  440.       future updates will deal with such 'traps' more intelligently.
  441.  
  442.       Editing any pattern is similar to editing a picture.  PATTERN.BLD has 
  443.       all the patterns.  Each pattern is a 16x16 matrix of colors arranged 
  444.       on the screen and is located at every 20th pixel (horizontally and 
  445.       vertically).  Use the ZOOM editing features to edit or create you own 
  446.       patterns.  PATTERNS PROVIDED WITH VGACAD USE THE DEFAULT.PLT;  THE 
  447.       APPEARANCE OF PATTERNS WILL CHANGE WITH OTHER PALETTES.  THE FILENAME 
  448.       PATTERN.BLD IS RESERVED; "PTRN PICK" WILL ALWAYS LOOK FOR THIS FILE.  
  449.       To create a new pattern file with a different palette, copy/rename the 
  450.       PATTERN.BLD file; load a different palette and edit the PATTERN.BLD 
  451.       file to your heart's content.
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.       Page ... 7
  459.  
  460.  
  461.  
  462.  
  463.       10.   Zoom Menu
  464.  
  465.       ZOOM features are compiled as a "chain to" module for easy update as a 
  466.       separate component; all UNDOing must be performed before exiting this 
  467.       module.  When ZOOM is selected from the COLOR Menu, a "Viewing Window" 
  468.       will appear as your cursor; place the cursor over any section to be 
  469.       "zoomed" and click the LEFT button; the RIGHT button exits back to the 
  470.       Main Menu.  While in "ZOOM" mode, other options will appear.  After 
  471.       editing and exiting (i.e., clicking "*OK*") you can continuously 
  472.       select another area for "ZOOM" editing until you click the RIGHT 
  473.       button.  The edited area is always displayed in the Viewing Window.
  474.  
  475.        VIEWING  ┌───────────────────────────────────────────────┐
  476.        WINDOW   │┌─────┐     ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  477.         └───────┼┼>    │Mode │███│ │   │ │   │ │   │ │   │ │   ││
  478.        CURRENT  │└─────┘  │  └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  479.        MODE ────┼>NORMAL <┘   UNDO  FIND  MARK  CBAR  COLOR *OK*│
  480.       
  481.                 │{▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒█▓▒▒░██░░▓▓▒▒░░▓▓██▓}│ <─┐  
  482.                 └───────────────────────────────────────────────┘   Color
  483.                  {▓▓▒░░▒░░▓▓██▓▓▒▒██▓▓▒▒░░▒▒░░▓▓▒▒░██▓▓█▓▓▓▓██▓} <──Bars
  484.                  ^                                             ^
  485.                  └───────────────  Scroll Arrows ──────────────┘
  486.  
  487.  
  488.       NORMAL and XCOLOR Modes
  489.  
  490.       Clicking the Viewing Window (with the LEFT button) will cycle the ZOOM 
  491.       mode between the XCOLOR (eXchange COLOR) mode, NORMAL mode and PROCESS 
  492.       mode.  The NORMAL and XCOLOR modes will display the above menu.  As 
  493.       explained in the AREA colorization function, XCOLOR mode replaces each 
  494.       pixel belonging to the range of colors specified in the lower color 
  495.       bar with corresponding colors in the upper color bar.
  496.  
  497.       NORMAL mode lets you change any pixel with the foreground color.  In 
  498.       XCOLOR mode, all incidences of any color in the lower color bar will 
  499.       be replaced by the upper color bar.  Only colors belonging to the 
  500.       lower colorbar will be affected.  If no color exists which belong to 
  501.       the lower colorbar then nothing will be modified !  Clicking "zoomed" 
  502.       pixels with the LEFT button will be replaced by the foreground color 
  503.       in NORMAL mode or replaced with the corresponding colors in XCOLOR 
  504.       mode; all changes are reflected in the Viewing Window. Clicking the 
  505.       "RIGHT" mouse button will reset any particular pixel to its original 
  506.       color before "zoom" editing, despite the number of times you have 
  507.       changed the pixel color in ANY mode !
  508.  
  509.       "Mark" will place an "*" on all "zoomed" pixels that match the fore-  
  510.       ground color to identify "hard to distinguish" colors due to subtle 
  511.       differences.  Select a foreground color from the color bars then click 
  512.       "FIND"; all matching pixels will be marked with an asterisk ("*").
  513.  
  514.       "Find" is the reverse function of "Mark"; it will find any color (by 
  515.       locating it on the appropriate LOWER colorbar).  Simply click "Find" 
  516.       then click any pixel in your "zoomed image";  VGACAD will look for the 
  517.       correct LOWER colorbar and color, then highlight it.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.       Page ... 8
  525.  
  526.  
  527.  
  528.  
  529.       ColorBAR (CBAR) is basically the same function in the COLOR menu.  
  530.       This is an added convenience so that you can change the lower and 
  531.       upper color bar ranges while you work on the "Zoomed" image.
  532.  
  533.       "Color" - calls the COLOR MAP for palette editing; all functions COLOR 
  534.       MAP functions are replicated here for your convenience.
  535.  
  536.       "UNDO" - will restore ALL of the "zoomed image" to its original state 
  537.       despite ALL changes in ANY mode.
  538.  
  539.       "*OK*" - will replace your "zoomed area" in your picture and return 
  540.       you to the main screen; all changes are final.  You can now select 
  541.       another area for "ZOOM" editing or exit.
  542.  
  543.  
  544.       PROCESS Mode
  545.  
  546.       In PROCESS mode, each pixel will be altered by color image processing 
  547.       options: LITE, HAZE, DARK, and BLEND.  The boxes in the ZOOM Menu will 
  548.       be changed as follows.
  549.  
  550.                  ┌─────┐     ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐
  551.                  │     │Mode │   │ │   │ │   │ │   │ │███│ │   │
  552.                  └─────┘  │  └───┘ └───┘ └───┘ └───┘ └───┘ └───┘
  553.                   PROCESS<┘   UNDO  LITE  HAZE  DARK  BLEND *OK*
  554.  
  555.  
  556.       HAZE, "smooths" each pixel with 10 levels of "smoothing"; high levels 
  557.       leave more detail but apply less "smoothing".  DARK and LITE will 
  558.       either add or reduce the amount of "white" in a colored pixel.  BLEND 
  559.       will "blend" your current foreground color with the color of zoomed 
  560.       pixels and select the closest color that matches the "color mixture" 
  561.       based on the Principle of Additive Color Mixtures (see Appendix C); 
  562.       BLEND functions in the same way Air#1 (Airbrush #1) does.  All color 
  563.       processes select the closest matching color from your limited 256 
  564.       color palette; the richer your palette, the better the match.
  565.  
  566.       HAZE, LITE and DARK functions use a buffer of the image in the Viewing 
  567.       Window; as such, once a pixel is modified (i.e., HAZEd, LITEned or 
  568.       DARKened) it cannot be modifed again recursively.  For example, if you 
  569.       wanted to change a red pixel to pink, you would select the LITE box 
  570.       and the appropriate setting (by clicking the LITE box until you have a 
  571.       selected setting), then click that specific pixel.  If you wanted it 
  572.       to become "light pink", clicking that specific pixel again will NOT 
  573.       make it lighter; either increase the LITE setting and click that pixel 
  574.       again or click OK and repeat the above process.  This non-recursive 
  575.       rule applies to HAZE, LITE and DARK; this way, you have much better 
  576.       control over the pixels your are "zoom editing".
  577.  
  578.       NOTE: WHEN USING HAZE LITE OR DARK, COLORBARS ARE DEACTIVATED.
  579.  
  580.       BLEND is recursive; each successive "click" of a zoomed pixel will 
  581.       make that pixel come closer and closer to the foreground color until 
  582.       it becomes the foreground color;  this function is useful for 
  583.       "tinting" or "shading" any pixel with ANY foreground color.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.       Page ... 9
  591.  
  592.  
  593.  
  594.  
  595.       PATTERN EDITING
  596.  
  597.       To edit a 16x16 section for use as a PATTERN FILL, select the pattern 
  598.       with the "Viewing Window" cursor; each 16x16 pattern is located at 
  599.       every 20th pixel (vertically and horizontally).  Once an area is 
  600.       zoomed, check the alignment by clicking the RIGHT button over the 
  601.       Viewing Window to see how the pattern looks in a "filled" rectangle; 
  602.       misaligned patterns have unwanted borders replicated in each 16x16 
  603.       section.  Press any button to return to zoom editing; you can edit it 
  604.       using ALL Zoom editing functions in ANY mode.  Whenever, you want to 
  605.       "see" the edited 16x16 pattern in a "test fill", click the Viewing 
  606.       Window with the RIGHT button.
  607.  
  608.  
  609.       11.  Image Processing Menu
  610.  
  611.               ┌───────────────────────────────────────────────┐
  612.               │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  613.               ││   │ │   │ │   │ │███│ │   │ │   │ │   │ │   ││
  614.               │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  615.               │ HAZE  DARK  LITE  CNVT  CONT  BLUR  KERNL  GO │
  616.               │ -Color Process-   -- Gray Image Processing -- │
  617.               └───────────────────────────────────────────────┘
  618.  
  619.  
  620.       COLOR PROCESSES
  621.  
  622.       The HAZE, LITE and DARK functions described in the ZOOM Menus work in 
  623.       a similar manner here; the main difference is that they operate as an 
  624.       area process; any defined rectangular area will be affected rather 
  625.       than individual pixels.
  626.  
  627.       TO PROCESS ANY GIVEN AREA (any method in this menu), determine your 
  628.       process and parameters by clicking the appropriate boxes successively; 
  629.       then CLICK "GO".  As in "Area Colorization", define an area to be 
  630.       processed; it will be highlighted by a blinking frame for acceptance 
  631.       (LEFT) or rejection (RIGHT).  If rejected, you can define another area 
  632.       or press the RIGHT button again to exit.
  633.  
  634.       GREY SCALE CONVERSION
  635.  
  636.       CoNVerT will convert color to grey shades; screens and palettes are 
  637.       PERMANENTLY altered.  Cycle through the options listed below by 
  638.       clicking the CNVT box; then click "GO".  After conversion, the picture 
  639.       will be highlighted; as usual, LEFT accepts and RIGHT rejects.
  640.  
  641.       "Stretched 64" - the highest grey scale resolution.  Your picture will 
  642.       be stretched to simulate 256 grey shades on a 64 grey continuuum.
  643.  
  644.       "Stretched 32" - medium grey scale resolution (256 grey scale on 32 
  645.       grey continuum).  This is useful when you intend to increase contrast 
  646.       or use more colors for colorizing after image processing.
  647.  
  648.       "Stretched 16" - low resolution grey scale (256 grey scale on 16 grey 
  649.       continuum).  This has very high contrast and gets the most number of 
  650.       colors for colorization.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.       Page ... 10
  657.  
  658.  
  659.  
  660.  
  661.       USE ONLY PICTURES CONVERTED WITH THE "STRETCHED" OPTIONS FOR IMAGE 
  662.       PROCESSING.  THE OPTIONS BELOW ARE FOR COLORIZATION AND SAVING OF A 
  663.       PROCESSED IMAGE.  The included palette "GRAY256.PLT" will view all 
  664.       pictures saved "STRETCHED nn" options.
  665.  
  666.       "COLORS 16-31" - After processing your image, using any of the 
  667.       "stretched" options, use this to change your image/palette to fit the 
  668.       default 16 grey palette that the VGA/MCGA card initializes to.  The 
  669.       image is converted and looks like the "Stretched 16" option.  When you 
  670.       save an image converted with this option, your image can be "Bloaded" 
  671.       in BASIC without any palette or loaded into VGACAD at start-up without 
  672.       any palette.  You will have 16 color ranges to colorize your image.
  673.  
  674.       "COLORS 32-63" - This option works the same way "COLORS 16-31" option 
  675.       does, but converts you image to correspond to the colors 32 to 63.  
  676.       The image looks like "Stretched 32" option.  "GRAY32.PLT" will show 
  677.       all pictures converted with this option.  This option allows 8 color 
  678.       ranges for colorization.
  679.  
  680.       "COLORS 64-128" - This option converts your image with as you would 
  681.       view it with the "Stretched 64" option.  The included palette 
  682.       "GRAY64.PLT" will view pictures saved under this option.  4 color 
  683.       ranges for colorization are possible.
  684.  
  685.       CONTRAST STRETCHING & ENHANCEMENT
  686.  
  687.       CONTrast Stretching uses a "histogram" of your grey pixels.  Each 
  688.       pixel has a grey value (0-255); for this reason, it is important to 
  689.       use only "stretched nn" options when converting for image processing.
  690.  
  691.       Contrast Stretching equalizes the grey distribution to evenly span the 
  692.       range of 0 to 255 values.  A typically unequalized image may have the 
  693.       following distribution of pixels.  The low and high bins are the edges 
  694.       of the histogram distribution.  All pixels between the edges (i.e., 
  695.       the high and low bin) are stretched to fill the entire 256 grey range.
  696.  
  697.         N  ╔═════════════════════════════════════════════════════╗
  698.            ║ low                   ▓▓                  high      ║
  699.         P  ║ bin ──┐          ▓   ▓▓▓▓                 bin       ║
  700.         i  ║       │         ▓▓   ▓▓▓▓                 │         ║
  701.         x  ║       ▓     ▓  ▓▓▓▓  ▓▓▓▓                 ▓         ║
  702.         e  ║ ▓     ▓     ▓▓▓▓▓▓▓▓ ▓▓▓▓▓           ▓▓  ▓▓▓        ║
  703.         l  ║ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║
  704.         s  ╚═════════════════════════════════════════════════════╝
  705.            0 -------------------------127----------------------255
  706.  
  707.       After Contrast Stretching the distribution will approximate this.
  708.  
  709.         N  ╔═════════════════════════════════════════════════════╗
  710.            ║                         ▓ ▓                         ║
  711.         P  ║                ▓      ▓ ▓ ▓ ▓                       ║
  712.         i  ║              ▓ ▓      ▓ ▓ ▓ ▓                 ▓     ║
  713.         x  ║▓     ▓     ▓ ▓ ▓ ▓    ▓ ▓ ▓ ▓                 ▓    ▓║
  714.         e  ║▓     ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓  ▓ ▓ ▓ ▓ ▓       ▓ ▓  ▓  ▓ ▓  ▓║
  715.         l  ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║
  716.         s  ╚═════════════════════════════════════════════════════╝
  717.            0 -------------------------127----------------------255
  718.  
  719.  
  720.  
  721.  
  722.       Page ... 11
  723.  
  724.  
  725.  
  726.  
  727.       You will note that the pixels now span the entire range and contrast 
  728.       is improved.  Bright pixels are brighter and dark pixels darker, other 
  729.       pixels in between are affected the same way.
  730.  
  731.       Upon selection of this option, you will requested for a "Minimum" 
  732.       number.  This number is the threshold for selecting the high and low 
  733.       bins.  The higher the number, the more likely that the bins will 
  734.       center on the middle and increase the Contrast Stretching effect. 
  735.       Since the histogram distribution is based on your defined area, the 
  736.       expected number of pixels per grey value will be much less in smaller 
  737.       areas than a larger area.  Selecting a large "Threshold Minimum" for a 
  738.       small area may result in no change since no bins may be located.  Try  
  739.       different Threshold Values to attain a desired effect.
  740.  
  741.       GREY BLURRING (Monochrome ANTI-ALIASING)
  742.  
  743.       BLURring results in a "smoothed" image with reduced "jaggies".  Here, 
  744.       the "Threshold Minimum" value adjusts the amount of "spikes", edges or 
  745.       details retained.  The higher the value, the smoother your image will 
  746.       be (including all other details).  You have to experiment with the 
  747.       right "Threshold Minimum" that "smooths" your image yet keeps a lot of 
  748.       detail.  This function uses "3x3 Pixels Averaging" with a variable 
  749.       threshold; its has advantages in adding more grey scale values in a 
  750.       picture with narrow grey scale distributions.  For example, if you 
  751.       captured an 320x200x16 grey GIF with VGACAP, using this method you 
  752.       will introduce intermediate grey values between the 16 grey scales 
  753.       which will make it more lifelike and approach photographic quality.
  754.  
  755.       There is a special mode.  If you select a "Threshold Minimum" of 256, 
  756.       a "3x3 Pixels Median Filter" is used;  this mode is effective in 
  757.       removing random noise while maintaining edge details.  This method is 
  758.       slower but results in a smoother picture with more edge detail.  On 
  759.       the "downside", it does not "add" intermediate grey pixel values.
  760.  
  761.       KERNEL CONVOLUTION (EDGE DETECTION & HIGH FREQUENCY BOOSTING)
  762.  
  763.       KERNeL Convolution will detect edges in your picture.  You can detect 
  764.       only vertical, horizontal, diagonal or ALL edges.  This Kernel detects 
  765.       all edges:
  766.                               ╔═══╦═══╦═══╗
  767.                               ║-1 ║-1 ║-1 ║
  768.                               ╠═══╬═══╬═══╣
  769.                               ║-1 ║ 8 ║-1 ║
  770.                               ╠═══╬═══╬═══╣
  771.                               ║-1 ║-1 ║-1 ║
  772.                               ╚═══╩═══╩═══╝
  773.  
  774.       If the value "8" is changed to "9" then this becomes a "High Frequency 
  775.       Boost" which "feeds back" the edges of your image, resulting in a very 
  776.       sharp but "noisy" image.  The center value can be varied up to 12 for 
  777.       creating "overexposed" effects.
  778.  
  779.       All image processing option follow the same user interface.  Select a 
  780.       rectangular area to be processed.  After processing an area, you can 
  781.       accept it or reject (and start over) or exit altogether.
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.       Page ... 12
  789.  
  790.  
  791.  
  792.  
  793.       12.   Edit Menu
  794.  
  795.            ┌───────────────────────────────────────────────┐
  796.            │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  797.            ││███│ │   │ │   │ │   │ │   │ │   │ │   │ │   ││
  798.            │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  799.            │ AUTO  USER  EDIT  Port  90'  Horz   180'  Vert│
  800.            │ Size  Size  Menu  -- FLIP & CONVERT SCREEN -- │
  801.            └───────────────────────────────────────────────┘
  802.  
  803.       AUTO Size shrinks or expands any defined area with its aspect ratio 
  804.       intact.  The image is always proportional regardless of resizing. 
  805.       Select a starting point; keep the LEFT button down and define an area. 
  806.       The captured area will be highlighted.  Select a NEW starting position 
  807.       and define an area which the captured image will either shrink or 
  808.       expand into.  After releasing the LEFT button, the image will "resize" 
  809.       into the new defined area.  Resized image are highlighted; as usual, 
  810.       accept with the LEFT or reject (and repeat or exit) with the RIGHT.  
  811.       Once you accept a change the image is permanently set; you cannot 
  812.       "undo" the change after accepting it.  This function uses a 5/6 aspect 
  813.       ratio and will be distorted if you are using the "1:1 aspect ratio" 
  814.       simulated by vFIX SCRN in the VSCRN menu (discussed later).
  815.  
  816.       USER Size works the same way AUTO sizing does without maintaining the 
  817.       aspect ratio.  Your new image will be stretched or distorted anyway 
  818.       you like.  Use this for special effects or to manually correct the 
  819.       aspect ratio of a digitized image.
  820.  
  821.       FLIPPING IMAGES
  822.  
  823.       "Port" (Portrait) rotates you entire screen 90 degrees with corrected 
  824.       5/6 aspect ratio; do not use this with vFIX SCRN option in VSCRN.  A 
  825.       frame will appear which you can set as the desired location for your 
  826.       portrait.  Use this to convert images that are captured sideways.
  827.  
  828.                  ┌──────────────┐        ┌─────┐
  829.                  │██████████████│        │█▓▓▒▒│
  830.                  │▓▓▓▓▓▓▓▓▓▓▓▓▓▓│  --->  │█▓▓▒▒│
  831.                  │▒▒▒▒▒▒▒▒▒▒▒▒▒▒│        │█▓▓▒▒│
  832.                  └──────────────┘        └─────┘
  833.                  BEFORE              AFTER
  834.  
  835.       "90'" will flip any captured area 90 degrees.  Like portrait, it will 
  836.       correct the image with a 5/6 aspect ratio.  Almost no detail is lost; 
  837.       the maximum size for conversion is the largest perfect square on your 
  838.       screen.  Do not use this with vFIX SCRN option in VSCRN !
  839.  
  840.       "Horz" (Horizontal Flip) will flip any area as you would see it in a 
  841.       mirror.  No detail is lost.
  842.  
  843.       "180'" (180 degree Flip) will flip any area as you would see it 
  844.       "upside down".  No detail is lost.
  845.  
  846.       "Vert" (Vertical Flip) will flip any area as you would see it in a 
  847.       mirror, but "upside down".  No detail is lost.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.       Page ... 13
  855.  
  856.  
  857.  
  858.  
  859.       THE EDIT SUB-MENU
  860.  
  861.              ┌───────────────────────────────────────────────┐
  862.              │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  863.              ││   │ │   │ │███│ │   │ │   │ │   │ │   │ │   ││
  864.              │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  865.              │COPY   CUT  FILE  DRAG  INVS  NORM  OVRLY  EXIT│
  866.              │-Clipboard- Menu  -----Paste Options-----      │
  867.              └───────────────────────────────────────────────┘ 
  868.  
  869.       The "EDIT Menu" transfers you to a "CUTTING and PASTING" sub-menu.  
  870.       YOU CAN ONLY EXIT THIS MENU BY CLICKING THE EXIT BOX.  "FILE Menu" 
  871.       will transfer to the file routines then return you to this menu.
  872.  
  873.       To capture an image, choose COPY or CUT; the latter option deletes the 
  874.       image from your screen.  Select area for COPY OR CUT; after releasing 
  875.       the mouse button, the defined area is highlighted for acceptance or 
  876.       rejection.  If accepted, you can save it to a *.CLP file through the 
  877.       FILE Menu transfer or use any of the 4 pasting options.
  878.  
  879.          OVeRLaY will probably be your most often used mode.  It will paste 
  880.          an image without destroying the background.  Images with a BLACK 
  881.          (color 0) background will have a "lasso" effect, wherein only the 
  882.          foreground portion of the "clipped" image is placed on the screen.
  883.  
  884.          NORMal and INVerSe will replace any background image with the 
  885.          captured image; INVerSe uses the inverse or complimentary colors.
  886.  
  887.          DRAG will continuously OVeRLaY your captured image until you 
  888.          release the LEFT mouse button - good for special effects.
  889.  
  890.       To paste, simply select the mode then place your cursor at a starting 
  891.       location.  The moment you press the LEFT mouse button, the image will 
  892.       appear (flashing);  you can then move your captured image to the 
  893.       desired location.  Once you release the LEFT mouse button the image 
  894.       will be set and highligted for rejection or acceptance.  If rejected, 
  895.       you can simply start all over.  You can only paste after capturing an 
  896.       image or retrieving one from a file.  If you exit the EDIT menu, any 
  897.       clipped images will be released; be sure to save it through FILE menu.
  898.  
  899.  
  900.       13.   Shapes Menu
  901.  
  902.       Selecting SHPS ("Shapes") "chains" the Shapes module.   Like ZOOM, 
  903.       this module will take a bit longer to activate and return to the Main 
  904.       menu; it is a separate module designed to "grow" and expand with 
  905.       extensive geometric and 'CAD' functions.
  906.  
  907.              ┌───────────────────────────────────────────────┐
  908.              │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  909.              ││   │ │   │ │   │ │███│ │   │ │ 1 │ │ <─┼─┼───┼┼───┐
  910.              │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│   │
  911.              │ UNDO  FILL  Poly  Rect  Circ  Line Curve EXIT │   │
  912.              │{█▓▓█▓▓░░▓▓██▓▓▒▒▓▓██▓▓▒▒▓▓▒▒▓▓▒▒██▓▓▒▒▓▓▒▒▓▓▒}│   │
  913.              └───────────────────────────────────────────────┘resolution
  914.               {▓██▓▓▓▒▒▓▓██▓▓▒▒▓▓██▓▓▒▒▓▓██▓▓▒▒██▓▓▒▒▓▓▒▒▓▓▒} of splines
  915.  
  916.  
  917.  
  918.  
  919.  
  920.       Page ... 14
  921.  
  922.  
  923.  
  924.  
  925.       When constructing a shape, the RIGHT button aborts placement; pressing 
  926.       the RIGHT button with the "arrow" cursor exits.  The LEFT constructs 
  927.       or sets a constructed shape.  The UNDO function will UNDO the last 
  928.       shape set; you can only UNDO shapes here.  VGACAD supports (filled or 
  929.       hollow) circles/ellipses and rectangles.  Filled shapes paint over the 
  930.       current screen up to borders with the foreground color regardless of 
  931.       the image.  Click the FILL box to fill constructed shapes.  Use the 
  932.       FILL Menu (sub-menu of the COLOR Menu) to fill complex shapes with 
  933.       solids, gradient or pattern fills.
  934.  
  935.       For circles, ellipses and rectangles, pick a starting position (e.g., 
  936.       upper-right for rectangles or center for ellipses); drag your cursor 
  937.       keeping the LEFT mouse button down; dragging the cursor down increases 
  938.       the length of the rectangle or Y radius of ellipse; moving right 
  939.       increases the rectangle width or the X radius of ellipse.  When happy 
  940.       with the shape, release the LEFT mouse button.  Place new shapes 
  941.       anywhere by moving your mouse even if an ellipse/circle was partially 
  942.       clipped during construction; hit the LEFT to set or RIGHT to abort.
  943.  
  944.       Rectangles can have borders (1 to 16 pixels thick); clicking the RECT 
  945.       box will increase and reset the border (to 1 when it exceeds 16).  The 
  946.       border thickness in indicated in the LINE box.
  947.  
  948.       LINEs begin when you hit the LEFT mouse button and end when released. 
  949.       Once released, the line will blink.  Hitting the LEFT button sets the 
  950.       line while the RIGHT aborts.
  951.  
  952.       CURVE will plot up to 32 points connected by straight lines.  You can 
  953.       plot less than 32 by hitting the RIGHT button.  After plotting your 
  954.       32nd point (or last point), splines are calculated and connected.  The 
  955.       number in the Curve Box is the resolution; the lower the number, the 
  956.       smoother the curves (it will also take longer to calculate).  During 
  957.       calculation you will hear random beeps to tell you that it is working.
  958.  
  959.       POLY works like the Curve plotting but has unlimited connected lines.  
  960.       The last line (when RIGHT button is pressed) is always connected to 
  961.       the first to close the polygon.  Use the Fill Menu to fill your 
  962.       polygons with the TRACE function.
  963.  
  964.  
  965.       14.   Text Menu
  966.  
  967.              ┌───────────────────────────────────────────────┐
  968.              │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  969.              ││   │ │   │ │███│ │   │ │   │ │   │ │   │ │   ││
  970.              │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  971.              │NORM  INVS  NORM  INVS   MIX   ---- COLOR  ----│
  972.              │--Overlay-- ----Replace------        BAR       │
  973.              └───────────────────────────────────────────────┘
  974.  
  975.       NORMal (Overlay) writes in the selected foreground color without 
  976.       destroying background (an "O" will have the image showing through its 
  977.       center). INVerSe (Overlay) places an inverse letter in the selected 
  978.       foreground color without destroying background; <spcbar> will leave a 
  979.       trail of solid blocks since a blank is a filled block when inversed.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.       Page ... 15
  987.  
  988.  
  989.  
  990.  
  991.       NORMal (Replace) places text on the screen, destructively - background 
  992.       is not preserved.  INVerSe (Replace) will, destructively, place the 
  993.       inverse text image.
  994.  
  995.       MIX (Replace) will place text with both the selected foreground color 
  996.       and background (e.g., yellow text on a blue background).  COLOR BAR 
  997.       will activate the colorbars for color selection.
  998.  
  999.       To place text on your screen, first select the mode.  An inverse box 
  1000.       appears as the cursor.  Place cursor at the starting point of your 
  1001.       text and hit the LEFT button.  A rectangular box will appear and you 
  1002.       can begin typing your text.  Text "wraps around"; pressing <return> 
  1003.       moves to the next line.  <Backspace> will undo your typos and restore 
  1004.       the original image.  Press <Esc> to keep your text, move to a new 
  1005.       location, and repeat the process.  You can always "undo" everything 
  1006.       from the Main menu.
  1007.  
  1008.       To be able to go back and change your text to different colors at the 
  1009.       their current positions, use the "Normal Overlay" mode and always 
  1010.       start your text cursor at the "HOME" position (extreme upper-left);  
  1011.       move around using <return> and <spcbar> to ensure text alignment.
  1012.  
  1013.  
  1014.       15.   File Menu
  1015.  
  1016.                              Changes to .CLP when in EDIT sub-menu.
  1017.            ┌─────────────────┼─────────────────────────────┐
  1018.            │┌───┐ ┌───┐ ┌───┐│┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  1019.            ││   │ │   │ │███<┘│OK │ │OK │ │OK │ │   │ │   ││
  1020.            │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  1021.            │.BLD  .PLT  .GIF   Meld  Load  Save VSCRN  EXIT│
  1022.            │ ---FileType----                               │
  1023.            └───────────────────────────────────────────────┘
  1024.  
  1025.       Over "FileType" are three types of extensions.  You must select a 
  1026.       filetype before LISTing, SAVing or LOADing.  ALL BOXES MARKED 'OK' 
  1027.       REQUIRE CLICKING THE 'OK' BOX, AT BOTTOM-RIGHT, TO PROCEED (to avoid 
  1028.       the inadvertent loss of your current screen and palette).
  1029.  
  1030.          ".BLD" are screens with "BLoaDable" format used in BASIC programs.  
  1031.          You can import CGA pictures with CGA2VGA, "readmacs" with MAC2GIF 
  1032.          or EGA/VGA 16-color pictures with EGA2VGA.
  1033.  
  1034.          ".PLT" are "PaLeTte" files, also in a "bloadable" format which can 
  1035.          be used to save and restore ranges of palette information by using 
  1036.          one BIOS call to reactivate the whole palette.
  1037.  
  1038.          ".GIF" are pictures saved in CompuServe's Graphic Interchange 
  1039.          Format.  In this release, any image up to 2048x2048x256 can be 
  1040.          loaded, but interpolated to 320x200x256; use SQZGIF for large 256 
  1041.          color pictures or user the VSCRN options discussed below.
  1042.  
  1043.          ".CLP" are "CLiP" art files that were captured with the BASIC "GET" 
  1044.          command and can be reloaded with the "PUT" command in another BASIC 
  1045.          program. ".CLP" art files will can only be activated when in the 
  1046.          EDIT sub-menu and called using the File Sub-Menu transfer option.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.       Page ... 16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.       To list files, click "BLD", "PLT", "GIF" (or "CLP") box; click again 
  1058.       to cycle through remaining files (if any) until you reach the end.
  1059.  
  1060.       To change your drive or sub-directory click the word PATHNAME and 
  1061.       key-in your new drive and/or sub-directory.  All pathnames MUST end 
  1062.       with a backslash.  Below are examples of correct syntax:
  1063.  
  1064.                    A:\MYDISK\
  1065.                    C:\VGACAD\PICS\
  1066.  
  1067.       SAVE and LOAD will operate on files with .BLD, .PLT, .CLP and .GIF 
  1068.       extensions.  Once you select this box, an inverse "text bar" will 
  1069.       appear; use that cursor to highlight a filename that you want to save 
  1070.       or load.  If you want to create a new file, move the "text bar" to 
  1071.       FILENAME and click LEFT button; enter any name up to eight letters 
  1072.       long.  Incorrect filename lengths result in an error beep and are 
  1073.       rejeced.  Once a filename is selected by highlighting or keying-in a 
  1074.       new name, click the "OK" box and your filename will be saved or 
  1075.       loaded.  The OK box is inversed while saving or loading.
  1076.  
  1077.       BLD files are automatically loaded with their matching PLT file.  If 
  1078.       no matching PLT is found then none is loaded; this is a convenience 
  1079.       that applies ONLY to the "LOAD" file function.
  1080.  
  1081.       MELD lets you to load a different PLT file which the current screen 
  1082.       and palette will be modified to closely approximate the new colors in 
  1083.       the new palette.  Both the PLT and MELD boxes will be "set" when MELD 
  1084.       is selected.  As usual, after transformation, you can accept with the 
  1085.       LEFT or reject with the RIGHT.  Meld is critical to mixing various 
  1086.       colored screens into a large screen using VSCRN (explained below). 
  1087.       Very divergent palettes will NOT MELD well; you have 262,144 color 
  1088.       combinations and ONLY 256 colors at any time.  For this reason we have 
  1089.       included two ways for color matching.
  1090.  
  1091.       RGB (Red, Green, Blue) matches are the most stringent and consequently 
  1092.       more accurate.  HSV (Hue, Saturation, Value) matches are more lenient 
  1093.       and will do a better job of increasing the number of colors matched, 
  1094.       in a less accurate manner.  You will have to experiment with both the 
  1095.       RGB and HSV algorithms for best results; some images will not "meld" 
  1096.       with satisfactory results due to RADICALLY DIFFERENT palettes.
  1097.  
  1098.       The MELD function will perform at its best when you want to compose a 
  1099.       large GIF from several screens or "clips" that have moderate to minor 
  1100.       palette differences.  If you are using a capture board, then try to 
  1101.       keep the same palette (i.e., rescan or capture without changing the 
  1102.       256 color palette); if you don't have that option then avoid melding 
  1103.       significantly different scans (e.g, "night scenes" and "day scenes").
  1104.  
  1105.       "Exit" returns to the Main Menu or Edit Menu (if you used the File 
  1106.       menu transfer option).  "End" will terminate the program and verifies 
  1107.       if you want to return to DOS; "Y"es ends the program.  VSCRN options 
  1108.       create TEMP files; you will be prompted to delete them or not.
  1109.  
  1110.       "Wipe" is basically a "clear screen" function.  Clicking this box will 
  1111.       clear your screen and return; this step is irrevocable - no UNDO.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.       Page ... 17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.       16.  VDISK - The Virtual Screen
  1124.  
  1125.              ┌───────────────────────────────────────────────┐
  1126.              │┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐│
  1127.              ││   │ │OK │ │   │ │   │ │OK │ │OK │ │███│ │   ││
  1128.              │└───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘ └───┘│
  1129.              │ vFix iSCR  View  List  NCod  DCod  BLANK  EXIT│
  1130.              │ SCRN vDSK  ---------GIF----------             │
  1131.              └───────────────────────────────────────────────┘
  1132.  
  1133.       VSCRN is a separate module.  It is virtually a separate program linked 
  1134.       to whatever screen you are working on; it is passed from one module to 
  1135.       another, along with your interface settings.  ALL BOXES MARKED WITH 
  1136.       'OK' REQUIRE CLICKING THE 'OK', AT BOTTOM RIGHT, TO PROCEED; this is a 
  1137.       verification step to avoid losing the screen/palette currently loaded.
  1138.  
  1139.       iSCR vDSK (Image Screen Virtual Disk) is your link to VERY LARGE GIFs. 
  1140.       Pressing [F1] shows all the keyboard commands while the "iSCR vDSK" 
  1141.       functions are activated.
  1142.  
  1143.       A Virtual Screen can be created by using the BLANK function or by 
  1144.       decoding a LARGE GIF file with any number of colors (preferably 256 
  1145.       colors since disk space is wasted with less than 256 colors).  With 
  1146.       the BLANK function, only a specified selection of Virtual Screens are 
  1147.       available.  With LARGE GIF files, you can edit virtually ANY GIF file 
  1148.       - up to 32KBx32KBx256 !!!
  1149.  
  1150.       Basically, a Virtual Screen is an image that is MUCH larger than your 
  1151.       screen; what you see is a "viewing window" that scrolls all over the 
  1152.       Virtual Screen.
  1153.                          ┌──────────┐██████████████
  1154.                          │ Viewing  │            ██
  1155.                          │ Window   │            ██
  1156.                          └──────────┘            ██
  1157.                          ██   Virtual Screen     ██
  1158.                          ██                      ██
  1159.                          ██████████████████████████
  1160.  
  1161.       A 640x400 virtual screen, has four 320x200 screens in it.  Think of 
  1162.       the "viewing window" as a "zoomed" portion of the total image; in the 
  1163.       case of 640x400, you are seeing 1/4 of the whole picture at any time.
  1164.  
  1165.       Before proceeding, let us review what an "aspect ratio" is.  Aspect 
  1166.       ratio is the number of horizontal pixels to vertical pixels that make 
  1167.       a perfect square.  The 320x200x256 mode has a 5/6 aspect ratio; for 
  1168.       every 6 pixels, horizontally, you need 5 pixels to make the vertical 
  1169.       line appear as the same lenght on the screen.
  1170.  
  1171.       With VGA 640x480 screens, the aspect ratio is a perfect 1.  The number 
  1172.       of horizontal pixels matches the number of vertical pixels to create a 
  1173.       perfect square.  All multiples of 640x480 have a perfectly aspect 
  1174.       ratio; this is why it is suited for DTP (Desk Top Publishing) - "what 
  1175.       you see is what you get" (WYSIWYG) !  Divide 640x480 by 2; you get 
  1176.       320x240; sound familiar ?  Yes, 320x240 is the size of Jovian VIA 
  1177.       scans which have a perfect aspect ratio of 1.  800x600 ? 1024x768 ?  
  1178.       Any picture that is a multiple of 640x480 has a 1:1 aspect ratio.
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.       Page ... 18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.       On the other "camp" are the 5/6 aspect ratios.  640x400 is a multiple 
  1190.       of 320x200; so is 1280x800 and so forth.  VGACAD uses 320x200 screens 
  1191.       to edit pictures; as such, if you edit a picture with a 1:1 aspect 
  1192.       ratio, it will look a little elongated.  vFix SCRN will alter your 
  1193.       screen aspect ratio so that editing in 320x200x256 will still give 
  1194.       WYSISYG when editing a picture with a 1:1 aspect ratio.  Although you 
  1195.       are editing in 320x200x256, any 320x200x256 section of your Virtual 
  1196.       Screen will be treated and look like it was created with an aspect 
  1197.       ratio of 1 !  vFix SCRN toggles between the 5/6 aspect ratio and 1:1 
  1198.       aspect ratio; you can edit both types of pictures accurately.  The 5/6 
  1199.       and 1:1 aspect ratios cover the universe of IBM/MSDOS, Amiga, Atari 
  1200.       and MacII pictures.  Occasionally, you will get GIFs with weird aspect 
  1201.       ratios (e.g. 360x480 and 320x400), which will look a bit distorted; 
  1202.       despite distortion, if you are merely touching-up or "smoothing" a 
  1203.       "hot spot", writing it back to the Virtual Screen will maintain its 
  1204.       aspect ratio as long as it is not resized or flipped (these aspect 
  1205.       ratios will be dealt with in succeeding updates).
  1206.  
  1207.     ┌─────────────────────────────────────────────────────────────────────┐
  1208.     │                          *** WARNING ***                            │
  1209.     │      The vFix SCRN option requires a 100% VGA compatible card!      │
  1210.     │    This option has not been tested for MCGA or PS/2 Model 25/30.    │
  1211.     └─────────────────────────────────────────────────────────────────────┘
  1212.  
  1213.       To create a BLANK Virtual SCreen, simply click "BLANK" and select from 
  1214.       the choices: [A] 640x400, [B] 640x480 and [C] 800x600.  Using the 
  1215.       640x400 Virtual Screen maximizes VGACAD's editing capabilities since 
  1216.       it was designed for the 320x200x256 mode.  You can paste any image 
  1217.       created from scratch WITHOUT the vFix SCRN option OFF or any image 
  1218.       originating from a picture with a 5/6 aspect ratio (e.g., 320x200, 
  1219.       640x400, 1280x800).
  1220.  
  1221.       If you opt for the 640x480 or 800x600 Virtual Screen, then turn the 
  1222.       vFix SCRN option ON.  Images created with the vFIX SCRN ON will have a 
  1223.       WYSIWYG capability.  Images "clipped" from pictures with 1:1 aspect 
  1224.       ratios will retain its aspect ratio even if the vFix SCRN option is 
  1225.       OFF (it will look a bit elongated in VGACAD but will look correct when 
  1226.       viewed as a total picture).  Thus, you can use any clip from a picture 
  1227.       with a 1:1 aspect ratio or create it from scratch using vFIX SCRN.
  1228.  
  1229.       Remember, you CANNOT mix aspect ratios unless you resize it manually 
  1230.       (which can be a bit daunting) or create them from scratch with the 
  1231.       correct aspect ratio setting (with vFix SCRN).
  1232.  
  1233.       Use "DCOD" (DeCODe) to create a Virtual Screen from a large GIF file.  
  1234.       Click "LIST" to see what GIFs are available (change the path if 
  1235.       necessary).  Click DCOD and click "OK"; that's it!
  1236.  
  1237.       The Virtual Screen uses several TEMP.* files.  A 640x480x256 GIF will 
  1238.       use up more than 307,200 bytes of disk space; 800x600x256 needs more 
  1239.       than 480,000; 1024x768x256 needs more than 786,432 !  Many GIF viewers 
  1240.       cannot even handle 1024x768x256 screens; with a Virtual Screen you can 
  1241.       edit virtually ANY GIF (up to 32KB x 32KB x 256).  There is a special 
  1242.       path called "VDSKpath" which tells VGACAD were to write/read pixels 
  1243.       to/from the Virtual Screen.  The speed of "viewing window" is directly 
  1244.       related to your disk drive; RAMDISK are fastest !
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.       Page ... 19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.       If you have extended or expanded memory, use a RAMDISK for the Virtual 
  1256.       Screen, to significantly speed reading from/writing to the "viewing 
  1257.       window"; a cache capability will help too.  With a LOT of RAM, copy 
  1258.       the entire VGACAD program on RAMDISK for "transparent" operation.
  1259.  
  1260.       Once you have created a Virtual Screen, the next thing to learn is 
  1261.       moving the "viewing window".  "iSCR SCRN" lets you view, get or put 
  1262.       screens from/to the Virtual Screen.
  1263.  
  1264.          <Return> "puts" your current screen in any given location on the 
  1265.          Virtual Screen;  <Esc> "gets" a screen from the Virtual Screen for 
  1266.          editing and image processing and replaces the current screen loaded 
  1267.          in the "viewing window".
  1268.  
  1269.       Moving around the Virtual Screen is done through numeric keypad keys.  
  1270.       Press [F1] for HELP; it provides a summary of these functions.
  1271.  
  1272.          <Shift-Home> or <Shift-7> jumps to the upper-left section.
  1273.          <Shift-End>  or <Shift-1> jumps to the lower-left section.
  1274.          <Shift-PgUp> or <Shift-9> jumps to the upper-right section.
  1275.          <Shift-PgDn> or <Shift-3> jumps to the lower-right section.
  1276.          <Shift-5> centers the "viewing window" on the Virtual Screen.
  1277.  
  1278.                     *** ALWAYS KEEP THE NUMLOCK KEY UP ***
  1279.                         ┌─────────┐ - - - -┌─────────┐
  1280.               "viewing  │ Shift-  │        │ Shift-  │
  1281.                window"->│ Home    │        │ PgUp    │
  1282.                         ├─────────┘        └─────────│
  1283.                         |         ┌─────────┐        |
  1284.                         |         │ Shift-5 │        |
  1285.                         |         │         │      <---- Virtual Screen 
  1286.                         |         └─────────┘        |
  1287.                         ├─────────┐        ┌─────────┤
  1288.                         │ Shift-  │        │ Shift-  │
  1289.                         │ End     │        │ PgDn    │
  1290.                         └─────────┘- - - - └─────────┘
  1291.  
  1292.       By the same logic, all the arrow keys, Home, PgUp, End, and PgDn will 
  1293.       move the "viewing window" in variable increments of 4 to 64 pixels, 
  1294.       horizontally, vertically and diagonally.  On default, the range of 
  1295.       pixel movement is 16.  Pressing [+] increments the range, while [-] 
  1296.       decrements; [*] resets the variable "scroll" to 16.  When you press 
  1297.       the [+],[-] or [*] keys, a rising tone indicates the increment level 
  1298.       (highest tone = 64); lower tones indicate decrements.  For precise 
  1299.       movements, the shifted-arrow keys will "scroll" in the vertical or 
  1300.       horizontal axes by one pixel.
  1301.  
  1302.       After editing and/or pasting various "clips" or screens, you can NCOD 
  1303.       (eNCODe) your Virtual Screen into a LARGE GIF - viewable with VIEW.
  1304.  
  1305.       VIEW "chains to" the MVGAVU program which supports several video 
  1306.       modes; it supports 320x400x256 and 360x480x256 in MVGA (Meduim-res 
  1307.       VGA) mode or "SuperVGA" modes from 640x400x256 to 800x600x256 or any 
  1308.       User-Definable video mode (unlimited screen size through BIOS calls).  
  1309.       MVGAVU is a separate program module that can stand-alone as a distinct 
  1310.       application; MVGAVU is discussed in another section.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.       Page ... 20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.       17.  VSCRN Tutorial
  1322.  
  1323.          Editing a Large GIF file (640x480x256)
  1324.  
  1325.          Let us assume you want to edit a 640x480x256 GIF picture and have a 
  1326.          corrupted copy of the classic WETT.GIF in a directory "\GIF\SVGA".  
  1327.          You want to remove some noise patterns from the lower-right corner 
  1328.          caused by a bad download.  You have a PS/2 Model 50, a 30 Meg Hard 
  1329.          Disk, and 1 Meg RAMDISK as Drive E.
  1330.  
  1331.          1)   From VGACAD's Main menu, click FILE.  From the Files menu, 
  1332.               click VSCRN.  Assuming you are in a sub-directory called 
  1333.               "\VGACAD" you will have to first locate your picture file.  
  1334.               Just like in the Files menu, you click the word "Pathname" at 
  1335.               the bottom of the screen.  You type the new path "\GIF\SVGA\".
  1336.  
  1337.          2)   Now that you have the right path, click the LIST box and all 
  1338.               the GIF files in that directory are listed.  Having a large 
  1339.               RAMDISK, click "Pathname".  Press <ret> without any input to 
  1340.               retain the PATH.  Input the path of your RAMDISK at "VDSKpath" 
  1341.               - which is "E:\" <ret>.
  1342.  
  1343.          3)   Click the DCOD box and select "WETT"; press the RIGHT mouse 
  1344.               button; "Filename: WETT.GIF" appears at the lower left.  Now, 
  1345.               click "OK"; the disk whirls; you see "Creating TEMP files."
  1346.  
  1347.          4)   After a while, you are returned to VSCRN.  Click the "iSCR 
  1348.               vDSK" box then OK; you see the center of your image which is 
  1349.               slightly elongated (you are still in a 5/6 aspect ratio).  To 
  1350.               correct the aspect ratio, press "Esc" to get out of "iSCR" and 
  1351.               click "vFix"; the screen "squishes" about 20%.  You are now in 
  1352.               a 320x200x256 mode with a 1:1 aspect ratio !
  1353.  
  1354.          5)   Now back to viewing; click "iSCR" then OK and try out all the 
  1355.               cursor keys.  Press [F1] for HELP.  With NUMLOCK UP, press 
  1356.               <Shift-End> to "jump" the "viewing window" to the lower-left 
  1357.               section of the image - the one you want to edit.  Press "Esc" 
  1358.               and the image is now stored in memory as your new 320x200x256 
  1359.               screen (but with a 1:1 aspect ratio).  Click EXIT and you are 
  1360.               back at VGACAD's Main Menu with the section to be edited.
  1361.  
  1362.          6)   Back at VGACAD, you'll notice that all the menus are slightly 
  1363.               "squished" but the screen looks like you "zoomed-in" the 
  1364.               640x480x256 GIF.  So far so good.  All the VGACAD functions 
  1365.               will work as normal (with the exception of resizing/flipping 
  1366.               options which assume a 5/6 aspect ratio).
  1367.  
  1368.          7)   After some time editing/image processing, you are now happy 
  1369.               with the results and want to integrate it in your Virtual 
  1370.               Screen.  Click the FILE box from the Main Menu, then VSCRN.  
  1371.               At the VSCRN menu, click the "iSCR" box, then OK; you see the 
  1372.               same image you left without your changes.  Press <Return> and 
  1373.               you see the changes being updated to your Virtual Screen.
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.       Page ... 21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.          8)   You think you have fixed the image and want to convert the 
  1388.               Virtual Screen to a SVGA GIF file.  Press "Esc".  You are back 
  1389.               in the VSCRN menu.  Click the "LIST" box and the files appear. 
  1390.               Click the NCOD box and a "text bar" cursor appears.  Since you 
  1391.               want to overwrite your old copy of WETT.GIF, you click the 
  1392.               LEFT mouse button over WETT.  Click OK and your image is now 
  1393.               being encoded as a SVGA 640x480x256 GIF.
  1394.  
  1395.          9)   After a while, you are returned to VSCRN.  You want to view 
  1396.               the results of your editing.  Click LIST again, then VIEW.  As 
  1397.               usual, select the file - WETT.  Click "OK".  You are now 
  1398.               transferred to MVGAVU where you can view your edited image as 
  1399.               a 320x400x256 or 360x480x256 image on your PS/2 Model 50.
  1400.  
  1401.  
  1402.          Creating a 640x400x256 image from scratch
  1403.  
  1404.          Let us assume you have a regular IBM XT, 30 meg Hard Disk with an 
  1405.          Orchid Designer VGA 512KB card.  You want to create a 640x400x256 
  1406.          SVGA GIF using the 320x200x256 images of Phoebe Cates from the 
  1407.          "Gallery" of Compuserve.  You have CATES1.GIF, CATES2.GIF and 
  1408.          CATES3.GIF; these are all 320x200x256 GIFs.  Since you have an old 
  1409.          Orchid Designer with BIOS v9.4; you run VGAFIX (included) to fix 
  1410.          the defective BIOS problem before running VGACAD.
  1411.  
  1412.          1)   Before anything else, you want to find out which of the three 
  1413.               GIF palettes you want to use as your "reference" palette (the 
  1414.               one which the other two will be MELDed with).  From the Files 
  1415.               menu, you click the GIF box, select CATES3, click LOAD then 
  1416.               OK; after a few seconds CATES3.GIF is loaded and you are back 
  1417.               in the Main menu of VGACAD.
  1418.  
  1419.          2)   Since CATES3.GIF is the "R-rated" scene of the three pictures, 
  1420.               you decide that this is the GIF that will be the "reference" 
  1421.               palette; let the other two GIFs be compromised to fit the 
  1422.               "reference" palette.  Click PLT, specify "CATESREF" (or any 
  1423.               other name) as the filename, then click OK.
  1424.  
  1425.          3)   Now transfer to the VSCRN menu by clicking VSCRN.  From the 
  1426.               VSCRN menu, click BLANK.  Choose [A] for the 640x400 Virtual 
  1427.               Screen.  After a while, you are returned to the VSCRN menu.  
  1428.               Click "iSCR", then OK; the screen is literally "blank".  At 
  1429.               this point in time, you are in the center of your Virtual 
  1430.               Screen.  You want to put CATES3 on the lower-left "quadrant", 
  1431.               so press <Shift-End> (NUMLOCK SHOULD BE UP); the disk whirls 
  1432.               but you don't see any changes in the screen (it is still 
  1433.               blank).  When the disk stops, press <Return>; the image 
  1434.               appears and updates the Virtual Screen.
  1435.  
  1436.          4)   Press "Esc" to get back to the VSCRN menu.  Click EXIT and you 
  1437.               are back in VGACAD's Main Menu with the CATES3 image.  Now, 
  1438.               LOAD "CATES2.GIF".  Click "GIF"; select "CATES2"; click LOAD 
  1439.               then click "OK".  CATES2.GIF is now loaded.  You are back in 
  1440.               the Main Menu.  Being satisfied with the picture, you forego 
  1441.               any editing and image procesing and simply want to integrate 
  1442.               it in the Virtual Screen.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.       Page ... 22
  1449.  
  1450.  
  1451.  
  1452.  
  1453.          5)   Click FILE; from the Files Menu, click MELD.  The PLT and MELD 
  1454.               boxes are both "set".   With the "text bar" cursor, you pick 
  1455.               "CATESREF" which you previously saved as your "reference" 
  1456.               palette.  You then click "OK".  You are now given a choice to 
  1457.               use RGB or HSV color matching; you guess that the colors are 
  1458.               close enough so you choose RGB for the best color match.  The 
  1459.               picture changes color then reappears with new colors.  Happy 
  1460.               with the MELDed output, you proceed to VSCRN.
  1461.  
  1462.          6)   From VSCRN you pick "iSCR" again, then OK, and see the last 
  1463.               screen you "pasted" on the Virtual Screen (i.e., CATES3).  You 
  1464.               want to place CATES2 in the upper-right quadrant; <Shift-PgUp> 
  1465.               (NUMLOCK IS UP!) and the screen "blanks" since that "quadrant" 
  1466.               is empty.  Press <return> and CATES2 appears and is updated in 
  1467.               the Virtual Screen at that location.
  1468.  
  1469.               REPEAT steps 4 to 6 for the last screen (CATES1) and place it 
  1470.               at any of two remaining "quadrants" (i.e., the lower-right or 
  1471.               upper-left).  You can use the remaining "quadrant" for text.
  1472.  
  1473.          7)   Having MELDed the three 320x200x256 screens of Phoebe Cates 
  1474.               and added text to the last "quadrant" you now want to convert 
  1475.               the Virtual Screen to a large GIF.  Knowing you have almost no 
  1476.               space in your Hard Disk left (you didn't clean-up for 3 months 
  1477.               <grin>) you want to save NEWCATES.GIF to a 360KB floppy in 
  1478.               Drive A, so you click "Pathname" and change it to "A:\".
  1479.  
  1480.          8)   Now, click the "LIST" box; no files appear since it is a blank 
  1481.               floppy disk.  Click the NCOD box and a "text bar" cursor 
  1482.               appears.  Since you want to create a new filename, you move 
  1483.               the "text bar" cursor to "Filename" and click the LEFT mouse 
  1484.               button.  Type the new filename (e.g., "NEWCATES"); you press 
  1485.               <return> and the .GIF extension is added to your filename.  
  1486.               Click OK; your image is now being encoded as a NEWCATES.GIF 
  1487.               (640x400x256) in Drive A.
  1488.  
  1489.          9)   After a minute, you are back at the VSCRN menu.  To view the 
  1490.               results of your editing click LIST, then VIEW; select NEWCATES 
  1491.               then click "OK".  You are now transferred to MVGAVU where you 
  1492.               can view your edited image as a 640x400x256 (even if this mode 
  1493.               is not supported by the Orchid DVGA) !
  1494.  
  1495.          If you have an image capture board that saves pictures with 1:1 
  1496.          aspect ratios (e.g., Jovian VIA), simply save them as "clips" (you 
  1497.          can use VGACAP to grab screens while viewing it is 320x200x256 with 
  1498.          MVGAVU or another viewer); each "clip", however, will have a 
  1499.          maximum size of 320x200.  But, if you viewed it with a viewer that 
  1500.          scrolls (e.g., PICEM) in 320x200x256 and capture sections of the 
  1501.          scrolled image, the 1:1 aspect ratio will be maintained.  You can 
  1502.          use the vFIX option in VSCRN to paste all your clippings together 
  1503.          while working with a zoomed WYSIWYG feel.  Remember, although each 
  1504.          clip (i.e. *.BLD screen or *.CLP) has a maximum size of 320x200, if 
  1505.          you viewed it in 320x200x256 mode without resizing or "fitting to 
  1506.          screen", it will keep its 1:1 aspect ratio and can be treated as 
  1507.          such for 640x480 or 800x600 Virtual Screens.
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.       Page ... 23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.       18.  MVGAVU GIF BLD/PT Viewing Utility
  1520.  
  1521.       MVGAVU is a GIF and BLD/PLT (BLoaD and PaLleTte) viewer for use in a 
  1522.       batch file (*.BAT) or as an interactive stand-alone program.  MVGAVU 
  1523.       is designed to integrate itself with VGACAD v1.6 (and up).  MVGAVU 
  1524.       uses two unsupported video modes for generic VGA cards - 320x400x256 
  1525.       and 360x480x256 !  The former mode DOUBLES the resolution (in contrast 
  1526.       to the MCGA/VGA 320x200x256 mode); the latter almost TRIPLES (270%) 
  1527.       the resolution.  MVGA (Medium Resolution VGA) provides you with the 
  1528.       capability to "view" those SVGA ("Super VGA") GIFs with the maximum 
  1529.       amount of resolution - "jaggies" are minimized.  In effect, you will 
  1530.       now have close to "Super VGA" capability on your regular, generic VGA 
  1531.       card without investing in a new SVGA video card.  MVGAVU supports SVGA 
  1532.       ("Super VGA") modes as well; the most generic families of SVGA cards 
  1533.       are hardcoded in MVGAVU (i.e., Tseng, Paradise, Video7 "families").
  1534.  
  1535.       MVGAVU automatically "fits to screen" ANY picture that is larger than 
  1536.       your viewing mode; you will always see the whole picture without 
  1537.       scrolling.  Certain GIF pictures with aspect ratio problems can be 
  1538.       "fixed" with MVGAVU, which provides two "aspect fixing" options.
  1539.  
  1540.       From VGACAD, your filename will be the one you selected from the VSCRN 
  1541.       menu.  As a stand-alone utility,  select any filename by moving a 
  1542.       highlighted bar (with the arrow keys) and pressing the <return> key. 
  1543.       <Spc> changes to a different PATH, while <Esc> exits.  PATHs, as 
  1544.       usual, MUST end with backslash character "\" or it will be rejected.  
  1545.       After verifying your picture you will see these options:
  1546.  
  1547.      [0] 320 x 400 x 256  MVGA mode       [1] 360 x 480 x 256  MVGA mode
  1548.      [2] FIX ASPECT (320x200,640x400)     [3] FIX ASPECT (640x480,800x600)
  1549.      [4] 640 x 400 x 256  SVGA Tseng      [5] 640 x 480 x 256  SVGA Tseng
  1550.      [6] 800 x 600 x 256  SVGA Tseng      [7] 640 x 350 x 256  SVGA Tseng
  1551.      [8] 640 x 400 x 256  SVGA Paradise   [9] 640 x 480 x 256  SVGA Paradise
  1552.      [A] 640 x 400 x 256  SVGA Video7     [B] 640 x 480 x 256  SVGA Video7
  1553.      [C] 800 x 600 x 256  SVGA Video7     [D] 720 x 540 x 256  SVGA Video7
  1554.      [E] 640 x 400 x 256  SVGA Everex     [X] NNN x NNN x 256  SVGA User
  1555.  
  1556.     [Esc] Abort Viewing                  [Spc] Restore Original Image Aspect
  1557.  
  1558.     The 320x400x256 mode is the safest !  It uses a minimum number of direct 
  1559.     VGA register reads/writes; in theory, it should run on even the least 
  1560.     "register-compatible" VGA card.  It has an interesting aspect ratio - 
  1561.     double the vertical resolution of MCGA/VGA 320x200x256 - thus MVGA ?! 
  1562.     This mode is the "safest" since it is way within the tolerances of all 
  1563.     PS/2 monitors.  Many Amiga/Atari/MacII GIFs use this aspect ratio; GIFs 
  1564.     viewed in this mode virtually replicates what the "originator" saw !
  1565.  
  1566.     The 360x480x256 mode pushes your VGA card to its theoretical limits !  
  1567.     With its 480 scan lines; the vertical resolution replicates 640x480x256 
  1568.     which is the most popular SVGA format.  You have 270% more resolution; 
  1569.     you can view 640x480x256 GIFs with a minimum of distortion or "jaggies". 
  1570.     Since the 360x480x256 mode is being implemented by some paint programs, 
  1571.     if a GIF image is encountered with a 360 pixel screen width but has a 
  1572.     screen height over 480 (e.g., 360x960x256 "Lester.GIF"), MVGAVU will 
  1573.     correct/interpolate the GIF to "fit the screen" with a new aspect ratio.
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.       Page ... 24
  1581.  
  1582.  
  1583.  
  1584.  
  1585.     If you get "weird" results from the 360x480x256 mode, your video card is 
  1586.     not as "register-compatible" as it claims to be;  use the 320x400x256 
  1587.     mode instead.  If the 320x400x256 mode does not yield favorable results, 
  1588.     then your VGA card is BIOS-compatible ONLY !  MVGAVU was designed to get 
  1589.     more viewing pleasure from SVGA GIFs on your generic VGA; 320x200x256 
  1590.     pics are "double-scanned" to compensate for the larger screen.  Whenever 
  1591.     possible, use BLD/PLT files for 320x200x256 pics; they load, virtually 
  1592.     instantaneously on MVGAVU !
  1593.  
  1594.     MVGAVU supports the more popular SVGA chip families.  Generally, we 
  1595.     included any 640x400x256, 640x480x256 and 800x600x256 mode.  MVGAVU is 
  1596.     hardcoded for:
  1597.  
  1598.          a) Tseng chip family (STB, Genoa, Orchid, Sigma, ...)
  1599.          b) Paradise chip family (Dell, AST, ...)
  1600.          c) Cirrus chip family (Video7, ...)
  1601.  
  1602.     If you do not see your video card listed, don't fret !  We included an 
  1603.     option to create your own video mode.  Specify the Screen Width, Screen 
  1604.     Height and Video Mode calling number.  On default, MVGAVU.CFG has the 
  1605.     MCGA parameters.  Press "Y"es to edit the parameters after prompted; 
  1606.     once edited, parameters are saved to disk and can be called at again.  
  1607.     This routine uses STANDARD VGA calling conventions; Everex and Video7 
  1608.     cards do not use this calling convention.  Everex users have a SVGA 
  1609.     640x400x256 mode preset; it uses BIOS calls to maximize compatibility.  
  1610.     Video7 users have all the "important" modes preset and hardcoded in 
  1611.     MVGAVU; you will not need to create other video modes.  This routine is 
  1612.     as GENERIC as it can get.  If your video card is as BIOS compatible as 
  1613.     it claims to be, then you can set ANY video mode with ANY resolution 
  1614.     (e.g., 1024x768x256, 1280x800x256).
  1615.  
  1616.     Tseng chip users (STB, Orchid, ...) have a special mode.  Since you do 
  1617.     not have a 640x400x256 mode, one was created for you.  This mode is not 
  1618.     supported by your video card; it is with MVGAVU !  The 640x400x256 mode 
  1619.     is a very important one.  Firstly, it has the same aspect ratio of the 
  1620.     regular MCGA/VGA 320x200x256 mode; when you view a 320x200x256 GIF in 
  1621.     this mode, there is a sudden change in the overall clarity/composition 
  1622.     of the picture - resolution is increased 400%, yielding a very pleasant 
  1623.     way to view your collection of 320x200x256 pics.  Secondly, many Amiga, 
  1624.     Atari and MacII GIFs use this aspect ratio; GIFs will be replicated AS 
  1625.     THE ORIGINATOR SAW IT when viewed in this mode.  Last, but not the least 
  1626.     is the 256KB barrier.  More video cards will be adding "clocks" which 
  1627.     will support the 640x400x256 mode on their 256KB versions (RAM is VERY 
  1628.     expensive); we anticipate an upsurge of this mode's appearance and 
  1629.     resulting number of pictures using this aspect ratio.
  1630.  
  1631.     When viewing Jovian VIA 320x240x256 GIFs, you will also notice how nice 
  1632.     it is to view them in 640x480x256 or 800x600x256; these GIFs have the 
  1633.     same aspect ratio.  This has the same effect of viewing 320x200x256 pics 
  1634.     in the 640x400x256 mode.
  1635.  
  1636.     Some "GIFfers" force the screen and image descriptors to have the same 
  1637.     values (e.g., CARMEN2.GIF); these large GIFs have a distorted aspect 
  1638.     ratio or require scrolling to view correctly (assuming you selected a 
  1639.     video mode with the matching aspect ratio).  Symptoms of this problem 
  1640.     are evident in "fat" or "squished" or "thin" pictures.
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.       Page ... 25
  1647.  
  1648.  
  1649.  
  1650.  
  1651.     FIX ASPECT (320x200,640x400) assumes the originator used a 5/6 screen 
  1652.     aspect ratio (e.g., MCGA 320x200, or Amiga/Atari/MacII 640x400).  An 
  1653.     image can have any size larger or smaller than the screen, but it must 
  1654.     have information about the aspect ratio to view it without distortion. 
  1655.     By selecting this option, MVGAVU will calculate the optimum screen size 
  1656.     and correct the image to approximate the correct aspect ratio.
  1657.  
  1658.     FIX ASPECT (640x480,800x600) assumes the originator used a "1:1 aspect 
  1659.     ratio"; the 320x240 (Jovian VIA), 640x480 (EEGA/MCGA/VGA/SVGA), 800x600 
  1660.     (EEGA/SVGA), 1024x768 (SVGA) modes all have "1:1 aspect ratios".  Almost 
  1661.     all scanners utilize a "1:1 aspect ratio".
  1662.  
  1663.     Whenever you view a picture that seems "too fat, too thin or squished" 
  1664.     then use either of the two options.  Both of these aspect ratio "fix" 
  1665.     routines will cover the universe of aspect ratio problems.
  1666.  
  1667.     MVGAVU can be used in a batch (*.BAT) file for presentations.  Simply 
  1668.     type "MVGAVU [filename] <ret>" with no extension (path optional); it 
  1669.     will automatically search for a matching *.GIF file.  If it can't find 
  1670.     any then it will look for a BLD/PLT file.  If a GIF file is found, it 
  1671.     will automatically be viewed in 320x400x256 mode.
  1672.  
  1673.          Examples:   MVGAVU test
  1674.                      MVGAVU \gif\svga\zoe
  1675.  
  1676.     If your video card cannot support the 320x400x256 mode (e.g., PS/2 Model 
  1677.     25 or 30) 320x200x256 will be implemented.  No matter what the size of 
  1678.     the picture, it is interpolated to "fit to screen".  If a BLD/PLT file 
  1679.     is found, MVGAVU will load it in 320x200x256 mode.  If no picture is 
  1680.     found or a BLD file has no matching PLT file, an error will result; 
  1681.     matching BLD/PLT files must be in the same drive/directory.
  1682.  
  1683.     In Command Line mode, your picture is displayed and pressing any key 
  1684.     after its display will end the program WITHOUT menus or prompts.
  1685.  
  1686.  
  1687.     19.  VGACAP (Resident Screen Capture Utility), RAW2GIF and BLD2GIF
  1688.  
  1689.     VGACAP captures palettes and screens in VGA/MCGA 320x200x256 color mode 
  1690.     or *ANY* SVGA 640x480x256 mode (AST, Dell, Genoa, Orchid, Paradise, STB, 
  1691.     Sigma, Tseng, Video7, etc.).  VGACAP captures and "Bsaves" 320x200x256 
  1692.     screens of other viewing/painting/graphics/CAD programs; 640x480x256 
  1693.     screens are saved to a *.RAW file - "RAW" pixel dumps.
  1694.  
  1695.     Run VGACAP before entering your painting/CAD or digitized picture 
  1696.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD 
  1697.     program and the screen and palette will be saved in your default drive 
  1698.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256 
  1699.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode, 
  1700.     then VGACAP will assume you are in 640x480x256 SVGA mode !
  1701.  
  1702.     <ALT-F4> is the new HOTKEY.  VGACAP v4.0 is 100% BIOS COMPATIBLE and 
  1703.     SHOULD capture *ANY* 640x480x256 screen, regardless of the video card 
  1704.     you are using.  If you are used to the FAST 320x200x256 grabs of VGACAP 
  1705.     v2.0 (included), you can load both versions without conflicting HOTKEYS 
  1706.     (VGACAP v1-v3 uses <ALT-F10>).
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.       Page ... 26
  1713.  
  1714.  
  1715.  
  1716.  
  1717.     The first time you run the program it will save your screen and palette 
  1718.     to SCREEN00.BLD and SCREEN00.PLT respectively.  If there is an existing 
  1719.     SCREENxx.BLD or SCREENxx.PLT file, then it will increment to the next 
  1720.     higher number.  Use your favorite memory managers to remove VGACAP or 
  1721.     reboot to release it from RAM.  When viewing in 640x480x256 SVGA mode, 
  1722.     then the SCREENxx.BLD file is changed to SCREENxx.RAW; the "Bload" 
  1723.     header is excluded and a "RAW" pixel dump is implemented; *.PLT files 
  1724.     are unchanged.  When in DOS or using a picture viewer (e.g., PICEM, 
  1725.     VPIC, or CSHOW) or application which requires a keypress to continue, 
  1726.     press another key after hitting the 'HOTKEY'.
  1727.  
  1728.     RAW2GIF is a *.RAW and *.PLT (PaLleTte) to GIF conversion program for 
  1729.     use in a batch file (*.BAT) or as an interactive stand-alone program; 
  1730.     *.RAW files are 640x480x256 screens captured with VGACAP (v4.0).  It is 
  1731.     designed to integrate itself with VGACAD v1.6 (and up).  BLD2GIF, like 
  1732.     RAW2GIF, is a BLD/PLT (BLoaD and PaLleTte) to GIF conversion program. 
  1733.     BLD2GIF will load and convert BLD/PLT files from VGACAP, VGACAD, SQZGIF, 
  1734.     EGA2VGA or MAC2GIF.
  1735.  
  1736.     If you capture a 640x480x256 screen for direct editing in VGACAD then: 
  1737.  
  1738.     (1)  from the VSCRN Menu, create a blank 640x480 Virtual Screen; 
  1739.     (2)  exit VGACAD and DO NOT DELETE the TEMP files;
  1740.     (3)  overwrite TEMP.RAW and TEMP.PLT with the selected SCREENxx.RAW and 
  1741.          SCREENxx.PLT files; for example, at DOS prompt type
  1742.  
  1743.                        "COPY screen00.* temp.*" <ret>
  1744.  
  1745.     (4)  run VGACAD and load TEMP.PLT at the Files Menu;
  1746.     (5)  click the VSCRN box; at the VSCRN Menu, click iSCR vDSK then OK; 
  1747.          you see the captured 640x480x256 image as the new Virtual Screen.
  1748.  
  1749.     If you exit VGACAD and want to reuse TEMP files, upon restarting VGACAD, 
  1750.     you MUST reload TEMP.PLT from the Files Menu BEFORE invoking VSCRN.  
  1751.     YOUR CURRENT PALETTE ALWAYS OVERWRITES TEMP.PLT AFTER EXITING VSCRN !
  1752.  
  1753.     If you type "RAW2GIF <ret>", you can select any filename by moving a 
  1754.     highlighted bar (with the arrow keys) and pressing the <return> key.  
  1755.     Pressing <Spc> allows you to select a different PATH, while <Esc> 
  1756.     exits.  Be sure *.RAW files have a corresponding *.PLT file or a error 
  1757.     message will result.  A *.GIF file is created with the corresponding 
  1758.     name.  GIF FILES WITH THE SAME NAME WILL BE OVERWRITTEN !  RAW2GIF can 
  1759.     be used in a batch (*.BAT) file for multiple conversions.  Type "RAW2GIF 
  1760.     [filename] " with no extension (path optional) for every file you want 
  1761.     to convert in your *.BAT file or a specific RAW/PLT file from DOS.
  1762.  
  1763.          Examples:   RAW2GIF screen00
  1764.                      RAW2GIF \capture\vga\screen99
  1765.  
  1766.     RAW2GIF will automatically search for the *.RAW and *.PLT file.  If no 
  1767.     picture is found or a *.RAW file is encountered with no matching *.PLT 
  1768.     file, then an error will result; both the matching *.RAW and *.PLT files 
  1769.     must be in the same drive/directory or default drive/directory. BLD2GIF 
  1770.     utility works exactly the same way RAW2GIF does but for BLD/PLT files.
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.       Page ... 27
  1779.  
  1780.  
  1781.  
  1782.  
  1783.     20.  CGA2VGA (Screen Capture & Convert Utility)
  1784.  
  1785.     CGA2VGA will capture/convert ANY VIEWABLE CGA picture for VGACAD use; 
  1786.     64kb RAM is required.  CGA2VGA "bsaves" 4-color CGA screens. "Hotkey" is 
  1787.     <Alt-F2>.  CGA2VGA DOES NOT SAVE A PALETTE; captured screens will have 4 
  1788.     colors (Color 0-3); you can modify or add colors with VGACAD.
  1789.  
  1790.  
  1791.     21.  REGISTRATION
  1792.  
  1793.     VGACAD (v1.6 and up) and its ancillary utilities will undergo a price 
  1794.     change.  Due to the rising cost of graphics peripherals AND the "poor 
  1795.     response" to this Shareware approach (we estimate a minuscule 1% to 5% 
  1796.     register), we must increase the registration fee to keep developing.
  1797.  
  1798.     VGACAD v1.60 (and up) and ancillary utilities developed during and after 
  1799.     its release will cost $27.95 USD (add $15.00 USD for handling for 
  1800.     registration outside USA or CANADA).  The following are provided (latest 
  1801.     copy or update) to registered users.
  1802.  
  1803.     GIFPUB - converts 256 color GIFs to B&W images of varying sizes for 
  1804.     desktop publishing/printing as .PCX (ZSoft format for Ventura Desk Top 
  1805.     Publisher, First Publisher, Publisher's Paintbrush, PC  Paintbrush+) or 
  1806.     rename files to .PCC for importing in Aldus Pagemaker.
  1807.  
  1808.     GIFDOT - converts 256 color GIFs to B&W images of varying sizes for 
  1809.     printing on IBM and Epson compatible printers (separate drivers).  
  1810.     Several print sizes with perfect aspect ratios.  Variable Brightness and 
  1811.     Contrast Stretching. Single or Double pass printing.  Histogram Analysis
  1812.  
  1813.     SQZGIF - converts LARGE GIF pictures (up to 2048x2048x256) to 
  1814.     320x200x256 using interpolation and "color averaging" techniques to 
  1815.     blend/smooth "jaggies" inherent in reducing LARGE GIFS while retaining a 
  1816.     maximum of color information; outputs to GIFPUB, GIFDOT, VGACAD, MVGAVU, 
  1817.     VGA2CGA or VGA2EGA.
  1818.  
  1819.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or 
  1820.     color and saves results as .GIF or BLD/PLT file, and other formats; 
  1821.     graphics are viewable in VGA, MCGA or EGA - no video card is required 
  1822.     for direct Black & White conversion to GIF.
  1823.  
  1824.     EGA2VGA - converts GIFs (16 colors and below) or ANY VIEWABLE 2-16 color 
  1825.     EGA/EEGA picture to 320x200x256; creates 256 new colors; outputs 
  1826.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  1827.  
  1828.     VGA2CGA - converts 256 color GIFs to CGA!  Uses unsupported 160x100x16 
  1829.     mode with up to "405" colors.  Includes special "CGX" viewer.
  1830.  
  1831.     VGA2EGA - Conversion program for displaying 256 color pictures on 
  1832.     EGA-bound systems.  Variable RGBICMY color/contrast/dithering levels.  
  1833.     Variable Sizing.  EEGA support.  Optional PCX (4 RGBI planes) save for 
  1834.     Desktop Color Separation.
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.       Page ... 28
  1845.  
  1846.  
  1847.  
  1848.  
  1849.     Whats next ?
  1850.  
  1851.     SYNPCX is utility to convert dithered, monochrome .PCX (Zsoft) files to 
  1852.     smooth grey shades.  This utility is primarily designed to convert 
  1853.     scanned (e.g., Logitech & DFI hand scanners) Black & White images, saved 
  1854.     to a .PCX file, for use and image processing with VGACAD, redithering 
  1855.     with GIFPUB, printing with GIFDOT, or EGA conversion with VGA2EGA.  
  1856.     SYNPCX will be graphics device independent (No Video Required).
  1857.  
  1858.     We are also, developing VGASHW (a 256-color presentation system), VGACBT 
  1859.     (the PROGRAMMABLE Computer-Based Training counterpart of VGASHW) AND 
  1860.     MANNEQUIN (what "Weird Science" tried to do in the movie it will do on 
  1861.     the computer screen with potential applications for Advertising and 
  1862.     Fashion Design, aside from creating your own artistic nudes).
  1863.  
  1864.     VGACAD will go through radical transformations like this version has 
  1865.     undergone.  With our "chained environment" updates will can now be 
  1866.     released in modules; moreover, all our utilities will become fully 
  1867.     integrated with VGACAD.  We intend to support more VGACAD functions in 
  1868.     MVGA modes and SVGA modes (all optional, MCGA/VGA 320x200x256 will 
  1869.     always be the least common denominator).  Some planned changes include 
  1870.     (1) more color image procesing algorithms, (2) full-blown expansion of 
  1871.     the SHAPES module to incorporate more CAD functions, (3) a separate 3D 
  1872.     module, (4) other file formats such as .PCX and TIF, ... more !
  1873.  
  1874.     If you support maverick authors like us, we will continue to develop 
  1875.     innovative products like nothing seen commercially - otherwise, they 
  1876.     will, as many (sigh!) good Shareware programs, simply "DIE" from lack of 
  1877.     support !  Compare the cost/benefit ratio of any of our products with 
  1878.     commercial products; we want to continue supporting and developing these 
  1879.     products.  Please support the User-Supported (Shareware) concept;  you, 
  1880.     and you alone, determine whether it will be worthwhile to continue 
  1881.     developing.
  1882.  
  1883.     To register, send in the registration form and check payable to
  1884.  
  1885.                              Dr. Marvin Gozum
  1886.                       2 Independence Place Apt. 303-2
  1887.                             6th & Locust Street
  1888.                           Philadelphia, PA 19106
  1889.  
  1890.  
  1891.     NOTE:     ADD $10 (USD) IF YOU WANT YOUR UPDATES IN 3.5" FORMAT.
  1892.  
  1893.               WE ARE WAIVING THE $15 (USD) HANDLING CHARGE FOR CANADIAN 
  1894.               REGISTRANTS; THIS OFFER IS VALID *ONLY* WITH VGACAD v1.6 
  1895.               REGISTRATION FORM OR PRINT-OUT OF THIS PAGE.  REGISTRANTS 
  1896.               FROM OTHER COUNTRIES *MUST* ADD THE HANDLING CHARGE TO THE 
  1897.               BASIC REGISTRATION !
  1898.  
  1899.  
  1900.  
  1901.     ───────────────────────────────────────────────────────
  1902.     Graphics Interchange Format and GIF are trademarks (tm)
  1903.     of CompuServe Inc. an H&R Block Company. 
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.       Page ... 29
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.                          Palette Organization Map
  1917.                                 Appendix A
  1918.  
  1919.  
  1920. The following diagram shows where each of the 255 color registers of the 
  1921. 256 color palette are located.  Please note the inverse color relation- 
  1922. ships for each color box.   For example, if you are modifying color 13, 
  1923. you must ensure that color 242 is significantly different that color 13 to 
  1924. maintain cursor visibility when placed over either color 13 or 242.
  1925.  
  1926. A 16 color set is a line of 16 colors as illustrated below.  Colors 0 to 
  1927. 16 is considered a color set, as well as colors 255 to 240 or 48 to 63.
  1928.  
  1929.  
  1930.  
  1931. ───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───┬┬───
  1932.   0││  1││  2││  3││  4││  5││  6││  7││  8││  9││ 10││ 11││ 12││ 13││ 14││ 15
  1933. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1934. 255 │254 │253 │252 │251 │250 │249 │248 │247 │246 │245 │244 │243 │242 │241 │240
  1935. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1936.  16││ 17││ 18││ 19││ 20││ 21││ 22││ 23││ 24││ 25││ 26││ 27││ 28││ 29││ 30││ 31
  1937. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1938. 239 │238 │237 │236 │235 │234 │233 │232 │231 │230 │229 │228 │227 │226 │225 │224
  1939. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1940.  32││ 33││ 34││ 35││ 36││ 37││ 38││ 39││ 40││ 41││ 42││ 43││ 44││ 45││ 46││ 47
  1941. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1942. 223 │222 │221 │220 │219 │218 │217 │216 │215 │214 │213 │212 │211 │210 │209 │208
  1943. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1944.  48││ 49││ 50││ 51││ 52││ 53││ 54││ 55││ 56││ 57││ 58││ 59││ 60││ 61││ 62││ 63
  1945. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1946. 207 │206 │205 │204 │203 │202 │201 │200 │199 │198 │197 │196 │195 │194 │193 │192
  1947. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1948.  64││ 65││ 66││ 67││ 68││ 69││ 70││ 71││ 72││ 73││ 74││ 75││ 76││ 77││ 78││ 79
  1949. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1950. 191 │190 │189 │188 │187 │186 │185 │184 │183 │182 │181 │180 │179 │178 │177 │176
  1951. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1952.  80││ 81││ 82││ 83││ 84││ 85││ 86││ 87││ 88││ 89││ 90││ 91││ 92││ 93││ 94││ 95
  1953. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1954. 175 │174 │173 │172 │171 │170 │169 │168 │167 │166 │165 │164 │163 │162 │161 │160
  1955. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1956.  96││ 97││ 98││ 99││100││101││102││103││104││105││106││107││108││109││110││111
  1957. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1958. 159 │158 │157 │156 │155 │154 │153 │152 │151 │150 │149 │148 │147 │146 │145 │144
  1959. ───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───┬┼───
  1960. 112││113││114││115││116││117││118││119││120││121││122││123││124││125││126││127
  1961. ───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───┘├───
  1962. 143 │142 │141 │140 │139 │138 │137 │136 │135 │134 │133 │132 │131 │130 │129 │128
  1963. ────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴───
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.       Page ... 30
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.                      How to Colorize Grey Shade Images
  1983.                                 Appendix B
  1984.  
  1985.  
  1986.     False Colorization is the process by which you are now viewing Black & 
  1987.     White movie classics in living color.  You can do the same thing, 
  1988.     particularly if you own a digitizer that supports grey scales.  I have 
  1989.     selected 16 gray shades as the main focus of VGACAD's support, 
  1990.     primarily since it is aimed at the low-end market.   If you want to 
  1991.     colorize gray images with more that 16 shades use the ColorBAR (CBAR) 
  1992.     option to change the range of local colors.
  1993.  
  1994.     Let us colorize one of the famous GIF pics in BBSs - MONROE.GIF (which 
  1995.     is being distributed with Michael Vigneau's VGAGIF in VGADEMO.arc).
  1996.  
  1997.     MONROE.GIF is a 16 grey-level picture with colors 0 to 15 containing 
  1998.     the entire grey scale.  Run VGACAP, then view the picture with any GIF 
  1999.     viewing utility; capture the picture then load the screen and palette 
  2000.     in VGACAD. The first thing to do is to increase the number of grey 
  2001.     scale elements.  From the ImgP (Image Processing) menu:
  2002.  
  2003.          1)   Convert (CNVT) the picture into the "Stretched 64" format.  
  2004.               This will give you the maximum range of grey levels although 
  2005.               the picture will remain unchanged.
  2006.  
  2007.          2)   Next BLUR the picture with a Threshold "Minimum =12"; this 
  2008.               will smoothen the picture yet keep most of the edge detail.  
  2009.               The smoothing will introduce intermediate grey scale values 
  2010.               making your picture richer.  Notice the "salt and pepper", 
  2011.               random noise; these are the edges or "spikes" that were not 
  2012.               "blurred" to keep details.
  2013.  
  2014.          3)   You can remove those spikes with the Median Threshold 
  2015.               Filter, by increasing the value of BLUR to "Minimum=256".  
  2016.               You can, also, zoom into each area with "spikes" and blur 
  2017.               individual pixels with the HAZE function in the ZOOM Menu.  
  2018.               Using the Zoom Menu will take more time but a significant 
  2019.               amount of detail will be retained.
  2020.  
  2021.               You have numerous combinations of image procesing techniques 
  2022.               at your disposal.  You can use the CONTrast Enhancement 
  2023.               function, or EDGE Detection functions to boost details or 
  2024.               try different settings with the BLUR function to achieve 
  2025.               different effects; the HAZE, LITE, DARK and BLEND processes 
  2026.               can also be used on selected areas or pixels (from the Zoom 
  2027.               Menu); you have to experiment to get the optimal quality 
  2028.               from your grey image.
  2029.  
  2030.          4)   Convert (CNVT) the picture into a "Colors 32-63" format.  
  2031.               Now from the Files Menu, load the "GRAY32.PLT"; you will 
  2032.               notice that the picture remains untouched.  You are now 
  2033.               ready to colorize your grey image.
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.       Page ... 31
  2043.  
  2044.  
  2045.  
  2046.  
  2047.     From the COLOR menu, select the CBAR option and change the range to 32 
  2048.     by clicking the CBAR box until you see bands of 32 colors on the upper 
  2049.     and lower Colorbars.  Click the AREA Colorization option.  Now, with 
  2050.     the scroll arrows, set the lower Colorbar to the 32 grey range; set 
  2051.     the upper Colorbar to the flesh tones.  Select any area in your grey 
  2052.     image; after releasing the LEFT mouse button you will notice the 
  2053.     entire area to be colorized with the flesh tones of the upper 
  2054.     Colorbar.  Do this for all areas you think will have that flesh tone; 
  2055.     avoid the hair and background as much as possible.
  2056.  
  2057.     By now, most of your picture will have flesh tones and overlapping 
  2058.     areas in the hair and background.  To edit each area, use the ZOOM 
  2059.     function in XColor mode;  XColor will perform in the same manner as 
  2060.     AREA Colorization but on a pixel basis; remember to keep the upper and 
  2061.     lower Colorbars to reflect which range is being replaced by the other 
  2062.     - the lower Colorbar always replaces the upper Colorbar.  You can now 
  2063.     use a "yellowish" Colorbar to simulate blonde hair color.  If you are 
  2064.     not happy with any of the hues, simply go into the Color Map and 
  2065.     adjust any range until you have colors best suited for your image.
  2066.  
  2067.     Once you have colorized the hair, flesh areas and even the background, 
  2068.     you will notice that no matter how careful you are at differentiating 
  2069.     one colorized area from another (e.g., hair from her face) there will 
  2070.     be an area of high contrast between the colorized areas.  Click the 
  2071.     MODE box and switch to PROCESS; use the HAZE, LITE, DARK or BLEND 
  2072.     functions to smooth out the adjacent areas.
  2073.  
  2074.     Now for the final touches, you can paint over the eyes, lips, nails 
  2075.     and any other detail in NORMAL mode or assign a new range for these 
  2076.     areas; each range uses 32 colors - limiting you to 8 color ranges. 
  2077.     There are innumerable combinations to colorize your grey picture.  If 
  2078.     you decided to convert your image processed picture to 16 grey levels 
  2079.     then you would have 16 color ranges to play with.  Experimentation is 
  2080.     the only way to optimize the results; after a few sessions you will be 
  2081.     able to make startling colorized images.
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.       Page ... 32
  2109.  
  2110.  
  2111.  
  2112.  
  2113.                      Notes on Additive Color Mixtures
  2114.                                 Appendix C
  2115.  
  2116.  
  2117.     The Principle of Additive Color Mixture is the same principle used by 
  2118.     the television and monitors to generate images.  The principle entails 
  2119.     the ADDITION of three primary quanta: Red, Green and Blue when mixing 
  2120.     any two colors.
  2121.  
  2122.     To understand how it works, let us assume you have three flashlights: 
  2123.     one red, one green, and one blue.  Since white is the maximum mixture 
  2124.     of all three quanta or components, shining all three beams at the same 
  2125.     spot will produce white.  Since white results with maximum quanta of 
  2126.     red, green and blue, then if we have half of each red, green and blue 
  2127.     quanta, grey results !
  2128.  
  2129.     Most of the rules for mixing colors with this principle follow our 
  2130.     commonly held view of color mixing.  If you shine the red and blue 
  2131.     beams on the same spot you will get purple - so far everything seems 
  2132.     logical.  If you shine the blue and green beams you get blue-green.  
  2133.     So where is yellow ?  Now for the weird part; if you mix red and 
  2134.     green, yellow results !  Yes, yellow is red and green together.  
  2135.     Depending on the amounts of red and green, different shades of brown 
  2136.     will result.  If you have more red than green, you will get orange. If 
  2137.     you have more green that red you will get yellow-orange.
  2138.  
  2139.     The Principle of Additive Color Mixture is quite different from the 
  2140.     way we normally think colors mix.  If you mix a pure yellow color with 
  2141.     pure blue, pure green should result, right ?  Wrong !!!  Remember what 
  2142.     white is made of ?  Since we added pure blue to pure yellow, which is 
  2143.     made of pure red and pure green, we now have - WHITE.
  2144.  
  2145.     The portions of red, green and blue that are common to all of the 
  2146.     three will result in white - which will show as shades of grey if we 
  2147.     have fractions of red, green and blue.  If you mix, 50 quanta of red, 
  2148.     25 quanta of green and 33 quanta of blue, the common level of quanta 
  2149.     is 25 - thus you will have 25 quanta of white.  The primary quanta 
  2150.     with the most portions will dominate; thus, in this example we will 
  2151.     have a light red shade with a touch of blue -> light magenta.
  2152.  
  2153.     If you increased the portion of green to 50, such that R=50 G=50 B=33, 
  2154.     you will now have 33 quanta of white since that is the common level of 
  2155.     all three quanta.  Since Red and Green = Yellow, and you have so much 
  2156.     white in it, the color you will get is Light Yellow.  Now if you have 
  2157.     R=63 G=63 B=0 (pure yellow) "added" to R=0 G=0 B=63 (pure blue), the 
  2158.     resulting color is R=63 G=63 B=63 (pure white).
  2159.  
  2160.     In VGACAD, you will notice that when using a blue airbrush on yellow 
  2161.     areas, the color will either become light yellow or light blue 
  2162.     depending on the RGB quanta - it will NOT turn green.  Keep in mind 
  2163.     that [1] common portions of red, green and blue add white to your hue, 
  2164.     and [2] common portions of red and green add yellow to your hue.  
  2165.     Experiment with different RGB settings in the Color Map menu and see 
  2166.     what happens with different mixtures.
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.       Page ... 33
  2175.  
  2176.  
  2177.  
  2178.  
  2179.