home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / graphics / gifpub14 / gifpub14.doc < prev    next >
Text File  |  1989-03-02  |  21KB  |  529 lines
  1.  
  2.  
  3.  
  4.           GIFPUB (c) Copr. 1988-89 Lawrence Gozum & Marvin Gozum
  5.           ──────────────────────────────────────────────────────
  6.  
  7.                                 User Manual
  8.  
  9.     DISCLAIMER
  10.  
  11.     This product is distributed AS IS.  The authors specifically disclaim 
  12.     all warranties ,expressed or implied, including ,but not limited to, 
  13.     implied warranties of merchantability and fitness for a particular 
  14.     purpose with respect to defects in the diskette and documentation, and 
  15.     program license granted herein, in particular, and without limiting 
  16.     operation of the program license with respect to any particular 
  17.     application use or purpose.  In no event shall the authors be liable 
  18.     for any loss of profit or any other commercial damage including but 
  19.     not limited to special, incidental, consequential or other damages.
  20.  
  21.  
  22.     LICENSING AGREEMENT
  23.  
  24.     You may use this program on a TRIAL BASIS only;  this means that you 
  25.     may freely evaluate the usefulness of this program for 10 DAY TRIAL 
  26.     PERIOD.  Should you find this program useful, you must register it 
  27.     (see last section of this manual).   You will then be provided with 
  28.     the latest releases of applications that will run on your system.
  29.  
  30.     You may freely distribute copies of this program in its UNMODIFIED 
  31.     state provided you do not include it in other software packages, with 
  32.     the exception of distributing it as part of a bundle of Public Domain 
  33.     or shareware programs on a single diskette.  You may not charge more 
  34.     that $3.50 for copying and/or distributing this program in the absence 
  35.     of recognized Users Group guidelines (e.g., Association of Shareware 
  36.     Professionals or New York Amateur Computer Club)
  37.  
  38.  
  39.     WHAT IS GIFPUB ?
  40.  
  41.     GIFPUB is a conversion utility that converts the colored GIF pictures 
  42.     and any of the following listed below to a dithered (Floyd-Steinberg) 
  43.     Black & White image and save it to a .PCX (ZSoft) file for use in 
  44.     First Publisher, Ventura Publisher, Publisher's Paintbrush, and PC 
  45.     Paintbrush+; if the file is renamed to .PCC you can also import the 
  46.     file in Aldus Pagemaker.
  47.  
  48.     1)   ANY colored GIF picture (4 colors and up recommended), with any 
  49.          size (up to 2048 x 2048 x 256) - NO VIDEO REQUIRED WITH GIF pics.
  50.  
  51.     2)   ANY VIEWABLE VGA/MCGA 320x200x256 picture captured with VGACAP;
  52.  
  53.     3)   VGACAD pictures;
  54.  
  55.     4)   16-color pictures converted to 320x200x256 with EGA2VGA;
  56.  
  57.     5)   Colorized/converted MacPaint (READMACs) with MAC2GIF.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     GIFPUB is graphics card independent - NO VIDEO CARD IS NECESSARY.  You 
  71.     can save and load images without viewing them.  For viewing, GIFPUB 
  72.     supports video modes in CGA (640x200), Hercules (720x348), EGA 
  73.     (640x350), VGA (640x480) AND Extended EGA or SuperVGA (to 2KB x 2KB).
  74.  
  75.     GIFPUB converts your colored pictures to 256 grey shades on a 64 grey 
  76.     scale continuum; you can adjust the brightness and contrast levels 
  77.     through sophisticated Grey Scale Skewing (Brightness Adjustment) and 
  78.     Histogram-based Contrast Stretching algorithms.
  79.  
  80.     GIFPUB use the Floyd-Steinberg algorithm for dithering pictures; this 
  81.     error-distributed technique provides the illusion of a continuous grey 
  82.     scale limited only by your printer or video resolution.  As such, 
  83.     having the "sister-utility", GIFDOT, would help you determine the 
  84.     printed image quality before you "set" it on your document.  Since 
  85.     this method allows very fine grey shades to "appear", it doesn't take 
  86.     kindly to resizing.  GIFPUB supports resizing of any image, while 
  87.     maintaining the aspect ration in ANY video mode (including Extended 
  88.     EGA and SuperVGA); this way you can be confident of the image you will 
  89.     integrate and have the best possible rendering for what ever size you 
  90.     choose to include in your document.
  91.  
  92.  
  93.     WHAT IS VGACAP ?
  94.  
  95.     VGACAP is a terminate-stay-resident (TSR) utility that allows you to 
  96.     capture the 256 color palette and screen in the 320x200x256 color mode 
  97.     and save both the palette and screen in "Bloadable" formats.  VGACAP's 
  98.     main purpose is to capture and "Bsave" the pictures of commercial and 
  99.     Shareware viewing/painting/graphics/CAD programs.
  100.  
  101.  
  102.     REQUIREMENTS
  103.  
  104.     NO VIDEO CARD REQUIRED FOR USING GIFPUB.  About 512KB of memory is 
  105.     required, although it uses about 2/3 of that.
  106.  
  107.     You MUST have a VGA or MCGA adaptor (at least BIOS compatible) present 
  108.     and an analog monitor to use VGACAP.  VGACAP uses less than 2K of RAM.
  109.  
  110.  
  111.     HOW TO USE VGACAP
  112.  
  113.     Run VGACAP before entering your painting/CAD or digitized picture 
  114.     viewer.   Press <ALT-F10>, while viewing your picture in any 
  115.     drawing/paint/CAD program to save the screen and palette in your 
  116.     default drive and directory in the standard Bsave format.
  117.  
  118.     The first time you run the program it will save your screen and 
  119.     palette to SCREEN00.BLD and SCREEN00.PLT respectively.  If there is an 
  120.     existing SCREENxx.BLD or SCREENxx.PLT file, then it will increment to 
  121.     the next higher number.  You can use your favorite memory managers to 
  122.     remove this TSR or reboot to release it from memory.
  123.  
  124.     Note:  When in DOS or using a picture viewer (e.g., PICEM, VPIC, 
  125.     CSHOW) or application which requires a keypress to continue, it is 
  126.     necessary to hit another key after hitting the 'HOTKEY'.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     LOADING PICTURES INTO GIFPUB
  137.  
  138.     Two formats are accepted by GIFDOT: GIF and BLD/PLT files;  At the 
  139.     start of the program, you will be prompted to select [G]IF or [B]LD 
  140.     files to to selected or [Q]uit if you forgot the filename.
  141.  
  142.     When loading GIF pictures, if you have a VGA/MCGA card, GIFPUB will 
  143.     display the picture as it decodes it and show its conversion to a 256 
  144.     grey scale picture.  All other cards will load in memory; GIFPUB 
  145.     automatically senses if you have a VGA/MCGA or SuperVGA card.
  146.  
  147.     All pictures are interpolated to a 320x200 size.  SuperVGA GIF files 
  148.     (e.g., 640x480x256, 800x600x256 and 1024x768x256) are interpolated to 
  149.     320x200x256; SQZGIF is recommended for LARGE GIFs to retain more color 
  150.     information.
  151.  
  152.     16-color EGA/EEGA/VGA pictures will also be interpolated; it is highly 
  153.     recommended that you use EGA2VGA to process pictures before loading.
  154.  
  155.     You can select any filename by moving a highlighted bar (with the 
  156.     arrow keys) and pressing the <return> key.  Pressing <Spc> allows you 
  157.     to select a different PATH, while <Esc> exits.  When selecting a *.BLD 
  158.     file, it must have a corresponding  *.PLT file or a error message will 
  159.     result.
  160.  
  161.     PATHs MUST end with a backslash character "\" or your specified PATH 
  162.     will be rejected (an error beep will result).  The following are legal 
  163.     PATH examples:
  164.  
  165.               "A:\"
  166.               "B:\"
  167.               "C:\GIF\"
  168.               "D:\GIF\VGA\LARGE\"
  169.  
  170.     Every captured picture, VGACAD picture, converted EGA2VGA or SSQZGIF 
  171.     or MAC2GIF picture will have two files: the screen and palette.  The 
  172.     extension .BLD stands for BLoaD and .PLT for PaLetTe.
  173.  
  174.     THE MAIN MENU
  175.  
  176.          [C]GA                        640x200
  177.          [E]GA                        640x350
  178.          [V]GA                        640x480
  179.          [H]GC                        720x348
  180.          [X]tended EGA   (EEGA)      NNNNxNNNN
  181.          [S]uperVGA      (SVGA)      NNNNxNNNN
  182.          [7]Video7       (SVGA)      NNNNxNNNN
  183.          [F]ile    (no viewing)      NNNNxNNNN
  184.  
  185.          [A]nalyze Histogram
  186.          [B]rightness Threshold      NNNNxNNNN
  187.          [K]ontrast Threshold        NNNNxNNNN
  188.          [R]estore Screen
  189.          [N]ew Picture
  190.          [Q]uit
  191.  
  192.     Simply select the letter to initiate that function or option.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     CONTRAST STRETCHING & ENHANCEMENT
  203.  
  204.     [K] - Contrast Stretching is performed using a "histogram" of your 
  205.     pixel value distribution.  Each pixel can have a grey value 0 to 255 
  206.     which corresponds to each of the colors 0 to 255.
  207.  
  208.     This function equalizes the distribution of grey scales to evenly span 
  209.     the range of grey values from 0 to 255.  For example, a typically 
  210.     unequalized image may have the following distribution of pixels.  The 
  211.     low and high bins are the edges of the histogram distribution.  All 
  212.     pixels between the bins will be stretched to fill the 256 gray range.
  213.  
  214.         N  ╔═════════════════════════════════════════════════════╗
  215.            ║ low                   ▓▓                  high      ║
  216.         P  ║ bin ──┐          ▓   ▓▓▓▓                 bin       ║
  217.         i  ║       │         ▓▓   ▓▓▓▓                 │         ║
  218.         x  ║       ▓     ▓  ▓▓▓▓  ▓▓▓▓                 ▓         ║
  219.         e  ║ ▓     ▓     ▓▓▓▓▓▓▓▓ ▓▓▓▓▓           ▓▓  ▓▓▓        ║
  220.         l  ║ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║
  221.         s  ╚═════════════════════════════════════════════════════╝
  222.            0 -------------------------127----------------------255
  223.  
  224.     After Contrast Stretching the distribution will approximate this.
  225.  
  226.         N  ╔═════════════════════════════════════════════════════╗
  227.            ║                         ▓ ▓                         ║
  228.         P  ║                ▓      ▓ ▓ ▓ ▓                       ║
  229.         i  ║              ▓ ▓      ▓ ▓ ▓ ▓                 ▓     ║
  230.         x  ║▓     ▓     ▓ ▓ ▓ ▓    ▓ ▓ ▓ ▓                 ▓    ▓║
  231.         e  ║▓     ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓  ▓ ▓ ▓ ▓ ▓       ▓ ▓  ▓  ▓ ▓  ▓║
  232.         l  ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║
  233.         s  ╚═════════════════════════════════════════════════════╝
  234.            0 -------------------------127----------------------255
  235.  
  236.     When prompted "Add Contrast 1-255", select a number within that range 
  237.     and both the high and low bins will be move accordingly; normally a 
  238.     value between 1 and 30 will yield the best results.
  239.  
  240.     Note that when you have a picture surrounded by a large "black" area, 
  241.     that area may not be black BUT a very dark shade of grey resulting in 
  242.     a few error-distributed patterns to appear; you must use at least a 
  243.     value of "1" to equalize the grey distribution so that BLACK WILL BE 
  244.     THE DARKEST COLOR and avoid error-distributed pixels in areas that are 
  245.     supposed to be black.
  246.  
  247.     VGA/MCGA users will have interactive feedback; they will see the 
  248.     results and can abort the process; all other cards will not have this 
  249.     option.
  250.  
  251.  
  252.     BRIGHTNESS ADJUSTMENT
  253.  
  254.     When this option is selected, you will be prompted with "Adjust 
  255.     Brightness (+100-)"; the brightness of all pixels will be adjusted 
  256.     acoordingly.  A value of "-10" will "darken" all pixels by 10% (it 
  257.     will skew the distribution towards BLACK"; conversely a value of "20" 
  258.     will "brighten" all pixels by 20%.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     This feature is VERY IMPORTANT since what you see is normally NOT what 
  269.     you get (for VGA/MCGA users);  Since dot-matrix printers tend to 
  270.     emphasize BLACK rather than its absence, WHITE, a picture that looks 
  271.     fine on screen (VGA/MCGA users) will look much darker in print.
  272.  
  273.  
  274.     RESIZING OPTIONS
  275.  
  276.     Whenever you select a video mode or file to be created you will see 
  277.     these options (this screen shows blanks filled with examples).
  278.  
  279.               Video Mode/Aspect Ratio: EGA 640x350
  280.               Image Width  (pixels)  : 640
  281.               Image Height (pixels)  : 350
  282.  
  283.               Resizing Factor (1-100): 100%
  284.               Pathname               : C:\VENTURA\PCX
  285.               Filename               : NONAME.PCX
  286.  
  287.     Image Width and Height are set by the video mode you have chosen and 
  288.     cannot be changed except when e[X]tended EGA or [S]uperVGA or [F]ile 
  289.     is selected; it is automatically adjusted by the Resizing Factor.
  290.  
  291.     In this example the Image Width and Height matches the full screen 
  292.     since Resizing Factor is 100%; if it were 50% then each number will be 
  293.     cut in half.  To maintain your aspect ratios in SuperVGA or EEGA 
  294.     modes, always start with a Resizing Factor of 100% then reduce it 
  295.     accordingly.  Saving direct to files works similarly.  Video7 SuperVGA 
  296.     users have a special option [7] to set SVGA modes.
  297.  
  298.     When a standard video mode is selected (CGA,EGA,VGA and HGC); the 
  299.     Image Height and Width will always follow what is stated in the Video 
  300.     Mode/Aspect ratio line; only the Resizing Factor can be altered.  To 
  301.     retain an old setting, press return and the setting will remain.
  302.  
  303.  
  304.     OPTIMAL DITHERING
  305.  
  306.     To get the BEST dither, we suggest that you experiment with a small 
  307.     image (e.g., VGA at 25%) while interactively adjusting the brightness 
  308.     and contrast stretching variables; you can always [R]estore Screen if 
  309.     you have made "messed-up" your picture.  When satisfied with the 
  310.     results, you can progress to larger sizes or a LARGE file (up to 2048 
  311.     x 2048 pels).
  312.  
  313.  
  314.     HISTOGRAM ANALYSIS
  315.  
  316.     Non-VGA useers will find this function VERY useful; it gives feedback 
  317.     on the quality of your picture.  This function will display TWO(2) 
  318.     histograms.  The first, labelled "Original", is the screen that will 
  319.     be restored with the [R]estore Screen function, while the second is 
  320.     the "Modified" picture which reflects all the changes made.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     The scales used in the histograms are based on the MODE, which is the 
  335.     highest grey scale frequency in the picture; normally these are the 
  336.     far bins: BLACK and WHITE.  There are 64 points on the x-axis and 10 
  337.     points on the y-axis.  The 64 x-axis points correspond to the 64 grey 
  338.     scale continuum; the entire picture is "stretched" to 256 grey shades, 
  339.     which means that each point on the x-axis represents 4 grey levels.
  340.  
  341.     Each point on the y-axis varies with the MODE.  If the most frequent 
  342.     grey shade is BLACK and 20,000 pixels (about 1/3 of the screen) is 
  343.     BLACK, then each point on the y-axis will represent 2,000 pixels.  
  344.     With this in mind, grey shades with less that 2,000 pixels will appear 
  345.     as a "flat line".  You will notice that changing the Contrast or     
  346.     Brightness may make your "Modified" histogram appear as a "flat line"  
  347.     with a few very high bins.  You can magnify the scale (i.e, reduce the 
  348.     value each y-axis point represents) by pressing the <Spc> bar.  Bins 
  349.     with the "┼" character show grey shades that extend beyond the MODE 
  350.     (as you magnify the scale, more Bins will have this symbol).
  351.  
  352.     After modifying a picture (Contrast Stretching or Brightness Skewing), 
  353.     the "modified" picture may not display the full distribution since the 
  354.     highest bins are so large that smaller bins come out as a "flat 
  355.     line".  To see more data, reduce the [B]ins and/or magnify the scale 
  356.     with the <Spc> bar.
  357.  
  358.     Pressing the [B]ins key option will cut the "edges" or "anchors" of 
  359.     your "Modified" histogram by 1.  Thus, the first time you press [B]in, 
  360.     you grey scale continuuum will become a 2-62 grey scale; the next will 
  361.     be 3-61 and so forth.  Since pure BLACK and WHITE pixels tend to 
  362.     dominate the MODE, adjusting the [B]ins will make the distribution 
  363.     more viewable.  Experiment freely with the scaling options; you can 
  364.     always press [R]eset to start over.  TEST.GIF will appear as a 
  365.     "perfect binomial distribution", almost a normal curve, and is a good 
  366.     picture to use in becoming familiar with Histogram Analysis.
  367.  
  368.  
  369.     REGISTRATION
  370.  
  371.  
  372.     BONUS:    Registered users of VGACAD v1.4-1.5, VGA2EGA v1.0, SQZGIF 
  373.               v1.0-v1.2, GIFDOT v1.0-1.3, MAC2GIF v1-2 and/or EGA2VGA 
  374.               v1-3 are registered for GIFPUB.  Copy your REGISTER.OVL 
  375.               file into the directory of GIFPUB and it will operate as a 
  376.               registered version.  IF YOU HAVE NOT REGISTERED ANY OF 
  377.               THESE PROGRAMS, DO SO NOW; when VGACAD v1.60 is released, 
  378.               all new releases will require REGISTER.V16 to operate as a 
  379.               non-shareware version.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     For 19.95 (outside of U.S.A. add USD $15.00) you will be entitled to 
  401.     the latest update of GIFPUB and REGISTER.V16 file (when released).  
  402.     The following programs listed below are provided (latest copy or 
  403.     update) to registered users.  As much as possible, we are 
  404.     reprogramming all utilities to work with ANY video card; programs 
  405.     that, at present, work with ANY video card are: GIFPUB, GIFPUB, 
  406.     EGA2VGA (v2-3), MAC2GIF and SQZGIF.  We intend to modify all 
  407.     utilities to have device-independent graphics capabilities. If you 
  408.     upgrade to VGA, please inform us as soon as possible so that we may 
  409.     send you VGA-dependent releases too.
  410.  
  411.     * Device-independent utilities
  412.  
  413.     GIFDOT - converts 256 color GIFs to B&W images of varying sizes for 
  414.     printing on IBM/Epson compatible printers.  Several print sizes. 
  415.     Variable Brightness/Contrast. Single or Double Pass.  Histograms. 
  416.  
  417.     SQZGIF - converts LARGE GIF pictures (up to 2048x2048x256) to 
  418.     320x200x256 using "color averaging" blend/smooth "jaggies" while 
  419.     retaining maximum color info.
  420.  
  421.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or 
  422.     color and saves results as .GIF or BLD/PLT file, and other formats; 
  423.     graphics are viewable in VGA, MCGA or EGA - no video card is 
  424.     required for direct Black & White conversion to GIF.
  425.  
  426.     EGA2VGA - converts GIFs (16 colors and below) or ANY VIEWABLE 2-16 
  427.     color EGA/EEGA/VGA picture to 320x200x256; creates  256 new colors; 
  428.     outputs load directly to GIFPUB, GIFDOT, and VGACAD.
  429.  
  430.     * Device-dependent utilities/applications
  431.  
  432.     VGA2EGA - conversion utility to convert 256 color pictures to EGA or 
  433.     Extended EGA picture with "35" grey shades or any combination of 
  434.     42,875 COLORS for the BEST possible rendition of 256 color pictures 
  435.     on an EGA/Extended EGA system.
  436.  
  437.     VGACAD - extensive paint/image processing program for VGA/MCGA 
  438.     users;  v1.50 features extensive painting functions, GIF interface, 
  439.     Airbrushes, color and grey image processing functions (smoothing, 
  440.     noise removal, shading, contrast stertching, edge detection, high 
  441.     frequency-boosting, ...), splines, multi-featured Cut&Paste, 
  442.     variable sizing, 256-color gradient fills, 256 color 16x16 pattern 
  443.     fills, and a LOT of other 256-color capabilities.
  444.  
  445.  
  446.     Whats next ?
  447.  
  448.     SYNPCX is utility to convert dithered, monochrome .PCX (Zsoft) files 
  449.     to smooth grey shades.This utility is primarily designed to convert 
  450.     scanned Black & White images, saved to a .PCX file, for use image 
  451.     processing with VGACAD, redithering with GIFPUB, printing with 
  452.     GIFDOT, or EGA conversion with VGA2EGA.  SYNPCX will be graphics 
  453.     device independent (No Video Required).
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     On the longer term, you can expect radical changes in VGACAD.  We 
  467.     are also, developing VGASHW (a 256-color presentation system), 
  468.     VGACBT (the PROGRAMMABLE Computer-Based Training counterpart of 
  469.     VGASHW) AND MANNEQUIN (what "Weird Science" tried to do in the movie 
  470.     it will do on the computer screen with potential applications for 
  471.     Advertising and Fashion Design, aside from creating your own 
  472.     artistic nudes).
  473.  
  474.     If you support maverick authors like us, we will continue to develop 
  475.     innovative products like nothing seen commercially - otherwise they 
  476.     will, as many (sigh!) good Shareware programs, simply "DIE" from 
  477.     lack of support !  Compare the cost/benefit ratio of any of our 
  478.     products with commercial products; we want to continue supporting 
  479.     and developing these products.  Please support the User-Supported  
  480.     (Shareware) concept; you, and you alone, determine whether it will 
  481.     be worthwhile to continue developing.
  482.  
  483.     To register, send in the registration form and check payable to
  484.  
  485.                             Dr. Marvin Gozum
  486.                      2 Independence Place Apt. 303-2
  487.                            6th & Locust Street
  488.                          Philadelphia, PA 19106
  489.  
  490.  
  491.     NEW!      3.5" disk users:  We are now supporting this format.
  492.               If you want your updates in this format, add $10.00.
  493.  
  494.  
  495.  
  496.     ───────────────────────────────────────────────────────
  497.     Graphics Interchange Format and GIF are trademarks (tm)
  498.     of CompuServe Inc. an H&R Block Company. 
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.