home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / GRAFIK / TOOLS / GIFS / GIFS.DOC next >
Text File  |  1993-12-01  |  9KB  |  215 lines
  1. GIFs v1.3 - .GIF File Cataloger                                         03/91
  2. *FreeWare* P.C.Stapleton            (CIS 72421,1753 - tho' I NEVER read mail)
  3. ------------------------------------------------------------------------------
  4.  
  5. WHY:
  6. ----
  7. I've become a true BBS fanatic and .GIF (thank you CompuServe) collector. The
  8. number of files, their disk space, resolution, colors, version, etc. presented
  9. a formidable task for tracking and maintaining backups. I'm sorry to say that
  10. none of the .GIF cataloging programs I've found completely satisfied me. So I
  11. wrote GIFs to get the detail I wanted without all the cumbersome aspects of a
  12. (dare I say it?) database.
  13.  
  14. Also, were it not for the EXCELLENT code by the true gurus (Bob Montgomery
  15. [VPIC], John Bridges [PICEM], Jay Wherley [GifDesk], et al) I wouldn't have
  16. this problem because I wouldn't put up with the hassle of collecting!
  17.  
  18.  
  19. OUTPUT:
  20. -------
  21. GIFs, by default, generates 2 output files:
  22.     GIFS.SUM - contains the stats on where the .GIFs are and how much
  23.            disk space they consume
  24.     GIFS.OUT - contains the detail on each .GIF, including the size,
  25.            image resolution, colors, GIF version and the path. I
  26.            use a good editor to strip the path out of the report
  27.            in order to perform certain maintenance functions.
  28.  
  29. Optionally, you can direct GIFs to substitute a named batch file for output,
  30. in lieu of GIFS.OUT. This is useful for dumping subsets of .GIFs off to a
  31. floppy, moving files to new directories, or deleting (use with care!).
  32.  
  33.  
  34. ------------------------------------------------------------------------------
  35. Notes:
  36. 1.    I have NOT determined whether GIFs works correctly with network drives.
  37.       I have access to one at work, but there are NO .GIF files stored on the
  38.       servers! System administrators can be so dull and limited in outlook!
  39.  
  40. 2.    All output files contain only `vanilla' ASCII characters in the 0-127
  41.       range. Prettier output (using line-drawing characters, etc.) would cause
  42.       problems for some uses.
  43.  
  44. 3.    GIFs echos some summary statistics to the screen during scanning so you
  45.       know it's working and not just eating your disks.
  46.  
  47. 4.    GIFS.EXE is compressed using Fabrice Bellard's excellent LZEXE v.91.
  48. ------------------------------------------------------------------------------
  49.  
  50.  
  51. TOMORROW? (or MORE ABUSE?)
  52. --------------------------
  53. I've also written a little parser to read the GIFS.OUT file and compare it to
  54. a BBS Log file (or formal file list) and generate a list of the first 1000
  55. .GIFs that THEY have that I don't! Greedy huh? Well, I DO pay  BBS membership
  56. fees instead of doing the ratio thing. Anyway, this gives me a simple list to
  57. use for tagging the downloads I want to make. If can I make it generic and
  58. smart enough, and anyone shows a desire to have it, I'll probably upload it
  59. for others to use as well.
  60.  
  61. I hope you enjoy using GIFs!
  62. ------------------------------------------------------------------------------
  63.  
  64.  
  65. GETTING HELP:
  66. -------------
  67. Run GIFs with `/h' `-h' `-?' `/?' or `help' as command-line and the
  68. following help screen is displayed:
  69.  
  70. =============================================================================
  71. GIFs v1.3 - .GIF File Cataloger
  72. Searches ALL `DOS ready' Drives (ie. A: - LastDrive) - SKIPS `Not Ready' drives
  73. Generates 2 Files: GIFS.SUM and either GIFS.OUT or specified [batfile]
  74.  
  75. Syntax:   GIFS [driveletter],[filemask],[batfile]
  76. Options are positional (commas required) for filemask and/or batfile.
  77.  
  78. where:    drive    option directs GIFs to search ONLY that drive
  79.       filemask option which directs GIFs to limit the .GIF files
  80.            found to those matching the filemask.  Uses DOS
  81.            wildcard conventions. GIFs forces .GIF extent.
  82.       batfile  option which directs output to the named file.
  83.            GIFs forces .BAT as the file extent.
  84.            Output format: `%1 <path><GifFile.GIF> %2 %3 %4 %5'
  85.            (usage:  `batfile copy a:'   would perform a DOS Copy
  86.            of the .GIF files named in batfile to the A: drive.)
  87.  
  88.  Defaults: drive    - search ALL `ready' disk drives (includes floppies)
  89.        filemask - *           [ALWAYS uses .GIF extent]
  90.        output   - GIFS.OUT    [Detail Report - if batfile not specified]
  91.               GIFS.SUM    [Summary Report of Drive & Directory Stats]
  92. =============================================================================
  93.  
  94.  
  95.  
  96. Example Output:
  97. ---------------
  98.  
  99. *****************************************************************************
  100. Example 1        `GIFS'           (without parameters to scan ALL drives)
  101. *****************************************************************************
  102.  
  103. GIFS.SUM:
  104.  
  105. ================================== GIFs v1.3 ==================================
  106. | 03-24-91 | 11:38:46 | ALL Drives   | *.GIF        | GIFS.OUT     | GIFS.SUM |
  107. ===============================================================================
  108.  GIFs     Space     Path
  109. -----  -----------  -----------------------------------------------------------
  110.     1      140,124  F:\CAD
  111.    12    1,985,342  F:\GIF
  112.     1        2,688  F:\CODE
  113.     2          596  G:\WINDOWS
  114.    89   15,593,985  H:\DATASHAK
  115.    40    7,180,628  H:\GRAFEXCH
  116.    10    2,245,809  H:\PRIZM
  117.    29    3,167,898  H:\SOSO
  118.   242   41,203,442  H:\SVGA
  119.    20    4,108,171  H:\SVGANEW
  120.   186    7,556,482  H:\VGA
  121. ===============================================================================
  122.    14    2,128,154  Totals for Drive F:
  123.     2          596  Totals for Drive G:
  124.   616   81,056,415  Totals for Drive H:
  125. ===============================================================================
  126.   632   83,185,165  Totals for Scanned Drives
  127. ===============================================================================
  128.  
  129.  
  130. GIFS.OUT:
  131.  
  132. ================================== GIFs v1.3 ==================================
  133. | 03-24-91 | 11:38:46 | ALL Drives   | *.GIF        | GIFS.OUT     | GIFS.SUM |
  134. ===============================================================================
  135.           Image    Col  Gif
  136. GIF Name   Size  Resolutn  Res  Ver  Path
  137. --------  -----  --------  ---  ---  ------------------------------------------
  138. SCREEN00   140k   640x480  256  87a  F:\CAD
  139. 386CHIP    226k   800x600  256  87a  F:\GIF
  140. BOLAE      183k   640x440  256  87a  F:\GIF
  141. BV0003     105k   640x480  256  87a  F:\GIF
  142. DSKYLINE   180k   640x480  256  87a  F:\GIF
  143. HUNTRESS    46k   640x440  128  87a  F:\GIF
  144. MCE008      82k   640x480   64  87a  F:\GIF
  145. MCE013     204k   640x480   64  87a  F:\GIF
  146. MCE016     224k   640x480  256  87a  F:\GIF
  147. MCE022     249k   640x480  256  87a  F:\GIF
  148. MCE024     268k   640x480  256  87a  F:\GIF
  149. MCE028     149k   640x480  256  87a  F:\GIF
  150. MT14        69k   640x480  256  87a  F:\GIF
  151. 89AILL       3k   640x480   16  89a  F:\CODE
  152.  
  153. PALETTE      0k    32x 32   16  87a  G:\WINDOWS         (note that these 2
  154. SAMPLE       0k    32x 32   16  87a  G:\WINDOWS          .GIFs are < 1k each)
  155.  
  156. etc...
  157.  
  158.  
  159. *****************************************************************************
  160. Example 2        `GIFS f,,sample'       (scan F: and write to sample.bat)
  161. *****************************************************************************
  162.  
  163. SAMPLE.BAT:
  164.  
  165. REM     *** GIFs Batch Output ***     GIFs v1.3   03-24-91  @  11:42:24
  166. REM
  167. %1 F:\CAD\SCREEN00.GIF %2 %3 %4 %5
  168. %1 F:\GIF\386CHIP.GIF %2 %3 %4 %5
  169. %1 F:\GIF\BOLAE.GIF %2 %3 %4 %5
  170. %1 F:\GIF\BV0003.GIF %2 %3 %4 %5
  171. %1 F:\GIF\DSKYLINE.GIF %2 %3 %4 %5
  172. %1 F:\GIF\HUNTRESS.GIF %2 %3 %4 %5
  173. %1 F:\GIF\MCE008.GIF %2 %3 %4 %5
  174. %1 F:\GIF\MCE013.GIF %2 %3 %4 %5
  175. %1 F:\GIF\MCE016.GIF %2 %3 %4 %5
  176. %1 F:\GIF\MCE022.GIF %2 %3 %4 %5
  177. %1 F:\GIF\MCE024.GIF %2 %3 %4 %5
  178. %1 F:\GIF\MCE028.GIF %2 %3 %4 %5
  179. %1 F:\GIF\MT14.GIF %2 %3 %4 %5
  180. %1 F:\CODE\89AILL.GIF %2 %3 %4 %5
  181.  
  182.  
  183. *****************************************************************************
  184. Example 3       `GIFS f,MCE*'           (scan f: for MCE?????.GIF files)
  185. *****************************************************************************
  186.  
  187. GIFS.SUM:
  188.  
  189. ================================== GIFs v1.3 ==================================
  190. | 03-24-91 | 11:43:43 | ONLY Drive F | MCE*.GIF     | GIFS.OUT     | GIFS.SUM |
  191. ===============================================================================
  192.  GIFs     Space     Path
  193. -----  -----------  -----------------------------------------------------------
  194.     6    1,175,273  F:\GIF
  195. ===============================================================================
  196.     6    1,175,273  Totals for Drive F:
  197. ===============================================================================
  198.  
  199.  
  200. GIFS.OUT:
  201.  
  202. ================================== GIFs v1.3 ==================================
  203. | 03-24-91 | 11:43:43 | ONLY Drive F | MCE*.GIF     | GIFS.OUT     | GIFS.SUM |
  204. ===============================================================================
  205.           Image    Col  Gif
  206. GIF Name   Size  Resolutn  Res  Ver  Path
  207. --------  -----  --------  ---  ---  ------------------------------------------
  208. MCE008      82k   640x480   64  87a  F:\GIF
  209. MCE013     204k   640x480   64  87a  F:\GIF
  210. MCE016     224k   640x480  256  87a  F:\GIF
  211. MCE022     249k   640x480  256  87a  F:\GIF
  212. MCE024     268k   640x480  256  87a  F:\GIF
  213. MCE028     149k   640x480  256  87a  F:\GIF
  214.  
  215.