mpeg_play-2.4p0.tgz/man/cat1/mpeg_play.0

pkg://mpeg_play-2.4p0.tgz:75866/man/cat1/mpeg_play.0 downloads

MPEG_PLAY(1) MPEG_PLAY(1)

NNAAMMEE
mpeg_play - plays mpeg-1 encoded bitstreams using X11

SSYYNNOOPPSSIISS
mmppeegg__ppllaayy [ --nnoobb ] [ --nnoopp ] [ --ddiissppllaayy ddiissppllaayy__nnaammee ] [
--qquuaalliittyy {{oonn||ooffff}} ] [ --ddiitthheerr ddiitthheerr__ooppttiioonn ] [ --lloooopp ] [
--eeaacchhssttaatt ] [ --sseeeekk ooffffsseett ] [ --ssttaarrtt nnuumm ] [ --eenndd nnuumm ] [
--ggaammmmaa ggaammmmaa__ccoorrrreeccttiioonn__vvaalluuee ] [ --ffrraammeerraattee nnuumm ] [
--nnoo__ddiissppllaayy ] [ --ccoonnttrroollss {{oonn||ooffff||nnoonnee}} ] [ --sshhmmeemm__ooffff ] [
--ll__rraannggee nnuumm ] [ --ccrr__rraannggee nnuumm ] [ --ccbb__rraannggee nnuumm ] [
--qquuiieett ] ffiillee__nnaammee

DDEESSCCRRIIPPTTIIOONN
mmppeegg__ppllaayy decodes and displays mpeg-1 encoded bitstreams
on systems running X11. The player will create a new win
dow, display the bitstream, and exit. Any error messages
or notices are sent to stderr.

OOPPTTIIOONNSS
--nnoobb : causes the player to ignore and not display any B
frames.

--nnoopp : causes the player to ignore and not display any P
and B frames.

--ddiissppllaayy ddiissppllaayy__nnaammee : causes the player to open the win
dow on the display _d_i_s_p_l_a_y___n_a_m_e.

--qquuaalliittyy {{oonn||ooffff}} : forces player to choose output quality
over speed when on, and vice versa when off. When
quality is on, the player uses a computationally
expensive IDCT and also improves playback through
improved handling of half pixel motion vectors.
The default can be set to on if you compile
mpeg_play with the flag -DQUALITY.

--ddiitthheerr ddiitthheerr__ooppttiioonn : selects from a variety of dither
options. The possible values are:

ordered - ordered dither.

ordered2 - a faster ordered dither. This is the
default.

mbordered - ordered dithering at the macroblock
level. Although there is a noticeable
decrease in dither quality, this is the
fastest dither available.

fs4 - Floyd-Steinberg dithering with 4 error values
propagated.

fs2 - Floyd-Steinberg dithering with 2 error values
propagated.

28 May 1995 1

MPEG_PLAY(1) MPEG_PLAY(1)

fs2fast - Fast Floyd-Steinberg dithering with 2
error values propagated.

hybrid - Hybrid dithering, a combination of ordered
dithering for the luminance channel and
Floyd-Steinberg 2 error dithering for the
chrominance channels. Errors are NOT propa
gated properly and are dropped all together
every two pixels in either direction.

hybrid2 - Hybrid dithering as above, but with error
propagation among pixels.

2x2 - A dithering technique using a 2x2 pixel area
for each pixel. The image displayed is 4
times larger than the original image
encoded. Random error terms are added to
each pixel to break up contours and gradi
ents.

gray - Grayscale dithering. The image is dithered
into 128 grayscales. Chrominance information
is thrown away.

gray256 - Grayscale dithering. The image is
dithered into 256 grayscales (requires pri
vate colormap). Chrominance information is
thrown away.

color - Full color display (only available on 16/24
bit color displays).

color2 - Full color display with increased size
(only available on 16/24 bit color dis
plays).

none - no dithering is done, no image is displayed.
Used to time decoding process.

mono - Floyd-Steinberg dithering for monochrome
displays.

threshold - Floyd-simple dithering for monochrome
displays.

ppm - Write a PPM file for each frame.

--lloooopp : makes the player loop back to the beginning after
reaching the end.

--oowwnnccmm : makes the player use a private colormap for the
window.

--sstteepp : requires the user to press return for each new

28 May 1995 2

MPEG_PLAY(1) MPEG_PLAY(1)

frame.

