home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / video / dctv / jpg2dct7.lzh / jpeg2dctv.readme < prev    next >
Text File  |  1992-02-19  |  4KB  |  96 lines
  1. JPEG2DCTV Version 0.7
  2.  
  3. This is a quick and dirty program to decompress JPEG compressed
  4. images into a DCTV display buffer.  It takes about one minute to
  5. decompress a 730 x 482 x 24 bit image to a full DCTV NTSC screen
  6. on an Amiga 3000 with 'jpeg2dctv', and about 40 seconds with
  7. 'jpeg2dctv.030'.
  8.  
  9. Usage: jpeg2dctv [-a] [-b] [-d] [-p -127..0] inputfile
  10.   where '-a' changes the aspect ratio of a file with square pixels to
  11.              fit an Amiga screen (i.e., scales 640x480 pic to
  12.              640x400 (NTSC) or 640x512 (PAL) );
  13.         '-b' activates cross-block smoothing;
  14.         '-d' deactivates auto-scaling (will create a DCTV image from
  15.              the center of an oversize JPEG file instead); and
  16.         '-p -127..0' will reset the priority of the 'jpeg2dctv' task
  17.              to the negative number you input (default is -10).
  18.  
  19. After the program is finished decoding, you may save the DCTV image
  20. by typing in a filename; 'jpeg2dctv' will save the image and exit.
  21. If you do not want to save the image, just hit return when prompted
  22. to exit 'jpeg2dctv'.
  23.  
  24. The inputfile _must_  be a JPEG compressed image.
  25.  
  26. If you are running 'jpeg2dctv' under 1.3, you _must_ set your stack
  27. size to a minimum of 10000. Otherwise, 'jpeg2dctv' will crash when you
  28. save a full-screen picture.
  29.  
  30. You _must_ install 'dctv.library' and 'ilbm.library' in your LIBS: directory
  31. to use 'jpeg2dctv'.  'dctv.library' and 'ilbm.library' are included in
  32. this archive, along with a test image named (appropriately) 'testimg.jpg'.
  33.  
  34. 'dctv.library' is copyrighted (c) 1991 by Digital Creations, Inc.
  35. 'ilbm.library' is copyrighted (c) 1990 by Jeff Glatt and Dissidents.
  36.  
  37. The JPEG source code used in 'jpeg2dctv' is copyrighted (c) 1991 by
  38. Thomas G. Lane, and is part of the Independent JPEG Group's software.
  39.  
  40. 'jpeg2dctv'and 'jpeg2dctv.030' are copyrighted (c) 1991, 1992 by Benjamin Reich.
  41.  
  42. This software is provided AS IS.
  43.  
  44. Updates from v. 0.6:
  45.    - fixed bug in decoding grayscale JPEG files.  Formerly, the machine
  46.      would lock or crash if a grayscale JPEG file was encountered.
  47.  
  48. Updates from v. 0.5:
  49.    - added support for PAL DCTVs.  Updated the scaling algorithm,
  50.      aspect ratio algorithm and centering algorithm to support PAL displays.
  51.  
  52. Updates from v. 0.4:
  53.    - substituted 'ilbm.library' for the EA IFF-ILBM saving code.  The
  54.      result is that you no longer need to change the stack size under
  55.      2.0.  Also, the saving is much faster.
  56.    - added a command line option to change the aspect ratio of a JPEG
  57.      file to better fit an Amiga screen.  NTSC Amiga pixels are 1.2 times
  58.      taller than they are wide.  PAL Amiga pixels are 1.07 times wider
  59.      than they are tall.  Most JPEG images created on other
  60.      machines will have square pixels.  The '-a' option removes lines
  61.      from a JPEG file on an NTSC display and adds lines on a PAL display,
  62.      so that the image will appear square on the DCTV screen will look
  63.      better on either PAL or NTSC machines.
  64.      Check the effect of the '-a' option on 'testimg.jpg'.
  65.  
  66. Updates from v. 0.3:
  67.    - added ability to save the created DCTV image; and
  68.    - added a command line option to deactivate auto-scaling. Instead,
  69.      'jpeg2dctv' will now take the center 736x482 (NTSC) or
  70.      736x566 (PAL) from the JPEG file, and output the center of the 
  71.      JPEG file as a DCTV image.  This was added because the scaling
  72.      algorithm is basic, and will cause jaggies if the JPEG input file is
  73.      only slightly bigger than 736 horizontally or 482 vertically (NTSC)
  74.      or 566 vertically (PAL).
  75.  
  76. Updates from v. 0.2:
  77.    - will scale down a JPEG file larger than the DCTV display
  78.      to fit on a DCTV screen; and
  79.    - task priority may be set with the '-p' command line switch
  80.      from -127 to 0 (default is -10).  'jpeg2dctv' is processor
  81.      intensive, and a priority of >0 makes my Amiga
  82.      appear to be frozen.
  83.  
  84. Updates from v. 0.1:
  85.    - added proper overscan support;
  86.    - now both 1.3 and 2.0 compatible;
  87.    - screen pops to front when finished decoding; and
  88.    - improved control-c handling
  89.      (will not break until after it is finished decoding).
  90.  
  91. -Benjamin Reich
  92.                    Portal:  Counsellor
  93.                    BIX:     ben_rich
  94.                    Delphi:  BEN_RICH
  95.                    Usenet:  Counsellor@cup.portal.com
  96.