home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / gdscrp10.zip / GIFDSCRP.DOC < prev    next >
Text File  |  1991-03-29  |  7KB  |  151 lines
  1.  
  2.  
  3.  
  4.  
  5.                     Welcome to GIF Descriptor V1.0(3/29/91)
  6.                                 by Rollin White
  7.  
  8.  
  9.         INTRODUCTION
  10.  
  11.             GIF Descriptor is a pair of utilities that reads and writes
  12.         descriptions of your .GIF files.  Adding descriptions using
  13.         GIFWRITE does not interfere with the image itself and completely
  14.         complies with the Compuserve GIF 89a and 87a specification.
  15.         These utilities are useful under many circumstances.  First,
  16.         when uploading a file, no longer to you have to shell to your
  17.         viewer and bring up the GIF to remember exactly what the GIF is,
  18.         the description is more easily available.  Second when searching
  19.         through your collection, it is much easier to find that picture
  20.         you are looking for when you have descriptions to read instead
  21.         of just filenames.  This is especially helpful if you have 100's
  22.         or 1000's of GIFs(like D.D.).  Let's face it 8 characters is not
  23.         a lot of space to describe a picture.
  24.  
  25.         HOW TO USE THE GIF DESCRIPTOR UTILITIES
  26.  
  27.             There are two programs that make up the GIF Descriptor
  28.         utilities GW and GD which stand for GIFWRITE and GIF DIR
  29.         respectively.  The process begins by running GW which adds the
  30.         actual comments to the file.  Then GD allows you to have
  31.         directory of your GIFs including their comments.  A detailed
  32.         description of each utility follows.
  33.  
  34.         GW(GIFWRITE)
  35.  
  36.             To start GW use the following command line syntax:
  37.  
  38.         GW <d:\path\filespec>
  39.  
  40.             Where d is stands for any valid drive, path is any valid
  41.         path, and filespec is either a valid file or a valid set of
  42.         wildcards.  An example is:
  43.  
  44.         GW e:\gifs\*.*
  45.  
  46.             Drive letter and path are optional, but you must include a
  47.         filespec whether it involves wildcards or is and exact file
  48.         name.
  49.  
  50.             Once GW finds a file it takes one of two courses of action.
  51.         If the file is not a GIF file it lists the name and tells you
  52.         that it is not a GIF file.  This might be the scenario if you
  53.         were to use the "*.*" filespec.
  54.  
  55.             If the file is a valid GIF file, GW informs you of the file
  56.         name and its current description.  If the file has no
  57.         description or if GW has not been run on the file before GW will
  58.         provide a description of "No description given".  You will then
  59.         be prompted to enter your new description of thirty characters
  60.         or less.  You also have the option of pressing enter which leave
  61.         the current description unchanged.  An example is given below:
  62.  
  63.         The current description for CAT85.GIF is:No description given
  64.         Enter your new description or press Enter for no change.
  65.                                      <-30 limit of 30 characters or less
  66.  
  67.             As you can see everything is pretty straight forward.  This
  68.         process will continue for every file that qualifies under
  69.         filespec.
  70.  
  71.  
  72.         GD(GIF DIR)
  73.  
  74.             GD provides a directory of files including name, size,
  75.         dimensions, and description.  The command line syntax for GD is:
  76.  
  77.         GD <d:\path\filespec>
  78.  
  79.         Where d represents drive letter, path represents any valid path,
  80.         and filespec represents and valid DOS filespec.  If no
  81.         parameters are given, GD will use the current directory.  If the
  82.         number of files requires more space than is available on the
  83.         screen, GD will pause with a "--more--" prompt waiting for any
  84.         key to be pressed.
  85.  
  86.         REGISTRATION
  87.  
  88.             Well if you've read this far you must be interested in the
  89.         program.  I originally intended for all of my programs to be
  90.         free or to collect money for charity, but things have changed
  91.         since I came up with that idea.  Recently the Governor of
  92.         California decided that the UC system would have to take a 20%
  93.         increase in students' fees would be necessary to help balance
  94.         the state's budget.  Even worse, the UC Regents, the body of
  95.         wealthy businessmen who are responsible for running the UC
  96.         system decided that a 40% increase in student's fees would be
  97.         needed to balance their budget.  As a result my financial
  98.         situation is looking grim.  As a result I have decided that a
  99.         $10 registration fee would be in order. This money will be for
  100.         the sole purpose of paying my tuition.  The benefits of
  101.         registering include free upgrades for one year.  If you decide
  102.         to register, please fill out the form in the file REGISTER.TXT
  103.         and mail it to the address below.
  104.  
  105.         COMMENTS
  106.  
  107.             All comments and criticisms are appreciated.  What can I do
  108.         to make this better?  Do you have ideas for other programs?  I
  109.         WANT TO KNOW!  I can be reached my mail at the address below or
  110.         at the KANDY SHACK BBS at (714)-636-2667.
  111.  
  112.         Please send all registration and comments to:
  113.  
  114.                                 Rollin White
  115.                                 20222 Windcave Ln.
  116.                                 Huntington Beach, Ca. 92646-5341.
  117.  
  118.         Thank you for your support and comments.
  119.  
  120.         Graphic Interchange Format(GIF) is a registered trademark of
  121.         Compuserve Inc.
  122.  
  123.  
  124.  
  125.                                     WARRANTY
  126.  
  127.  
  128.         THIS  SOFTWARE PROGRAM  AND DOCUMENTATION IS  BEING OFFERED FOR
  129.         EVALUATION PURPOSES "AS IS" AND WITHOUT WARRANTIES AS
  130.         TO PERFORMANCE.  BY USING THIS SET OF PROGRAMS YOU ARE EXPRESSLY
  131.         RELEASING THE AUTHOR FROM ANY LIABILITY RESULTING
  132.         FROM THE USE OF THIS SOFTWARE AND DOCUMENTATION.  THE USER MUST
  133.         ASSUME THE ENTIRE RISK OF USING THIS SOFTWARE.
  134.  
  135.  
  136.  
  137.                                LICENSE AGREEMENT
  138.  
  139.         1.  These programs(GW and GD) are being distributed as
  140.         Shareware.  You may evaluate tehm for a period of 21 days.
  141.         After that, if you continue to use them you must register them
  142.         by filling out the form REGISTER.TXT.
  143.  
  144.         2.  You may make as many copies as you'd like for personal use.
  145.         You may also freely distribute them to other BBSs and your
  146.         friends.
  147.  
  148.         3.  You may NOT receive compensation, monetary or otherwise for
  149.         distributing this software including the cost of storage
  150.         medium(disks).
  151.