home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 007A / GIFGAT21.ZIP / GIFGATE.DOC < prev    next >
Text File  |  1994-07-29  |  15KB  |  354 lines
  1. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  2. ▌                                                                              ▐
  3. ▌                              *>>>  GIFGATE  <<<*                             ▐
  4. ▌                                                                              ▐
  5. ▌                      GIF Picture Tester for BBS Systems                      ▐
  6. ▌                                                                              ▐
  7. ▌                                By Dan Drinnon                                ▐
  8. ▌                                                                              ▐
  9. ▌                                  Ver. 2.1                                    ▐
  10. ▌                                                                              ▐
  11. ▌                 Copyright (c) 1993,1994 Daniel T. Drinnon                    ▐
  12. ▌                                                                              ▐
  13. ▌                             All Right Reserved                               ▐
  14. ▌                                                                              ▐
  15. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  16.  
  17. What is GIFGATE?
  18. ----------------
  19. GIFGATE provides testing of GIF pictures for BBS uploads.  It uses command
  20. line options which allow it to only test a GIF picture for desired properties.
  21. GIFGATE is also capable of wildcard support and can be used offline to test
  22. a group of GIFs as well.  It is written entirely in 'C' and is quite fast.
  23.  
  24. You are FREE to TEST GIFGATE for a period of 1 month.  After which you must
  25. either REGISTER it or cease using it.
  26.  
  27. The cost for registration is very CHEAP - $10.00 and well worth it.
  28.  
  29. GIFGATE is NOT crippled in it's unregistered form.  All features are enabled,
  30. with the exception of 'quiet' mode.  'Quiet' mode is always disabled to
  31. remind you that you have to register.  There is no size limit or any other
  32. limitations which will make GIFGATE not test a GIF.
  33.  
  34.  
  35. FILES:
  36. ------
  37. REGISTER DOC  -  GIFGATE REGISTRATION FORM
  38. GIFGATE  DOC  -  This Documentation
  39. TGIF     BAT  -  Sample BBS Batch File
  40. RELAX    BAT  -  Sample BBS Batch File
  41. GIFGATE  EXE  -  Generic GIFGATE program
  42. GIFGATE  286  -  286+ GIFGATE program
  43.  
  44. (rename GIFGATE.286 to GIFGATE.EXE to use GIFGATE on a 286 or higher)
  45.  
  46.  
  47. ADDITIONAL FILES YOU WILL/MAY NEED:
  48. -----------------------------------
  49. PROECHO  COM  -  Or any BBS utility which will echo a message out the COM
  50.                  port during GIF testing.  Available at the Cellar Door
  51.                  as P-T-Z.ZIP
  52.  
  53.  
  54.  
  55. IMPLEMENTATION:
  56. ---------------
  57. There is no config file for GIFGATE.  All options are specified on the
  58. command line.  GIFGATE's command line syntax is:
  59.  
  60.              GIFGATE filename [option] [option]...
  61.  
  62.          ex: GIFGATE PICTURE.GIF /w800 /h600 /c256 /t /g /lGIFGATE.LOG
  63.  
  64. By typing GIFGATE by itself at the DOS prompt, you can review all of GIFGATE's
  65. options.
  66.  
  67. The filename may be any valid DOS file name with path if needed.  Wildcards
  68. are ok, however, with wildcard testing of GIFs, no ERRORLEVEL exit of GIFGATE
  69. will occur as more than one GIF is being tested.
  70.  
  71. There are several OPTIONS available.  Options may be in any order and must 
  72. always be prefixed with a "/", then the option letter, and finally the option 
  73. value to test for (if required).  An option must be separated from another 
  74. option by a space.  (see example above)
  75.  
  76. GIFGATE's Options Are:
  77.  
  78.     /wxxx   -  minimum WIDTH to Pass     ex:  /w800
  79.     /hxxx   -  minimum HEIGHT to Pass    ex:  /h600
  80.     /cxxx   -  minimum COLORS to Pass    ex:  /c256
  81.     /yxxxx  -  earliest YEAR to Pass     ex:  /y1993 -or- /y93
  82.     /sxxx   -  minimum BYTES to Pass     ex:  /s100000
  83.     /g      -  Do not Pass GIFLite'd GIFS
  84.  
  85. All the above options are 'limiting' options.  If you do not want to test a
  86. GIF for any of the above, do not include the option in the command line.
  87.  
  88.     /t      -  Trim off excess bytes from padded protocols transfers
  89.     /lNAME  -  Log all activity to filename  ex: /lGIFGATE.LOG
  90.     /q      -  Quiet mode - display only program/input errors
  91.     /r      -  Relaxed Errorlevel Exits
  92.     /m      -  mono mode - turns off the color display while GifGate runs
  93.     /i      -  suppress integrity checking - test only the baics of a GIF
  94.  
  95. Indepth Description of GIFGATE's Options:
  96. -----------------------------------------
  97.     /w   Minimum Width - This is the minimum width to allow GIFGATE to Pass.
  98.          For clarity, if you specify /w800, that means do NOT pass a GIF that
  99.          is 799 pixels wide, but DO pass a GIF that is 800 pixels wide.
  100.  
  101.     /h   Minimum Height - This is the minimum height to allow GIFGATE to Pass.
  102.          For clarity, if you specify /h600, that means do NOT pass a GIF that
  103.          is 599 pixels in height, but DO pass a GIF that is 600 pixels wide.
  104.  
  105.     /c   Minimum Colors - This is the minimum amount of colors to allow
  106.          GIFGATE to pass.  For clarity, if you specify /c256, that means do
  107.          NOT pass a GIF with 255 colors, but DO pass a GIF with 256 colors.
  108.  
  109.     /y   Minimum Year - This tells GIFGATE to pass a GIF only if it is dated
  110.          the year you specified or later.  Note that a GIF upload via a
  111.          'dumb' protocol such as X-Modem will have the current date for the
  112.          year - this option is only effective when the GIF that has been
  113.          uploaded was uploaded with a protocol which keeps the file intact,
  114.          such as ZModem.
  115.  
  116.     /s   Minimum Size - This is the minimum size to allow GIFGATE to Pass.
  117.          For clarity, if you specify /s100000, that means do NOT pass a GIF
  118.          that is 99999 bytes in size, but DO pass a GIF that is 100000 bytes
  119.          in size.  Note that the size must always be in bytes.
  120.  
  121.     /g   Check for GIFLite'd GIFs.  If a GIFLite'd GIF is found, then GIFGATE
  122.          will not pass the GIF.
  123.  
  124.     /t   Trim - This option allows GIFGATE to trim off excess bytes which
  125.          usually are attached to the end of any file by an X-Modem type
  126.          protocol transfer.  Note that if the GIF to test is padded and the
  127.          /t option is selected, the GIF's archive bit will be set high.
  128.          * A "trimmed" GIF will NOT cause a fail!
  129.  
  130.     /q   Quiet Mode - This forces GIFGATE to only print to the screen any
  131.          program or input errors.  All testing activity is suppressed from
  132.          the screen.  This option is disabled in the UNREGISTERED version!
  133.  
  134.     /r   Relaxed Mode - This tells GIFGATE to use 'relaxed' ERRORLEVEL exits.
  135.          Please see heading on ERRORLEVEL Exits for detailed information.
  136.  
  137.     /m   Mono Mode - GifGate defaults to using color for display of what it
  138.          is doing.  If you do not want color, add /m to turn color off.
  139.  
  140.     /i   Suppressed Integrity Checking - GifGate defaults to do an entire
  141.          GIF test on a GIF file.  When the /i option is used, GifGate will
  142.          not read through the entire GIF file looking for other errors such
  143.          as an unexpected end of file or other integrity errors.
  144.  
  145.     /l   Log - This option enables GIFGATE to log it's test results to a
  146.          log file of your choice.  If the log file does not exist, GIFGATE
  147.          will create it.  If the log file does exist, GIFGATE will APPEND to
  148.          it.
  149.  
  150.          GIFGATE's Log file format is as follows:
  151.  
  152.          FILENAME         SIZE      DATE     X    Y  CLR  FAIL-FLAGS
  153.          ------------------------------------------------------------
  154.  
  155.          FILENAME    = name of GIF tested
  156.          SIZE        = true size of GIF
  157.          DATE        = date of GIF
  158.          X           = width of GIF
  159.          Y           = height of GIF
  160.          CLR         = colors in GIF
  161.          FAIL-FLAGS  = What GIF may have Failed for:
  162.                             - W = failed /w
  163.                             - H = failed /h
  164.                             - C = failed /c
  165.                             - S = failed /s
  166.                             - Y = failed /y
  167.                             - G = failed /g
  168.