home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top1157 / gepackt.exe / QPEG / QPEG.DOC < prev    next >
Encoding:
Text File  |  1993-11-16  |  11.1 KB  |  243 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                                    Q P E G
  4.                                  ___________
  5.                                  ~^~^~^~^~^~
  6.  
  7.       A fast JPEG viewer for MS-DOS.  VGA graphics and 80386+ required.
  8.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10. Copyright (c) 1993 by TBH-Softworx -- all rights reserved
  11.           Oliver Fromme, Klingestr. 2, 38640 Goslar, Germany
  12.           Internet email: inof@asterix.rz.tu-clausthal.de
  13.  
  14. Version 1.0f of 15-Nov-1993
  15.  
  16. This program is Shareware.  You may copy it, use it, give it to your friends,
  17. upload it to a BBS or something similar, under the following conditions:
  18.  
  19.  * Don't charge any money for it.  If you upload it to a BBS, make sure that
  20.    it can be downloaded free (without paying for downloading it).
  21.  * Only distribute the whole original package, with all the files included.
  22.  * Don't change the files in any way, except:
  23.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  24.    Don't distribute modified versions of these files to others without
  25.    prior permission of the author of QPEG.
  26.  * QPEG may not be part of any commercial product or service without my
  27.    written permission.
  28.  * QPEG may not be used in any corporate or gouvernment institution without
  29.    being registered.
  30.  
  31. This software consists of the following files:
  32.  - QPEG.EXE        the main executable file
  33.  - QPEG.INI        initialization file (ASCII text)
  34.  - QPEG.DAT        data file for QPEG (don't modify!)
  35.  - QPEG.DO?        the documentation
  36.  - CHANGES.DO?     list of changes from previous versions
  37.  - INSTALL.DO?     how to configure QPEG
  38.  - REGISTER.FRM    registration form
  39.  - JPEGUNIT.PAS    order form for the JPEG Pascal unit
  40.  - TBHGLOGO.RLE    TBH logo for user interface
  41.  - CFG\*.CFG       various configuration files
  42.  - CFG\CFG.DOC     description of the configuration file format
  43.  - DRV\*.DRV       various video driver files
  44.  - DRVSRC\*.ASM    source codes for the video drivers
  45.  - DRVSRC\DRV.DOC  description of the video driver file format
  46. Text files with a DOK extension are German, those with a DOC extension
  47. are English.
  48. There may also be some example JPEG files.  They are not part of the QPEG
  49. software package.
  50.  
  51. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  52. can't handle can damage your hardware!  Be sure to use only supported
  53. modes.  If you come across a mode which looks flickering or unstable
  54. (i.e. the monitor can't hold the picture), abort QPEG immediately and
  55. delete that mode from the configuration file.
  56.  
  57. YOU ARE USING QPEG AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  58. RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF QPEG OR BY THE INABILITY
  59. TO USE QPEG.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS,
  60. THEN DO NOT USE QPEG!
  61.  
  62. QPEG is inexpensive shareware.  If you continue using it after a trial
  63. period of 30 days, you are encouraged to pay a small registration fee.
  64. (I try to avoid saying that you MUST register, but actually you MUST.)
  65. The registration is valid for all future updates.  The source code of the
  66. JPEG decoding routines used by QPEG is also available.
  67. To become a registered user, please print the file REGISTER.FRM and send
  68. it to me with appropriate payment.  If you want to get the JPEG source code,
  69. print the file JPEGUNIT.PAS instead.
  70.  
  71. All product names mentioned in this software are trademarks or registered
  72. trademarks of their respective owners.
  73.  
  74. -----------------------------------------------------------------------------
  75.  
  76. What is QPEG?
  77. ~~~~~~~~~~~~~
  78.  
  79. QPEG (Quick-jPEG, pronounce "Q-Peg" [kju:peg]) is a viewer for JPEG image
  80. files.  As far as I know, it is the fastest viewer available for MS-DOS
  81. based computers.
  82.  
  83. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  84. format which uses a "lossy" compression.  JPEG images (they have usually a
  85. "JPG" file extension) are normally very small and offer better compression
  86. than any other image format.
  87.  
  88. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  89. of computing power and performance.  QPEG takes advantage of the advanced
  90. features of 80386 CPUs, and it uses large look-up tables instead of formulas.
  91. Well, I don't want to get into details.  It's fast, that's all you could want
  92. to know.
  93.  
  94.  
  95. Features
  96. ~~~~~~~~
  97.  
  98.  - It's fast (have I mentioned that before?).
  99.  - Nice preview ability which is even faster (lets you quickly browse through
  100.    lots of images, very useful if you're searching for a certain image).
  101.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  102.  - Supports many SVGA cards (virtually all with VESA capability).
  103.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  104.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  105.  - You can pan across an image which is bigger than the current screen
  106.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  107.  - You can change the resolution without loading/decoding the image again
  108.    (this is restricted to the same color resolution, for example you can't
  109.    switch from hicolor to truecolor without reloading the image).
  110.  - Supports also GIF images (non-interlaced).
  111.  
  112.  
  113. Requirements
  114. ~~~~~~~~~~~~
  115.  
  116.  - 80386 or better CPU (33 MHz minimum recommended)
  117.  - VGA graphics card (SuperVGA recommended, though QPEG will run on any
  118.    standard VGA card)
  119.  - some XMS and/or EMS memory (depending on the size of the images), though
  120.    QPEG will also run without any XMS/EMS, but then you will be unable to
  121.    do any panning/scrolling
  122.  - MS-DOS 5.0
  123.  
  124.  
  125. Using QPEG
  126. ~~~~~~~~~~
  127.  
  128. At first you have to configure QPEG for your video hardware.  Please read
  129. the file INSTALL.DOC for more information.
  130.  
  131. Then just type 'QPEG' to run it.  There are some command line options
  132. (type 'QPEG /?' to get a help message), but they're usually not needed.
  133.  
  134. The graphical user interface of QPEG is rather intuitive, so there is no need
  135. for much documentation.  At the top of the screen there's a list of all
  136. keyboard functions.  Hit '?' to get a list of keys that can be used while
  137. viewing an image.  You can quit QPEG at any time by hitting Alt-X.
  138.  
  139. QPEG can also be used as command line viewer (without graphical user
  140. interface).  Type 'QPEG' followed by one or more names of files or
  141. directories.  Wildcards ('*' and '?') are allowed, too.
  142.  
  143.  
  144. Restrictions and Bugs
  145. ~~~~~~~~~~~~~~~~~~~~~
  146.  
  147. The basic JPEG decoding routines of QPEG are written for maximum speed,
  148. there's no time for error checking, thus QPEG may lock up your PC if it tries
  149. to decode a corrupt JPEG file.  To prevent that, you can decode the defective
  150. file using another JPEG decoder (for example DJPEG by Tom Lane / IJG) and
  151. compress it again.  The resulting JPEG file should be decodable by QPEG
  152. without any problems.
  153.  
  154. QPEG can't handle all kinds of JPEG images.  Specifically, it can only decode
  155. files which comply with the JFIF standard.  See 'Technical Information' below
  156. for more details.
  157.  
  158. The maximum image width is 4000 pixel.  QPEG will refuse to decode larger
  159. images.  The image height is not limited, but if it's too large it may not
  160. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  161. down.  If this happens, try to use a video mode with less colors, because it
  162. needs less memory.  Or buy more memory :-)
  163.  
  164. This version of QPEG can't handle interlaced GIF files.
  165.  
  166. If you convert a black-and-white image to JPEG format, QPEG may display
  167. checkerboard patterns in the white areas.  This is due to round-off errors.
  168. NOTE:  Do not convert black-and-white images to JPEG format!  JPEG is not
  169. intended to be used for that kind of images, and GIF does usually a better
  170. job (regarding both image quality and compression).  Therefore I don't think
  171. I should fix that bug, since additional checking for round-off errors would
  172. cost additional time.
  173.  
  174.  
  175. How to get an updated version of QPEG
  176. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  177.  
  178. This version is most probably not the last one.  There are several ways
  179. to get an up-to-date version of QPEG:
  180.  
  181.  - You can get it free by FTP via The Internet.  Of course that's only
  182.    possible if you've got access to The Internet.  You can find QPEG at
  183.    'ftp.tu-clausthal.de' (139.174.2.10) in /pub/msdos/graphics. There's
  184.    also a mail server available at 'mail-server@rz.tu-clausthal.de'.
  185.  
  186.  - You can get it by registering QPEG.  See REGISTER.FRM for more
  187.    information.  The registration is valid for all future updates of QPEG.
  188.  
  189.  - If you're already a registered user, you can get an updated version
  190.    free by electronic mail (email).  If this is not possible, you can get
  191.    it on disk via normal "snail" mail, but that costs 10 $US or 10 DM
  192.    to cover my expenses.  Before sending me money, make sure that there
  193.    IS an updated version (otherwise you might be disappointed because you
  194.    got the same version you already have).
  195.    You can find my mail and email addresses at the top of this documentation
  196.    or by entering 'QPEG /?'.
  197.  
  198.  
  199. Future Enhancements
  200. ~~~~~~~~~~~~~~~~~~~
  201.  
  202. As mentioned before, this is probably not the last version of QPEG.
  203. These features are planned for future versions:
  204.  - Support for more image formats, e.g. Targa and interlaced GIF files.
  205.  - Mouse support (point and click).
  206.  - Tagging multiple files and view them in sequence.
  207.  - Slideshow option (preloading images, but panning disabled).
  208.  - Shrinking of big images.
  209.  - Option for automatically choosing the appropriate video mode.
  210.  - Support for more SVGA cards.  If you've written a working video driver
  211.    that isn't already distributed with QPEG, I would be most grateful if
  212.    you send it to me.
  213.  - More enhancements.  If you have any ideas, wishes, comments etc, please
  214.    let me know.
  215.  
  216.  
  217. Technical Information
  218. ~~~~~~~~~~~~~~~~~~~~~
  219.  
  220. QPEG can decode greyscaled images (containing a single component using h1v1
  221. upsampling) and YCbCr true color images (containing three interleaved
  222. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  223. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  224.  
  225. QPEG can handle files that contain restart markers, but it will not use them
  226. for error recovery.
  227.  
  228. The basic JPEG decoding routines are written in pure 386 assembly language,
  229. everything else is written using Borland Pascal 7.0.  I am not using
  230. protected mode, because it would slow down the decoding rather than speeding
  231. it up.  I have linked the JPEG routines into a single easy to use Pascal
  232. unit, which can also be used within other applications.  If you want to
  233. purchase the unit, please print the file JPEGUNIT.PAS and send it to me with
  234. appropriate payment.
  235.  
  236. The JPEG unit provides procedures to open and close a JPEG file, read the
  237. file header, and read the image row by row.  It contains routines which
  238. output the lines as 24 bit true color RGB/BGR, 15 bit hicolor, 256 color
  239. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  240. greyscaled/dithered for preview (scaled to one eigth).
  241.  
  242. -----------------------------------------------------------------------------
  243.