home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Computer Graphics & Animation / Chip-Special-Computergrafik.bin / programs / viewer / qpeg13c.exe / QPEG / ENGLISH / QPEG.DOC < prev    next >
Text File  |  1994-01-14  |  13KB  |  283 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/94 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.3b (beta) of 14-Jan-1994
  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, except
  21.    for usage fees that have to be paid anyway).
  22.  * Only distribute the whole original package, with all the files included.
  23.  * Don't change the files in any way, except:
  24.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  25.    Don't distribute modified versions of these files to others without
  26.    prior permission of the author of QPEG.
  27.  * QPEG may not be part of any commercial product or service without my
  28.    written permission.
  29.  * If you want to include QPEG on a CD ROM and/or book, you must send me
  30.    a free copy of the CD/book.
  31.  * QPEG may not be used in any corporate or gouvernment institution without
  32.    being registered.
  33.  
  34. This software consists of the following files:
  35.  - QPEG.EXE        the main executable file
  36.  - QPEG.INI        initialization file (ASCII text)
  37.  - QPEG.DAT        data file for QPEG (don't modify!)
  38.  - QPEG.DO?        the documentation
  39.  - CHANGES.DO?     list of changes from previous versions
  40.  - INSTALL.DO?     how to configure QPEG
  41.  - FAQ.DO?         frequently asked questions
  42.  - REGISTER.FRM    registration form
  43.  - JPEGUNIT.PAS    order form for the JPEG Pascal unit
  44.  - TBHGLOGO.RLE    TBH logo for user interface
  45.  - CFG\*.CFG       various configuration files
  46.  - CFG\CFG.DOC     description of the configuration file format
  47.  - DRV\*.DRV       various video driver files
  48.  - DRVSRC\*.ASM    source codes for the video drivers
  49.  - DRVSRC\DRV.DOC  description of the video driver file format
  50. Text files with a DOK extension are German, those with a DOC extension
  51. are English.
  52. There may also be some example JPEG files.  They are not part of the QPEG
  53. software package.
  54.  
  55. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  56. can't handle can damage your hardware!  Be sure to use only supported
  57. modes.  If you come across a mode which looks flickering or unstable
  58. (i.e. the monitor can't hold the picture), abort QPEG immediately and
  59. delete that mode from the configuration file.
  60.  
  61. YOU ARE USING QPEG AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  62. RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF QPEG OR BY THE INABILITY
  63. TO USE QPEG.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS,
  64. THEN DO NOT USE QPEG!
  65.  
  66. QPEG is inexpensive shareware.  If you continue using it after a trial
  67. period of 30 days, you are encouraged to pay a small registration fee.
  68. (I try to avoid saying that you MUST register, but actually you MUST.)
  69. The registration is valid for all future updates.  The source code of the
  70. JPEG decoding routines used by QPEG is also available.
  71. To become a registered user, please print the file REGISTER.FRM and send
  72. it to me with appropriate payment.  If you want to get the JPEG source code,
  73. print the file JPEGUNIT.PAS instead.
  74.  
  75. All product names mentioned in this software are trademarks or registered
  76. trademarks of their respective owners.
  77.  
  78. "The Graphics Interchange Format(c) is the Copyright property of
  79. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  80. CompuServe Incorporated."
  81.  
  82. -----------------------------------------------------------------------------
  83.  
  84. What is QPEG?
  85. ~~~~~~~~~~~~~
  86.  
  87. QPEG (Quick-jPEG, pronounce "Q-Peg" [kju:peg]) is a viewer for JPEG image
  88. files.  It is about twice as fast as other common JPEG viewers.  Compare
  89. it yourself, you'll be surprised.
  90.  
  91. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  92. format which uses a "lossy" compression.  JPEG images (they have usually a
  93. "JPG" file extension) are normally very small and offer better compression
  94. than any other image format.
  95.  
  96. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  97. of computing power and performance.  QPEG takes advantage of the advanced
  98. features of 80386 CPUs, and it uses large look-up tables instead of formulas.
  99. Well, I don't want to get into details.  It's fast, that's all you could want
  100. to know.
  101.  
  102.  
  103. Features
  104. ~~~~~~~~
  105.  
  106.  - It's fast (have I mentioned that before?).
  107.  - Nice preview ability which is even faster (lets you quickly browse through
  108.    lots of images, very useful if you're searching for a certain image).
  109.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  110.  - Supports many SVGA cards (virtually all with VESA capability).
  111.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  112.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  113.  - You can pan across an image which is bigger than the current screen
  114.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  115.  - You can change the resolution without loading/decoding the image again
  116.    (this is restricted to the same color resolution, for example you can't
  117.    switch from hicolor to truecolor without reloading the image).
  118.  - Supports also the following image file formats:
  119.     * GIF:
  120.        + interlaced and non-interlaced
  121.        + GIF87a and GIF89a (87a subset only)
  122.        + displays the first image of a multi-image GIF
  123.     * Targa (TGA):
  124.        + truecolor (15, 16, 24 and 32 bit), greyscaled, or with palette
  125.        + uncompressed or rle compressed (run length encoded)
  126.        + supports all video modes (16, 256, 32K, 64K, 16M)
  127.  
  128.  
  129. Requirements
  130. ~~~~~~~~~~~~
  131.  
  132.  - 80386 or better CPU (33 MHz minimum recommended)
  133.  - VGA graphics card (SuperVGA recommended, though QPEG will run on any
  134.    standard VGA card)
  135.  - some XMS and/or EMS memory (depending on the size of the images), though
  136.    QPEG will also run without any XMS/EMS, but then you will be unable to
  137.    do any panning/scrolling
  138.  - MS-DOS 5.0
  139.  
  140. A numeric coprocessor is not required.  If present, it will not be used,
  141. because it would not speed up decoding/displaying.
  142.  
  143.  
  144. Using QPEG
  145. ~~~~~~~~~~
  146.  
  147. At first you have to configure QPEG for your video hardware.  Please read
  148. the file INSTALL.DOC for more information.
  149.  
  150. Then just type 'QPEG' to run it.  There are some command line options
  151. (type 'QPEG /?' to get a help message), but they're usually not needed.
  152.  
  153. The graphical user interface of QPEG is rather intuitive, so there is no
  154. need for much documentation.  Press the 'F1' key to get a list of all
  155. keyboard functions.  Hit '?' to get a list of keys that can be used while
  156. viewing an image.  You can quit QPEG at any time by hitting Alt-X.
  157.  
  158. QPEG can also be used as command line viewer (without graphical user
  159. interface).  Type 'QPEG' followed by one or more names of files.
  160. Wildcards ('*' and '?') are allowed, too.
  161.  
  162.  
  163. Restrictions and Bugs
  164. ~~~~~~~~~~~~~~~~~~~~~
  165.  
  166. QPEG can't handle all kinds of JPEG images.  Specifically, it can only decode
  167. files which comply with the JFIF standard.  See 'Technical Information' below
  168. for more details.
  169.  
  170. The maximum image width is 4000 pixel.  QPEG will refuse to decode larger
  171. images.  The image height is not limited, but if it's too large it may not
  172. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  173. down.  If this happens, try to use a video mode with less colors, because it
  174. needs less memory.  Or buy more memory :-)
  175.  
  176.  
  177. How to get an updated version of QPEG
  178. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  179.  
  180. This version is most probably not the last one.  There are several ways
  181. to get an up-to-date version of QPEG:
  182.  
  183.  - You can get it free by FTP via The Internet.  Of course that's only
  184.    possible if you've got access to The Internet.  You can find QPEG at
  185.    'ftp.tu-clausthal.de' (139.174.2.10) in /pub/msdos/graphics. There's
  186.    also a mail server available at 'mail-server@rz.tu-clausthal.de'.
  187.    I also upload QPEG to 'ftp.wustl.edu' in /pub/MSDOS_UPLOADS/graphics.
  188.  
  189.  - You can get it free (except for phone costs) via Fidonet or simply by
  190.    modem from the "Cyberbox" (Germany):
  191.       Line 1  2:2426/2030 (0441-391452),  9600-19200bps
  192.       Line 2  2:2426/2031 (0441-9390942), 2400-19200bps
  193.       Line 3  2:2426/2032 (0441-9390943), 2400-19200bps
  194.       Line 4  2:2426/2033 (0441-9390944), 38400-64000bps (ISDN)
  195.    Fidonet users can request the current version of QPEG at the addresses
  196.    above using the magic "QPEG".
  197.  
  198.  - You can get it by registering QPEG.  See REGISTER.FRM for more
  199.    information.  The registration is valid for all future updates of QPEG.
  200.  
  201.  - If you're already a registered user, you can get an updated version
  202.    on disk via normal mail, but that costs 10 $US or 10 DM to cover my
  203.    expenses.  Before sending me money, make sure that there IS an updated
  204.    version (otherwise you might be disappointed because you got the same
  205.    version you already have).
  206.    You can find my mail address at the top of this documentation or
  207.    by entering 'QPEG /?'.
  208.  
  209.  
  210. Future Enhancements
  211. ~~~~~~~~~~~~~~~~~~~
  212.  
  213. As mentioned before, this is probably not the last version of QPEG.
  214. These features are planned for future versions:
  215.  - Support for more image formats, e.g. Targa, PCX, BMP.
  216.  - Mouse support (point and click).
  217.  - Tagging multiple files and view them in sequence.
  218.  - Slideshow option (preloading images, but panning disabled).
  219.  - Shrinking of big images.
  220.  - Option for automatically choosing the appropriate video mode.
  221.  - Support for 4DOS/NDOS description files.
  222.  - Support for more SVGA cards.  If you've written a working video driver
  223.    that isn't already distributed with QPEG, I would be most grateful if
  224.    you send it to me.
  225.  - More enhancements.  If you have any ideas, wishes, comments etc, please
  226.    let me know.
  227.  
  228.  
  229. Technical Information
  230. ~~~~~~~~~~~~~~~~~~~~~
  231.  
  232. QPEG can decode greyscaled images (containing a single component using h1v1
  233. upsampling) and YCbCr true color images (containing three interleaved
  234. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  235. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  236.  
  237. QPEG can handle files that contain restart markers, but it will not use them
  238. for error recovery.  QPEG can also display JPEG files which were created
  239. with the 'Adobe Photoshop' (at least version 2.5).
  240.  
  241. The basic JPEG decoding routines are written in pure 386 assembly language,
  242. everything else is written using Borland Pascal 7.0.  I am not using
  243. protected mode, because it would slow down the decoding rather than speeding
  244. it up.  I have linked the JPEG routines into a single easy to use Pascal
  245. unit, which can also be used within other applications.  If you want to
  246. purchase the unit, please print the file JPEGUNIT.PAS and send it to me with
  247. appropriate payment.
  248.  
  249. The JPEG unit provides procedures to open and close a JPEG file, read the
  250. file header, and read the image row by row.  It contains routines which
  251. output the lines as 24 bit true color RGB/BGR, 15/16 bit hicolor, 256 color
  252. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  253. greyscaled/dithered for preview (scaled to one eigth or one fourth).
  254.  
  255.  
  256. Equipment used for Development of QPEG
  257. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  258.  
  259. Hardware:
  260.  - intel 80386/33 DX, 80387/33 DX, 64 Kb cache, 8 Mb, SIS chipset, AMI BIOS
  261.  - 780 Mb of harddisk space (Conner, WD, Quantum), both IDE and SCSI
  262.  - magneto optical disk drive (Fuji), 15 optical disks (2 Gigabytes)
  263.  - CD-ROM drive (Toshiba, doublespin)
  264.  - 250 Mb tape streamer, 5 tapes (1.25 Gigabytes)
  265.  - Cardex-8 graphics card, Tseng ET4000 chipset, 1024 Kb, truecolor (16.8 M)
  266.  - 15" color SVGA monitor w/ digital control & LCD display
  267.  - Advanced Gravis Ultrasound (GUS) 1 Mb, Soundblaster, 200 W amplifier
  268.  - 400 dpi greyscale scanner
  269.  - NEC P60 dot matrix printer
  270.  - Genius mouse
  271.  - Lots of 3.5" HD floppy disks (mainly 3M and Fuji)
  272.  
  273. Software:
  274.  - MS-DOS 5.0 by Microsoft
  275.  - Borland Pascal 7.0 by Borland Int.
  276.  - Turbo Assembler 3.2 by Borland Int.
  277.  - XKEY, KEEP8, BOO by Oliver Fromme
  278.  - PKTINY 1.1 by Thomas Mönkemeier
  279.  - WCED 1.8c by Stuart Russell (Wormsoft)
  280.  - TURBODSK 1.1 by Ciriaco García de Celis
  281.  
  282. -----------------------------------------------------------------------------
  283.