home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / mpeg_play201 / mpeg_play.hlp < prev    next >
Text File  |  1994-03-19  |  5KB  |  112 lines
  1. 1 MPEG_PLAY
  2. Plays mpeg-1 encoded bitstreams using MOTIF
  3.  
  4. SYNOPSIS
  5. $ mpeg_play [-nob] [-nop] [-display display_name] [-dither dither_option]
  6.   [-loop] [-eachstat] [-no_display] [-shmem_off ] [-l_range num]
  7.   [-cr_range num] [-cb_range num] [-quiet]  file_name
  8.  
  9. DESCRIPTION
  10. mpeg_play decodes and displays mpeg-1 encoded bitstreams on systems running 
  11. X11. The player will create a new window, display the bitstream, and exit.
  12. Any error messages or notices are sent to stderr. 
  13.  
  14. 2 OPTIONS
  15. -nob : causes the player to ignore and not display any B frames.
  16.  
  17. -nop : causes the player to ignore and not display any P frames.
  18.  
  19. -display display_name : causes the player to open the window on the display 
  20.  
  21. -dither dither_option : selects from a variety of dither options. The 
  22.  possible values are:
  23.  
  24.     ordered  - ordered dither. 
  25.  
  26.     ordered2 - a faster ordered dither. This is the default.
  27.  
  28.     mbordered - ordered dithering at the macroblock level. Although there
  29.     is a noticeable decrease in dither quality, this is the fastest dither
  30.     available.
  31.  
  32.     fs4 - Floyd-Steinberg dithering with 4 error values propogated.
  33.  
  34.     fs2 - Floyd-Steinberg dithering with 2 error values propogated.
  35.  
  36.     fs2fast - Fast Floyd-Steinberg dithering with 2 error values propogated.
  37.  
  38.     hybrid - Hybrid dithering, a combination of ordered dithering for the 
  39.     luminance channel and Floyd-Steinberg 2 error dithering for the 
  40.     chrominance channels. Errors are NOT propogated properly and are dropped 
  41.     all togethor every two pixels in either direction.
  42.  
  43.     hybrid2 - Hybrid dithering as above, but with error propogation among 
  44.     pixels.
  45.  
  46.     2x2 - A dithering technique using a 2x2 pixel area for each pixel. The 
  47.     image displayed is 4 times larger than the original image encoded. Random 
  48.     error terms are added to each pixel to break up contours and gradients.
  49.     gray - Grayscale dithering. The image is dithered into 128 grayscales. 
  50.     Chrominance information is thrown away.
  51.  
  52.     color - Full color display (only available on 24 bit color displays).
  53.  
  54.     none - no dithering is done, no image is displayed. Used to time 
  55.     decoding process.
  56.  
  57.     mono - Floyd-Steinberg dithering for monochrome displays.
  58.  
  59.     threshold - Floyd-simple dithering for monochrome displays.
  60.  
  61. -loop : makes the player loop back to the beginning after reaching the end.
  62.  
  63. -quiet: supresses printing of frame numbers, timing information, and most error
  64. messages.
  65.  
  66. -eachstat: causes statistics to be displayed after each frame. Only valid when
  67. compiled with -DANALYSIS.
  68.  
  69. -shmem_off: turns shared memory off.
  70.  
  71. -l_range num_colors: sets the number of colors assigned to the luminance 
  72. component when dithering the image.  The product of l_range, cr_range and 
  73. cb_range should be less than the number of colors on the display.
  74.  
  75. -cr_range num_colors: sets the number of colors assigned to the red component
  76. of the chrominace range when dithering the image.  The product of l_range,
  77. cr_range and cb_range should be less than the number of colors on the
  78. display.
  79.  
  80. -cb_range num_colors: sets the number of colors assigned to the blue 
  81. component of the chrominace range when dithering the image.  The product 
  82. of l_range, cr_range and cb_range should be less than the number of colors 
  83. on the display.
  84.  
  85. -no_display: dithers, but does not display, usually used for testing and timing
  86. purposes.
  87.  
  88. 2 NOTES
  89. The player expects MPEG-1 video streams only. It can not handle multiplexed 
  90. MPEG streamsor video+audio streams. The player uses the paris entropy coding 
  91. table set (which we believe to be the MPEG-1 standard), but can not handle 
  92. any bitstreams that use the "berlin" entropy coding table set. Berlin data 
  93. is relatively rare so there shouldn't be too much to worry about here, but 
  94. be aware of the difference when looking for streams to play. 
  95.  
  96. Some streams do not end with the proper sequence end code and will probably 
  97. generate an "Improper sequence end code." error when done playing.
  98.  
  99. This player can play XING data files. Be aware that XING makes no use of 
  100. temporal  redundancy or motion vector information. In other words, they do 
  101. not use any P or B frames in their streams. Instead, XING data is simply a 
  102. sequence of I frames. Since I frames take significantly longer to decode, 
  103. performance of the player using XING data is not representative of the 
  104. player's ability.
  105.  
  106. 2 AUTHORS
  107. Ketan Patel - University of California, Berkeley, kpatel@cs.berkeley.edu
  108. Brian Smith - University of California, Berkeley, bsmith@cs.berkeley.edu
  109. Henry Chi-To Ma - University of California, Berkeley, cma@cs.berkeley.edu
  110. Kim Man Liu - University of California, Berkeley, kliu@cs.berkeley.edu
  111.  
  112.