home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / graphics / viewers / mpeg / mpeg2dctv / mpeg2dctv.readme < prev   
Text File  |  1993-04-11  |  5KB  |  93 lines
  1. MPEG2DCTV Version 1.0
  2.    
  3. This is a program to decompress MPEG video streams to a DCTV display
  4. buffer.  'mpeg2dctv' _REQUIRES_ a 68020 or higher CPU, and a 68881
  5. or higher FPU.  On an Amiga 3000, (25 MhZ 68030 and 25 MhZ 68882),
  6. displaying a 160x120 MPEG stream, 'mpeg2dctv' plays at just over one
  7. frame per second in grayscale (the default option), at about 9/10 of
  8. a frame per second using the -color option, at about 2.5 frames/second
  9. in grayscale using the -fast option, and at about 1.9 frames/second
  10. in full color using the -fastc option. 
  11.     
  12. Usage: mpeg2dctv [-nop] [-nob] [-loop] [-no_display]
  13.                  [-color | -fast | -fastc] [-3] [-quiet]
  14.                  [-save output_file] input_file
  15.      
  16.   where -nob        disables decoding of B-type MPEG blocks;
  17.         -nop        disables decoding of P-type MPEG blocks;
  18.         -loop       causes the video stream to be replayed until
  19.                     terminated by typing <ctrl>-C;
  20.         -no_display will decode an MPEG stream, without displaying
  21.                     the results on your screen;
  22.         -color      decodes in full color; note that 'mpeg2dctv' defaults
  23.                     to ignore chroma and decode in grayscale;
  24.         -fast       will decode in grayscale using an optimized routine
  25.                     instead of the DCTV library, but the display quality
  26.                     is not the highest (great for previewing MPEG streams);
  27.         -fastc      will decode in full color using an optimized routine
  28.                     instead of the DCTV library (the display is almost
  29.                     identical to the display created using the -color and
  30.                     -3 options);
  31.         -3          decodes to a 3 bitplane DCTV screen;
  32.         -quiet      will stop 'mpeg2dctv' from displaying info about
  33.                     which frame is being decoded, as well as decoding speed;
  34.         -save       will save each frame as an IFF picture; each frame will
  35.                     be saved as [output_file].[frame number] ('work:bike.001'
  36.                     would be the first frame saved if 'work:bike' were
  37.                     given as the output_file).
  38.         
  39. NOTES: The inputfile _must_ be an MPEG video stream.
  40.        
  41. You _must_ install 'dctv.library' and 'ixemul.library' in your LIBS:
  42. directory to use 'mpeg2dctv'.  'dctv.library' is not included in this
  43. archive, because of Digital Creations' restrictions upon distribution of the 
  44. library.  'dctv.library' can be found on many BBSes and commercial
  45. services.  'ixemul.library' v. 39.45 is included in this archive, along
  46. with an MPEG stream named 'mickey.mpg'.
  47.        
  48. 'dctv.library' is copyrighted © 1991 by Digital Creations, Inc.
  49.              
  50. The MPEG source code used in 'mpeg2dctv' is copyrighted © 1992 by
  51. the Regents of the University of California.
  52.               
  53. 'mpeg2dctv' is copyrighted © 1993 by Benjamin Reich.
  54.              
  55. This software is provided AS IS.  It is provided free of charge, except
  56. that if you find this program useful, I request that you make a donation
  57. of US$10 (or the equivalent) to the charity of your choice.
  58.                
  59. Special thanks to Allan Braunsdorf, whose information about the DCTV
  60. display format and the DCTV raw format allowed me to create routines to
  61. bypass the dctv.library and write directly to a DCTV display.
  62.  
  63. UPDATES:
  64. From v. 0.5 - added two new dither options, -fast and -fastc, which
  65.               both convert YCrCb data directly to DCTV display format,
  66.               which results in a very significant increase in playback
  67.               speed.
  68. From v. 0.4 - corrected error where MPEG streams with I, P and B frames
  69.               would be displayed in the wrong order.
  70.             - added ability to save each frame produced by 'mpeg2dctv';
  71.               the resulting frames can be built into an animation with
  72.               several different utilities.
  73. From v. 0.2 - added 3 bitplane display option.
  74.             - upgraded to v. 2.0 of the UC mpeg source code, which slightly
  75.               increases playback speed and fixes some decoding problems.
  76. From v. 0.1 - changed to using a lookup table for color conversion from 
  77.               YCrCb to RGB, instead of calculating each conversion.  
  78.               This increased playback speed from 0.3 fps to 0.8 fps.
  79.  
  80. THINGS STILL TO DO:
  81. I am considering adding an AREXX port, to allow 'mpeg2dctv' to work with
  82. ADPro and other products.  If someone can direct me to code for creating
  83. compressed opcode-5 anim format, I will consider adding the ability to
  84. directly create an anim file from an inout MPEG stream, using 'mpeg2dctv'.
  85.              
  86. -Benjamin Reich
  87.                    Portal:    Counsellor
  88.                    Delphi:    BEN_RICH
  89.                    Usenet:    Counsellor@cup.portal.com
  90.                    U.S. mail: 805 Lincoln Drive
  91.                               Voorhees, NJ  08043
  92.   
  93.