home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / msdos / viewers / whatpic2 / whatpic.doc < prev    next >
Encoding:
Text File  |  1992-03-21  |  11.3 KB  |  310 lines
  1.                         >>> WHATPIC VERSION 2.0 <<<
  2.               Released March, 1992  Copyright (C) Mike Dowell
  3.  
  4. WHATPIC is a graphic file utility. It will identify any file it recognizes, 
  5. and prints the format, width, height, number of colors, filesize and
  6. drive volume.
  7.  
  8. File                  Size
  9. WHATPIC.COM           14248
  10.  
  11.  
  12.  
  13. File formats currently recognized by WHATPIC:
  14.  
  15. Format   Description
  16. ------   -----------
  17. BMP      Microsoft Windows 3.0 bitmap
  18. FLI      Autodesk Animator animation file
  19. GIFxxxy  Compuserve's Graphics Interchange Format: xxx is the version number,
  20.          y is an I if the image is interlaced
  21. ILBM     Deluxe Paint/AMIGA IFF InterLeaved BitMap
  22. IMG/GEM  Ventura Publisher file
  23. JFIFx.x  JPEG File Interchange Format: x.x is the version number
  24. MAC      MacPaint file
  25. PBM      Deluxe Paint II enhanced IFF BitMap
  26. PCXx.x   PC Paintbrush/ZSoft file: x.x is the version number
  27. PIC      PC Paint/Pictor file
  28. RIX      ColoRIX VGA Paint file
  29. TARGAxx  Truevision Targa file: xx is the image type described below
  30. TIFFx    Tagged Image File Format: x is an I or M for the byte order
  31.  
  32.  
  33. HOW TO USE WHATPIC
  34. ------------------
  35. The usage is very simple:
  36.  
  37.                 WHATPIC <filespec1> <filespec2> ...
  38.  
  39.           eg. WHATPIC a:*.bmp  nagel??.jpg  b:\pic\gif\*.*
  40.  
  41. Notice wildcards and multiple filespecs are allowed.
  42.  
  43.  
  44. WHAT DOES WHATPIC TELL YOU?
  45. ---------------------------
  46. The program has two purposes, to check if the file is a graphic file it
  47. recognizes, and then to find the specifications of that file.  So you
  48. can run the program on a single file to check if it is a GIF picture.
  49.  
  50. Here is some sample output:
  51.  
  52. WHATPIC a:*.gif  b:  nagel??.gif
  53.  
  54.   Filename      Format    Width Height   Colors   Filesize  Drive Label
  55. ------------   --------   ----- ------   ------   --------  -----------
  56. LAFORGE .GIF    GIF87a     320 x  200        16      20480  STARTREK #1
  57. NCC170A .GIF    GIF87a     320 x  200        16       8192  STARTREK #1
  58. PIKARD  .GIF    GIF87a     320 x  200        16      16384  STARTREK #1
  59. WORF    .GIF    GIF87a     320 x  200        16      21504  STARTREK #1
  60. MICKEY  .GIF    GIF87a     640 x  480        16      34366  CARTOONS #2
  61. BUGSBUNN.GIF    BMP        320 x  200       256      39936  CARTOONS #2
  62. OPUS    .GIF    GIF87a     640 x  720        16      11264  CARTOONS #2
  63. RAGERAB2.GIF    GIF87a     640 x  350        16      54784  CARTOONS #2
  64. NAGEL01 .GIF    GIF87a     640 x  350        16      11125   *Mike-D *
  65. NAGEL02 .GIF    GIF87a     640 x  350        16       5174   *Mike-D *
  66. NAGEL03 .GIF    GIF87a     640 x  350        16       4452   *Mike-D *
  67. NAGEL04 .GIF    GIF87a     640 x  350        16       5598   *Mike-D *
  68.  
  69. 12 graphic files found.
  70.  
  71.  
  72. This checked all the files on A: drive with the GIF extension, all the files
  73. on B: drive, and all the files matching NAGEL??.GIF on the current drive
  74. to see if they were graphic files.  Note that even though the file called
  75. BUGSBUNN.GIF was a Windows 3.0 bitmap it knew and put that under the format
  76. column.  So no matter what the file name or extension is WHATPIC will find
  77. its true format.
  78.  
  79. The last column is the volume label of the drive the file was found on.
  80. I keep my GIF files on numbered floppies and this way I can keep track of
  81. where my files are.
  82.  
  83.  
  84. WHAT DOES THE OUTPUT MEAN?
  85. --------------------------
  86. The output of WHATPIC is mostly straightforward.  The file name, type, height,
  87. width, number of colors and filesize will be printed.  If the number of
  88. colors exceeds 16 bits i.e. more than 65536, WHATPIC will just put the number
  89. of bits per pixel. (Printing out that my JFIFs had 16777216 colors became
  90. worthless...)  Other various quirks will be described for each individual
  91. file type below:
  92.  
  93.  
  94. BMP - Microsoft Windows 3.0 bitmap
  95.  
  96. I would assume that Windows 3.1 bitmaps will not be any different so
  97. technically it should say Windows 3.? bitmaps but I'm not terribly technical.
  98.  
  99.  
  100. FLI - Autodesk Animator animation file
  101.  
  102. This is the one that "does not belong" because it is not just a graphic file.
  103. These are animation files created original by Autodesk.  The current version
  104. of WHATPIC only handles the 320x200 FLIs so the size is never different, but
  105. instead of telling you the number of colors the value in the colors column
  106. is the number of frames in the animation.
  107.  
  108.  
  109. GIFxxxy - Compuserve's Graphics Interchange Format
  110.  
  111. This is probably the most abundant of the graphic formats.  There are two
  112. versions out right now so the 'xxx' is either 87a or 89a.  GIFs can be
  113. interlaced so the 'y' will be an I if it is.
  114.  
  115.  
  116. ILBM - Deluxe Paint/AMIGA IFF InterLeaved BitMap
  117.  
  118. The technical manual I used to break these down said that Electronic Arts
  119. uses this standard.  IFF stands for Interchange Format Files and an
  120. InterLeaved BitMap is just one kind of IFF.  Amiga seems to use these
  121. quite a bit as well as the aforementioned Deluxe Paint.
  122.  
  123.  
  124. IMG/GEM - Ventura Publisher file
  125.  
  126. These are all 2 color files.  If you find one with more than 2 colors,
  127. someone lied to me...  Anyway these are usually associated with the GEM
  128. windowing environment and Ventura Publisher.
  129.  
  130.  
  131. JFIFx.x - JPEG File Interchange Format
  132.  
  133. These are the "Future" of pictures.  JPEG stands for Joint Photographic
  134. Experts Group.  The JFIF is a new graphics standard using lossy compression.
  135. That means that the resulting file may not be exactly the same as the
  136. original.  It uses baseline and extended-sequential compression(yeah right).
  137. What it boils down to is that you can get LARGE pictures with 24 bits of
  138. color that are extremely SMALL in size...example:
  139.  
  140.   Filename     Format   Width Height   Colors   Filesize   Drive Label
  141. ------------   ------   ----- ------   ------   --------   -----------
  142. 968A    .JPG   JFIF1.1   893 x  663     24bit      39073
  143. 968A    .GIF   GIF87a    893 x  663       256     299675
  144.  
  145. So this format seems to have a great future!
  146.  
  147.  
  148. MAC - MacPaint file
  149.  
  150. These files will all be 576x720 with 2 colors.  That made decoding them for
  151. WHATPIC quite easy.
  152.  
  153.  
  154. PBM - Deluxe Paint II enhanced IFF BitMap
  155.  
  156. I stumbled across this format with the program VPIC 4.5 (C) by Bob Montgomery.
  157. I converted one of my pictures to this format and looked at its header.
  158. Just within the header the only change between the PBM and ILBM seemed to
  159. be that PBM was written instead of ILBM.  Easy enough so I added it to
  160. WHATPIC.
  161.  
  162.  
  163. PCXx.x - PC Paintbrush/Zsoft file
  164.  
  165. These files are also abundant.  The 'x.x' will be the version of the file,
  166. currently either 2.5, 2.8, 3.0 or ?.?.  The ?.? denotes WHATPIC didn't
  167. recognize the version, the file may or may not be valid.
  168.  
  169.  
  170. PIC - PC Paint/Pictor file
  171.  
  172. These have been around a while.  Nothing outrageous about these.  The format
  173. was retrieved from a document from Microtex Industries, Inc.  The date on
  174. my copy was February 9, 1988 so I'm not sure what updates have occurred.
  175.  
  176.  
  177. RIX - ColoRIX VGA Paint file
  178.  
  179. So far the only place I have seen these files is with the ColoRIX VGA
  180. Paint package itself.  The format information was in the Appendix E of
  181. the manual.
  182.  
  183.  
  184. TARGA - Truevision Targa file
  185.  
  186. TARGA files were pretty difficult.  There are very few bits which tell you
  187. that it is a TARGA file, I noted that some of my utilities were TARGA
  188. files with heights and widths of over 100000 so I do not guarantee they
  189. will all be valid TARGAs.  The 'xx' in the output denotes the image type:
  190.  
  191.  1 - Uncompressed, color-mapped image
  192.  2 - Uncompressed, RGB image
  193.  3 - Uncompressed, black and white image
  194.  9 - Runlength encoded color-mapped image
  195. 10 - Runlength encoded RGB image
  196. 11 - Compressed, black and white image
  197. 32 - Compressed color-mapped data, using Huffman, Delta, and runlength
  198.      encoding
  199. 33 - Compressed color-mapped data, using Huffman, Delta, and runlength
  200.      encoding (4-pass quadtree-type process)
  201.  
  202. This info was taken from Appendix C of the Truevision Technical Guide.
  203. Don't ask me what most of the above means but I assume it is pertinent
  204. to certain people.
  205.  
  206.  
  207. TIFFx - Tagged Image File Format
  208.  
  209. TIFF files are quite interesting.  The first byte of the header tells you
  210. whether the remaining file is stored in Big-Endian or Little-Endian format.
  211. Therefore the 'x' in the output will be an I (to denote INTEL) or an M
  212. (to denote MOTOROLA).  Either format is readable by most popular conversion
  213. and viewing programs.
  214.  
  215.  
  216.  
  217. PROGRAMMING NOTES
  218. ------------------
  219. WHATPIC.COM was written entirely in Turbo C and was compiled with
  220. BORLAND C++ 2.0 using the tiny memory module. Why not written in C++?
  221. Well I've noticed that school really takes up so much of my time that I
  222. don't have time to learn useful things...
  223.  
  224.  
  225. WHERE CAN I GET THESE FORMATS?
  226. ------------------------------
  227. For most of the formats covered here the specifications are available on
  228. the INTERNET. At titan.rice.edu (128.42.1.30) in /public/graphics.formats
  229. you can find info about GIF, FLI, IFF, PCX, TARGA, TIFF and many others
  230. not used here.  For information about the JPEG/JFIF picture format the
  231. group that has been working on it has all their source code and specs
  232. available on ftp.uu.net (137.39.1.9) in the /graphics/jpeg directory.  As
  233. of March 17, 1992,  Version 3 of their code was available.
  234.  
  235.  
  236. HISTORY
  237. -------
  238.  
  239. VERSION 1.0  December 1990
  240.      -First release
  241.  
  242. VERSION 2.0  March 1992
  243.      -Added a LOT of new formats including:
  244.       Autodesk Animations, Amiga IFF, JFIF, Deluxe Paint II, PC Paint, ColoRIX,
  245.       and TARGA.
  246.  
  247.      -Added check for interlaced GIFs.
  248.  
  249.      -Added format version numbers to output.
  250.  
  251.      -Fixed bug with PCX EGA files.
  252.  
  253.      -Hopefully made code more efficient.
  254.  
  255.  
  256. THANK YOUS AND HELP SOURCES
  257. ---------------------------
  258. I have to give credit to an extremely helpful book.
  259. It is a book called:
  260.  
  261. "Bit-Mapped Graphics"
  262. Written by Steve Rimmer
  263. Published by Windcrest Books
  264.  
  265. It is an excellent source of graphic file information which covers MacPaint,
  266. GEM/IMG, PC Paintbrush, GIF, and TIFF formats. It has many C and Assembly
  267. examples for picture viewers, encoders, decoders and converters. I highly
  268. recommend it if you want to do any graphic manipulation programs or just want
  269. to find out about most major formats.
  270.  
  271. After I squeezed as much information out of the above book I took to
  272. pestering people on the USENET.  I want to say "Thanks" to all those who
  273. E-Mailed and Flamed me.  There is an abundance of information out there on
  274. the NET.
  275.  
  276.  
  277. FEEDBACK
  278. --------
  279. This program is FREEWARE. (Yippee! Hurrah!)  I have 3 requests
  280. though:
  281.  
  282. 1) Support the BBS or newsgroup you got it from!
  283.  
  284. 2) Give me some FEEDBACK.  Do you like the program?  Do you use the program?
  285. Did you find a bug?  Did you find a problem? etc.
  286.  
  287. 3) And lastly I would like to know how far this program gets.  It was started
  288. in Las Cruces, New Mexico.  Just drop me a note:
  289.  
  290. Mike Dowell
  291. 604 Zecca
  292. Gallup, NM  87301
  293.  
  294.  
  295. If you have any other questions or comments just leave a message on the
  296. Waterfront West Wildcat! BBS in Las Cruces, NM (505) 521-4528.
  297. or on INTERNET:
  298. mdowell@dante.nmsu.edu
  299. mdowell@isleta.nmsu.edu
  300.  
  301.  
  302. WARRANTY AND GUARANTEE
  303. ----------------------
  304. Basically, there are none.  Anyone can use it and as far as I know it works
  305. fine.  I claim no responsibility for any damage or unknown results from the
  306. use of this program.  I also do not guarantee that this program will work
  307. on every machine, it should, but you never know.
  308.  
  309. So enjoy!!!
  310.