--sseeeekk ooffffsseett : before playing the movie, seek to the given
offset in the file (useful for large movies). In
this case -end is redefined to give the number of
frames to play, and -start has no meaning. The
offset should point to a Sequence or (closed) GOP
header, but data will be discarded until one is
found. The initial sequence header will be parsed
before the seek. The skipped sections must not
change the quantization matrices or the results are
undefined.

--ssttaarrtt nnuumm : Waits to start display until this frame num
ber (previous frames are parsed).

--eenndd nnuumm : ends display at this frame number (except when
-seek is used).

--ggaammmmaa ggaammmmaa__ccoorrrreeccttiioonn__ppaarraamm : specifies the amount of
gamma correction. Default is 1.0. Use higher val
ues if movie looks dark and hard to see.

--ffrraammeerraattee nnuumm : sets the framerate of the playback to num
frames per second. A value of 0 indicates that the
stream should be played as fast as possible. The
default is to play at the rate specified in the
stream (if possible). Note this is merely a fram
erate limiter, it will not discard frames to meet
the rate.

--ccoonnttrroollss {{oonn||ooffff||nnoonnee}} : determines the initial interac
tive X user interface control bar state (if avail
able). The value on (default) opens the control
bar at initialization and enters pause mode after
displaying the first frame. The value off leaves
the control bar initially hidden and begins play
back without pausing (similar to the old behavior).
The control bar can be toggled on and off at any
time by clicking in the video display window,
unless the -controls none option is specified, in
which case the control bar is unavailable and play
back functions as though the player were built
without interactive controls (exactly the old
behavior).

--qquuiieett : suppresses printing of frame numbers, timing
information, and most error messages.

--eeaacchhssttaatt : causes statistics to be displayed after each
frame. Only valid when compiled with -DANALYSIS.

--sshhmmeemm__ooffff : turns shared memory off.

28 May 1995 3

MPEG_PLAY(1) MPEG_PLAY(1)

--ll__rraannggee nnuumm__ccoolloorrss : sets the number of colors assigned
to the luminance component when dithering the
image. The product of l_range, cr_range and
cb_range should be less than the number of colors
on the display.

--ccrr__rraannggee nnuumm__ccoolloorrss : sets the number of colors assigned
to the red component of the chrominance range when
dithering the image. The product of l_range,
cr_range and cb_range should be less than the num
ber of colors on the display.

--ccbb__rraannggee nnuumm__ccoolloorrss : sets the number of colors assigned
to the blue component of the chrominance range when
dithering the image. The product of l_range,
cr_range and cb_range should be less than the num
ber of colors on the display.

--nnoo__ddiissppllaayy : dithers, but does not display, usually used
for testing and timing purposes.

NNOOTTEESS
The player expects video streams only. It can handle mul
tiplexed MPEG streams (video+audio streams) by discarding
the audio.

Some streams do not end with the proper sequence end code
and will probably generate an "Improper sequence end
code." error when done playing.

This player can play XING data files. Be aware that XING
makes no use of temporal redundancy or motion vector
information. In other words, they do not use any P or B
frames in their streams. Instead, XING data is simply a
sequence of I frames. Since I frames take significantly
longer to decode, performance of the player using XING
data is not representative of the player's ability.

The player does not play MPEG-1 D-frame streams, but they
are a rarity.

If the player is compiled without the controlbar, then it
can play multiple streams in different windows.

VVEERRSSIIOONN
This is version 2.1a, containing some new features since
2.0, and several bug fixes. It is a major change since
version 1.0.

BBUUGGSS
The only known bug is that multiple mpeg_plays cannot seem
to be run simultaneously on a multiprocessor SPARC 20 or a
SparcCenter 2000E using shared memory (in particular: "On
a bi-processor Sparc 20/20 sparc-processor 2000E running

28 May 1995 4

MPEG_PLAY(1) MPEG_PLAY(1)

Solaris 2.3 or 2.4, it is not possible to run two concur
rent 'mpeg_play -loop' on the same bitstream. One of the
mpeg_play dies when it loops." This may be a problem with
the X shared memory library and not our code.)

AAUUTTHHOORRSS
Ketan Patel - University of California, Berkeley, kpa
tel@cs.berkeley.edu

Brian Smith - University of California, Berkeley,
bsmith@cs.berkeley.edu

Henry Chi-To Ma - University of California, Berkeley,
cma@cs.berkeley.edu

Kim Man Liu - University of California, Berkeley,
kliu@cs.berkeley.edu

Steve Smoot - University of California, Berkeley,
smoot@cs.berkeley.edu

Eugene Hung - University of California, Berkeley,
eyhung@cs.berkeley.edu

28 May 1995 5