home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / gfx / superview-lib-9.12.lha / SuperView-Lib / Bonus / JPEG-SVObject / JPEG.doc < prev    next >
Text File  |  1994-12-28  |  6KB  |  170 lines
  1.  
  2.   JPEG.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.   This software is based in part on the work of the Independent JPEG Group.
  8.  
  9.   Version      : 2.5
  10.   Release Date : 19.11.1994
  11.  
  12.  
  13.   Requirements
  14.   ~~~~~~~~~~~~
  15.   - OS V2.04+ (V37)+ and its libraries
  16.   - 68020+, optimized for 68030
  17.   - superviewsupport.library V3+
  18.  
  19.  
  20.   Description
  21.   ~~~~~~~~~~~
  22.   JPEG.svobject is an external Library-Module for the superview.library V2+.
  23.  
  24.   It contains SVDriver-Support for the superview.library V3+, and
  25.   needs any SVDriver with ChunkyPixel-Support.
  26.  
  27.   It supports reading and writing of JPEG Files as they are written by
  28.   "The Independent JPEG Group's JPEG Software" (release 4).
  29.  
  30.   In detail these are :
  31.  
  32.   Reading :
  33.  
  34.    - JPEG (IJG-JFIF), with output in 256 Colors or 24 Bit
  35.  
  36.   Writing :
  37.  
  38.    - JPEG (IJG-JFIF), from upto 8 or 24 Bit Input
  39.  
  40.  
  41.   Remarks
  42.   ~~~~~~~
  43.   * VMEM:
  44.   * Temporary data might be written to a directory assigned to "VMEM:",
  45.     if neccessary, but please note, that this might affect your HardDisk,
  46.     if this program crashes (e.g. on a corrupt JPEG-picture) !
  47.     So don't blame me, if this happens, but select a _safe_ place for this
  48.     temporary-file directory !
  49.  
  50.   * Functionality :
  51.   * OK, let's get to the more positive things :
  52.     Since the small problems in the first beta version, some bugs in using
  53.     the IJG-Sources have been fixed, and so almost any JPEG (".JPG") pictures
  54.     out there should be read and displayed correctly.
  55.  
  56.   * Writing JPEG-Files :
  57.   * Note, that JPEG-compression is lossy, which means that the original
  58.     picture cannot be reconstructed totally.
  59.     Only JPEG-compress files, of which you have backups, or files which
  60.     you never want to edit and enhance again.
  61.     You should always control the results from saving an JPEG-File : in
  62.     some special cases (e.g. many thin lines on the screen) there may
  63.     occur strong differences to the original picture.
  64.  
  65.  
  66.   ControlPad-Switches
  67.   ~~~~~~~~~~~~~~~~~~~
  68.   ControlPad-Name     : "ENV:superview-library/JPEG.controlpad"
  69.   ControlPad-Commands : - COLORDEPTH = <8/24>
  70.                           ; should the output be done as 8 or 24 Bit Data ?
  71.                           ; default is 8 Bit data
  72.                         - QUANTIZATION = <0..100>
  73.                           ; 0   - no quality, big compression
  74.                           ; 100 - best quality, no compression
  75.                           ; never use these values, but try something
  76.                           ; like 20, 50, 75 (default: 75)
  77.  
  78.  
  79.   Limitations
  80.   ~~~~~~~~~~~
  81.   Please note, that the De/Encoding Routines of the Library are not (yet)
  82.   fully re-entrant, so that only one Task may De/Encode a picture at a time.
  83.   The Library itself manages it, that the other Task has to Delay() until
  84.   the De/Encoding Routines are "free" again.
  85.   This makes NOT REALLY A MATTER, because De/Encoding takes so much of the
  86.   processor's time, that it is NOT EFFICIENT to EN/DECODE TWO OR MORE
  87.   pictures AT THE SAME TIME ANYWAY !
  88.   Nevertheless parallel Decoding while Encoding should be possible without
  89.   problems (if it does not work, please report it to me !).
  90.  
  91.  
  92.   Author
  93.   ~~~~~~
  94.   Andreas R. Kleinert
  95.   Grube Hohe Grethe 23
  96.   D-57074 Siegen
  97.   Germany
  98.  
  99.  
  100.   History
  101.   ~~~~~~~
  102.   V2.5 (19.11.1994) :
  103.  
  104.    - recompiled JPEG-Code:
  105.       - now "VMEM:" will be used for temporary files
  106.         (just like with conventional VMem of superviewsupport.library)
  107.       - changed naming conventions of temporary VMem files
  108.       - the internal memory allocation routines now will work
  109.         more efficient in using the actually available memory.
  110.         Former releases did only use a maximum of 1 MB non-virtual
  111.         memory, which was a hard-coded value.
  112.         Now we use something like AvailMem(MEMF_LARGEST) to get
  113.         a snapshot of the biggest currently available chunk of memory.
  114.         This will not affect average system configuations, but may
  115.         significantly increase speed on systems with more than
  116.         2 MB FastRam (on a 16 MB system you might no longer need VMem).
  117.  
  118.  
  119.   V2.4 (18.09.1994) :
  120.  
  121.    - now requesting superviewsupport.library V3+, as needed
  122.      (in docs was V1+, in code it was V2+ instead)
  123.    - startup-code now is definitely 68000 compatible (should have been
  124.      before, also)
  125.    - new ControlPad "QUANTIZATION", which allows to determine the
  126.      ratio between quantity/quality when JPEG-compressing
  127.      (something like a compression factor)
  128.  
  129.  
  130.   V2.3 (08.06.1994) :
  131.  
  132.    - now also writes JPEG-Files.
  133.      Input  : - BIT/ONEPLANE upto 8 Bit
  134.               - ONEPLANE with 24 Bit
  135.      Output : 24 Bit JPEG
  136.    - Note : if you do not need writing of JPEG-Files, you may still use
  137.             the previous versions. They have almost the same functionality,
  138.             but because they are "read-only", they're much shorter ...
  139.  
  140.  
  141.   V2.2 (06.06.1994) :
  142.  
  143.    - removed superviewsupport.library from package, use the version
  144.      supplied with superview.library V6+ instead !
  145.  
  146.  
  147.   V2.1 (21.05.1994) :
  148.  
  149.    - beta-version(s) : V2.0 (nearly all major bugs fixed now)
  150.    - first "public release" version
  151.  
  152.  
  153.   Literature
  154.   ~~~~~~~~~~
  155.   [1] The Independent JPEG Group's software package with Source-Code(s)
  156.       and Documentation.
  157.       (See statement at the top of this Doc-File !)
  158.  
  159.   Credits
  160.   ~~~~~~~
  161.   This software is based in part on the work of the Independent JPEG Group.
  162.   Release 4 of 10-Dec-92 was used (as found on the Walnut Creek "Source
  163.   Code CDROM", March 1994, Directory "MSDOS/GRAPHICS", File "JPEGSRC4.ZIP").
  164.  
  165.  
  166.   Copyrights
  167.   ~~~~~~~~~~
  168.   Some of the mentioned names or products above may be copyrighted by
  169.   companies or trademarks of companies.
  170.