pkg://mpeg_wdgt2.0b.tar.gz:88693/mpeg.3X  downloads

...\" **
...\" **
...\" **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.
...\" **      All Rights Reserved.
...\" **
...\" **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company
...\" **
...\" **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,
...\" **      Maynard, MA.  All Rights Reserved.
...\" **
...\" **
.TH Mpeg 3X "" "" "" ""
.SH NAME
\*LMpeg\*O\(emThe Mpeg widget class
.iX "Mpeg"
.iX "widget class" "Mpeg"
.SH SYNOPSIS
.sS
.iS
\&#include "mpeg.h"
.iE
.sE
.SH DESCRIPTION
Mpeg is a version of the MPEG player from the 
Berkeley Plateau Research Group group as a widget.
It can be used either as a Motif widget subclassed from XmPrimitive
or as a toolkit-independant widget subclassed from Core.
.SS "Classes"
Mpeg inherits from \*LCore\*O. The Motif version also inherits from
\*LXmPrimitive\*0.
.PP
The class pointer is \*LxmpegWidgetClass\*O.
.PP
The class name is \*LXmpeg\*O.
.SS "New Resources"
The following table defines a set of widget resources used by the programmer
to specify data.  The programmer can also set the resource values for the
inherited classes to set attributes for this widget.  To reference a
resource by name or by class in a .Xdefaults file, remove the \*LXmN\*O or
\*LXmC\*O prefix and use the remaining letters.  To specify one of the defined
values for a resource in a .Xdefaults file, remove the \*LXm\*O prefix and use
the remaining letters (in either lowercase or uppercase, but include any
underscores between words).
The codes in the access column indicate if the given resource can be
set at creation time (C),
set by using \*LXtSetValues\*O (S),
retrieved by using \*LXtGetValues\*O (G), or is not applicable (N/A).
.P 
.wH .in 0 
.TS 
center allbox;
cBp9 ssss
lBp8 lBp8 lBp8 lBp8 lBp8
lp8 lp8 lp8 lp8 lp8.
Mpeg Resource Set
Name	Class	Type	Default	Access
_
XmNdither	XmCDither	int	ORDERED_DITHER	C
XmNsource	XmCSource	String	stdin	CSG
XmNshowCount	XmCShowCount	int	-1	CSG
.TE
.wH .in  

\fBXmNdither\fP
.br
Specifies a dithering algorithm to use on the image. The possible values
of this are
.in +1in
\fB
HYBRID_DITHER
.br
HYBRID2_DITHER
.br
FS4_DITHER
.br
FS2_DITHER
.br
FS2FAST_DITHER
.br
Twox2_DITHER
.br
GRAY_DITHER
.br
FULL_COLOR_DITHER
.br
NO_DITHER
.br
ORDERED_DITHER
.br
MONO_DITHER 
.br
MONO_THRESHOLD
.br
ORDERED2_DITHER
.br
MBORDERED_DITHER
.br
MONO_FS4_DITHER
.br
HALFTONE_DITHER
.br
\fP
.in -1in
The corresponding names to use in resource files are
     hybrid,   hybrid2,   fs4, 
     fs2,      fs2fast,   2x2,      gray,
     color,    none,      ordered,  mono,
     ordered2, mbordered, mono2,    halftone

\fBXmNsource\fP
.br
Specifies the source of the image. This is usually the file name of
an MPEG movie. The default is to read the movie from standard input.

\fBXmNshowCount\fP
.br
Specifies the running characteristics of the movie.
If this is zero, show no frames (setting this value pauses the movie
if it is running).
A positive integer shows that number of sequences. A sequence is a small
number of frames.
A value of MPEG_PLAY_TO_END (-1 in resource files) plays from the
current point to the end of the movie.
A value of MPEG_PLAY_FOREVER (-2 in resource files)
plays the movie continuously.

\fBXmNmovieStoppedCallback\fP
.br
Specifies a list of callbacks that is called when the movie stops.
A pointer to a structure of type XmpegCallbackStruct is passed in
the call_data parameter of the function.
This can happen either because the movie has finished, in which case
the reason field in this structure is XmpegMOVIE_FINISHED, or because
the movie has been paused  in which case
the reason field in this structure is XmpegMOVIE_PAUSED.
.SS "Callback Information"
A pointer to the following structure is passed to each callback:
.sS
.iS
.ta .25i 1.1i

typedef struct {
        String  source;
        short   reason;
.br
}   XmpegCallbackStruct; 
.iE
.sE

.SS "Translations"
There are no new translations for Mpeg.
.SS "Bugs"
This widget was implemented by making minimal changes to the mpeg2.0
source code. Because of this, there are a number of global variables,
functions and constants that do not follow normal widget conventions.
Many of the mpeg2.0 options are not supported yet. Shared memory may
not work - it has not been tested.
On stepping through a movie, the number of frames shown per step is
indeterminate.
.nL
.ne 6
.SH RELATED INFORMATION
.na
\*LXmpegPlayMovie(3X)\*O,
\*LXmpegStopMovie(3X)\*0,
\*LXmpegRewindMovie(3X)\*O,
\*LXmpegMovieStatus(3X)\*O
and
\*LXmCreateMpeg(3X)\*O.
.ad