home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / graphics / gif2jpg2 / gif2jpg.doc next >
Encoding:
Text File  |  1995-05-19  |  15.6 KB  |  447 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 GIF2JPG and JPG2GIF
  12.  
  13.                                     Version 2.0
  14.  
  15.  
  16.                                   October 30, 1992
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                               Handmade Software, Inc.
  46.                           15951 Los Gatos Blvd., Suite 17
  47.                                 Los Gatos, CA  95032
  48.  
  49.                                 +1 408 358 1292 tel
  50.                                 +1 408 358 2694 fax
  51.                                 +1 408 356 3297 bbs
  52.  
  53.  
  54.                              internet:  hsi@netcom.com
  55.                               compuserve:  71330,3136
  56.  
  57.  
  58.                               Copyright (c) 1990-1992
  59.                                 All Rights Reserved
  60.  
  61.  
  62.  
  63.                                     Introduction
  64.  
  65.  
  66.            JPG2GIF and GIF2JPG are a set of programs which convert GIF
  67.            files to JPEG files and JPEG files back to GIF files.
  68.  
  69.            Why would you want to do this?
  70.  
  71.            Because JPEG files are typically smaller than GIF files.  So,
  72.            by converting images from GIF to JPEG you save on modeming
  73.            time, long distance charges, and disk storage requirements.
  74.            The disadvantage is that most viewers are designed for GIF
  75.            files, and so your JPEG files must be converted back to GIF
  76.            for viewing.
  77.  
  78.  
  79.  
  80.  
  81.                                Hardware Requirements
  82.  
  83.  
  84.            An IBM PC/AT or clone with an 80286 or better processor.
  85.  
  86.            A hard drive (JPG2GIF needs to open temporary files while
  87.            processing; you must have at least 3 times as much disk space
  88.            available as the largest image you are converting.  For
  89.            example, a 640 by 480 file requires 1 Megabyte of free space).
  90.  
  91.            MS-DOS or PC-DOS 3.1 or later.
  92.  
  93.            380K of available RAM.
  94.  
  95.  
  96.  
  97.  
  98.                                 The Freeware Concept
  99.  
  100.  
  101.            GIF2JPG and JPG2GIF are freeware programs.  Please feel free
  102.            to distribute them by giving copies to your friends, uploading
  103.            them to bulletin boards, and trading them at user clubs.  You
  104.            must distribute them unaltered, and as a set, including this
  105.            document.  You may not sell these files for more than a $7.00
  106.            media duplication cost.
  107.  
  108.            Although GIF2JPG and JPG2GIF used to be shareware programs,
  109.            they are now freeware.  You may use them as much as you like,
  110.            for as long as you like; there is no registration fee.  It is
  111.            important to note that these programs are still copyrighted,
  112.            and not in the public domain.  As such, they cannot be sold
  113.            for profit, and may not be used in or disributed as part of
  114.            any freeware, shareware, or commercial software without the
  115.            prior written consent of Handmade Software, Inc.
  116.  
  117.  
  118.  
  119.                               Using GIF2JPG & JPG2GIF
  120.  
  121.            To convert .GIF files to .JPG files:
  122.  
  123.                 GIF2JPG [options] [files...]
  124.  
  125.            If any .JPG files with the same name already exist you will be
  126.            asked whether to overwrite them.  If any GIF89A files are
  127.            encountered you will be asked whether or not to convert them.
  128.            GIF89A files are not automatically converted since they can
  129.            contain text and multiple images; this information will be
  130.            lost when the image is converted to a JPEG file.
  131.  
  132.  
  133.            To convert .JPG files to .GIF files:
  134.  
  135.                 JPG2GIF [options] [files...]
  136.  
  137.            If any .GIF files already exist you will be asked whether or
  138.            not to overwrite them.
  139.  
  140.  
  141.            There are three options which are common to both programs:
  142.  
  143.                 -a:  automatically proceeds (overwriting any existing
  144.                      files and converting GIF89A files).
  145.  
  146.                 -h:  display the help screen
  147.  
  148.                 -k:  kill (delete) the original files after they are
  149.                      processed.
  150.  
  151.            The GIF2JPG program has two additional options:
  152.  
  153.                 -q[n]:  specify the JPEG quality factor which will be
  154.                         used when compressing GIF files.
  155.  
  156.                         The default is 55.
  157.  
  158.                         A lower number will result in a higher
  159.                         compression ratio, but a lower quality image.
  160.                         Specifying a very low quality factor (less than
  161.                         15) will result in poor quality images.
  162.  
  163.                 -s:     write an HSI JPEG file (not compatible with the
  164.                         JFIF standard).
  165.  
  166.                         HSI JPEG files typically give better compression,
  167.                         especially with images containing lots of
  168.                         continuous-colour, but can only be read by
  169.                         Handmade Software, Inc. products.
  170.  
  171.            Note that you may specify wild cards as part of the file name
  172.            and that multiple file names may be specified.
  173.  
  174.  
  175.  
  176.            Examples:
  177.  
  178.                 GIF2JPG -q30 *.gif
  179.  
  180.            Will convert all .GIF files in the current directory to .JPG
  181.            files, using a quality factor of 30.
  182.  
  183.                 JPG2GIF -k -a test.jpg madonna.jpg n?.jpg
  184.  
  185.            Will convert the specified files back to .GIF files, deleting
  186.            the .JPG files and automatically overwriting the existing GIF
  187.            files.
  188.  
  189.  
  190.                                  Temporary Storage
  191.  
  192.            GIF2JPG and JPG2GIF create temporary files on your hard drive
  193.            when performing various conversions.  These temporary files
  194.            are normally placed in the current directory.  To force the
  195.            creation of these files in a different directory, or different
  196.            drive, you can set the environment variable TMP to the desired
  197.            location.
  198.  
  199.            To set the temporary directory to C:\TEMP, you would type
  200.  
  201.                 C:\>set TMP=c:\temp
  202.  
  203.            at the DOS prompt.
  204.  
  205.            If you interrupt GIF2JPG or JPG2GIF or it aborts with an
  206.            error, it is possible that the temporary files might not be
  207.            deleted.  The files have the name TMPxxxxx.
  208.  
  209.  
  210.                                    Image Quality
  211.  
  212.            JPEG compression works best on images which are continuous
  213.            tone images, such as those produced by a scanner or digitizer.
  214.            Images which are drawn with paint programs typically do not
  215.            JPEG compress very well.
  216.  
  217.            In addition, the best quality JPEG images result when you
  218.            start with 24 bit, undithered images.  Unfortunately GIF does
  219.            not support 24 bit images, and most of the 8 bit GIF images
  220.            are dithered.  So, if you are using a scanner or digitizer to
  221.            produce images, you can get better compression ratios, and
  222.            better quality images, if you generate 24 bit Targa or TIFF
  223.            files and then convert them to JPEG files.  You can't do this
  224.            with GIF2JPG, but you can with another Handmade product, Image
  225.            Alchemy.  See the blatant ad below.
  226.  
  227.  
  228.  
  229.                       Answers to Frequently Asked Questions:
  230.  
  231.  
  232.            Q:   How do you pronounce JPG?
  233.  
  234.            A:   Jay-peg.  JPG is short for JPEG, which is short for Joint
  235.                 Photographic Experts Group.  Note that we use JPEG and
  236.                 JPG to mean the same thing;  JPG only exists because PC
  237.                 file names are restricted to having a three letter
  238.                 extension.
  239.  
  240.                 By the way, we firmly believe that GIF should be
  241.                 pronounced with a hard G like the word gift.  The primary
  242.                 justification for this is that GIF stands for Graphics
  243.                 Interchange Format, and the word Graphics starts with a
  244.                 hard G.  So if you call us up for technical support don't
  245.                 be surprised if we say GIF (with a hard G).
  246.  
  247.  
  248.            Q:   So what exactly is JPEG?
  249.  
  250.            A:   JPEG is a lossy image file compression standard.  It is
  251.                 lossy because the files you get out are not quite the
  252.                 same as the files you put in.  JPEG compression achieves
  253.                 much higher compression ratios this way.  Most of the
  254.                 time the changes to the image are not noticeable.  The -q
  255.                 option allows you to control the amount of loss (and the
  256.                 compression ratios) of the images.
  257.  
  258.                 If you would like more information on the JPEG standard
  259.                 please contact:
  260.  
  261.                 ANSI
  262.                 11 West 42nd Street
  263.                 New York, NY  10036
  264.                 +1 212 642 4900
  265.  
  266.  
  267.            Q:   Are GIF2JPG .JPG files compatible with anything else?
  268.  
  269.            A:   Those files which are written without using the -s option
  270.                 are compatible with the JPEG File Interchange Format
  271.                 standard (JFIF, pronounced Jay-fif).  JFIF software is
  272.                 available from a wide variety of software and hardware
  273.                 vendors.  Files written out with the -s option are a
  274.                 custom format specific to Handmade Software.
  275.  
  276.  
  277.  
  278.            Q:   Why can't I view a JPG file directly?
  279.  
  280.            A:   JPEG files are always 24 bit images, which can't be
  281.                 viewed directly on standard VGA boards.  If you happen to
  282.                 have a 24 bit SVGA (such as the ATI XL24, Orchid
  283.                 Fahrenheit 24 bit 1280, Genoa 7900, etc.) and the
  284.                 software you are using to view it can deal with 24 bit
  285.                 files and video cards, it is possible to view JPEG
  286.                 images.  Any of the above mentioned boards along with
  287.                 Image Alchemy, for instance, will allow you to view 24
  288.                 bit JPEG images.
  289.  
  290.                 It is possible to convert a 24 bit image for display on
  291.                 an 8 bit display; that is after all what JPG2GIF does
  292.                 when it converts to a GIF file, but it is slow compared
  293.                 to viewing 24 bit images directly.
  294.  
  295.  
  296.            Q:   What is planned for future releases of GIF2JPG?
  297.  
  298.            A:   This is the final release of GIF2JPG.  All the features
  299.                 of GIF2JPG and JPG2GIF have been embodied in our other
  300.                 software, Image Alchemy.  Version 2.0 fixes all known
  301.                 bugs that v1.5 contained, and has added some new
  302.                 functionality; hence, this will be the last release of
  303.                 this software.
  304.  
  305.                 Image Alchemy, along with doing the GIF and JPEG
  306.                 conversions, can deal with over 50 different file
  307.                 formats.  See the blatant ad for Image Alchemy below.
  308.  
  309.  
  310.  
  311.                                   Change History:
  312.  
  313.  
  314.                                    v2.0  10/30/92
  315.  
  316.            GIF2JPG writes out JFIF compatible JPEG files by default now,
  317.            rather than HSI JPEG files.
  318.  
  319.            Added revision number and file creation date/time stamp to HSI
  320.            JPEG files.
  321.  
  322.            Retain file creation date/time stamp in GIF files if present
  323.            in the JPEG file.
  324.  
  325.            Eliminated JFIF marker from HSI JPEG files.
  326.  
  327.            Fixed numerous bugs having to do with accessing drives and
  328.            subdirectories other than the current one.
  329.  
  330.            Added MacBinary support.
  331.  
  332.                                    v1.5  05/13/91
  333.  
  334.            Changed .JPG file format to solve problem which caused some
  335.            .GIF files to grow when being converted back from .JPG files.
  336.  
  337.            Added support for reading interleaved GIFs.
  338.  
  339.            The background colour of GIFs is now set to the darkest colour
  340.            in the palette.
  341.  
  342.                                   v1.41  04/24/91
  343.  
  344.            Fixed bug in JPG2GIF which caused some colours to be wrong in
  345.            certain images.
  346.  
  347.                                    v1.4  04/22/91
  348.  
  349.            Added -q option.
  350.  
  351.            Speeded up conversion.
  352.  
  353.                                    v1.3  04/18/91
  354.  
  355.            Changed error messages, prompts, and examples.
  356.  
  357.                                    v1.2  03/15/91
  358.  
  359.            Added JFIF support.
  360.  
  361.                                    v1.1  03/06/91
  362.  
  363.            First release.
  364.  
  365.  
  366.  
  367.                             Blatant Ad for Image Alchemy
  368.  
  369.  
  370.            If your interest in image files extends beyond GIF and JPEG
  371.            you might be interested in Image Alchemy.
  372.  
  373.            In addition to converting between GIF and JPEG, Alchemy
  374.            supports over 50 different image file formats, including TIFF,
  375.            Targa, PCX, Sun Raster, IFF/ILBM, PBM, and Encapsulated
  376.            Postscript.
  377.  
  378.            Alchemy also allows you to scale an image to a specific size
  379.            or by a given factor, preserving the aspect ratio if desired.
  380.            This can be done with one of four different scaling
  381.            algorithms, ranging from fast and simple to somewhat slower
  382.            but more sophisticated.
  383.  
  384.            When reducing the number of colours in an image, Alchemy will
  385.            dither the result using one of seven different dithering
  386.            algorithms.  This gives the impression of a greater number of
  387.            colours than actually exist in the image.
  388.  
  389.            Finally, the MS-DOS version of Alchemy supports viewing on
  390.            SVGA equipped systems, all the way up to full 24-bit true
  391.            colour viewing.  If your system does not support this mode,
  392.            Alchemy will dither the image on the fly and display it at the
  393.            highest possible resolution.
  394.  
  395.            Alchemy also gives you complete control over the palette used
  396.            for a given image, allowing you to false colour an image,
  397.            match palettes, or extract palettes for custom modification.
  398.  
  399.            If you would like a demo version of Image Alchemy or more
  400.            technical information about its capabilities, please contact
  401.            us; we will be more than happy to send you a copy of the demo
  402.            and answer your questions.
  403.  
  404.  
  405.  
  406.                                   Bugs and Support
  407.  
  408.  
  409.            If you have a question or think you found a bug in GIF2JPG or
  410.            JPG2GIF please contact us.  Despite the fact that this is the
  411.            final planned release, we would like to know of any problems
  412.            with the software.  We prefer to be reached by email at the
  413.            addresses listed on the front page of this manual.  You may
  414.            also fax or call us during normal business hours (we are on
  415.            the West Coast).  Additionally, we have a bulletin board
  416.            system running 24-hours a day.
  417.  
  418.  
  419.  
  420.  
  421.                                      Trademarks
  422.  
  423.  
  424.            GIF2JPG, JPG2GIF, and Image Alchemy are trademarks of Handmade
  425.            Software, Inc.
  426.  
  427.            All other products or services mentioned are trademarks,
  428.            registered trademarks, or service marks of their respective
  429.            companies or organizations.
  430.  
  431.  
  432.  
  433.  
  434.                                      Disclaimer
  435.  
  436.  
  437.            Handmade Software, Inc. makes no warranty of any kind, either
  438.            expressed or implied, including but not limited to implied
  439.            warranties of merchantability and fitness for a particular
  440.            purpose.
  441.  
  442.            In no event shall Handmade Software, Inc. be liable for any
  443.            errors contained herein or for incidental or consequential
  444.            damages in connection with the furnishing, performance, or use
  445.            of the GIF2JPG or JPG2GIF products or documentation.
  446.  
  447.