mvBindOpenGLWindow(3dm)mvBindOpenGLWindow(3dm)NAME
mvBindOpenGLWindow, mvUnbindOpenGLWindow - functions to associate movies
with and dissociate movies from playback windows
SYNOPSIS
#include <dmedia/movieplay.h>
DMstatus mvBindOpenGLWindow( MVid movieid, Display* dpy, Window win,
GLXContext ctxt );
DMstatus mvUnbindOpenGLWindow( MVid movieid );
PARAMETERS
movieid
The specified movie instance.
dpy The X display on which the movie instance will appear.
win The X window in which the movie will appear.
ctxt The OpenGL graphics context for the movie.
DESCRIPTIONmvBindOpenGLWindow(3dm) associates a movie with the window and OpenGL
context to be used for movie playback. Internally, the Movie Playback
Library initializes and prepares the movie for playback.
The Movie Playback Library uses the OpenGL graphics library to display
movie frames on screen. Therefore, you must supply an X window that you
have configured for OpenGL. Use the OpenGL calls for window configuration
(see the manual pages for glXGetconfig(3g), glXCreateContext(3g), and
glXChooseVisual(3g)). If your application uses the IRIS IM toolkit
(Silicon Graphics' port of the industry-standard OSF/Motif toolkit for
use on Silicon Graphics systems) or ViewKit, you should use the
GLwCreateMDrawingArea(3X), which will create an OpenGL-based widget for
you.
Because mvBindOpenGLWindow(3dm) performs internal initialization, it must
be invoked on a movie before you make several other playback calls on the
movie.
If the specified movie contains an audio track, mvBindOpenGLWindow(3dm)
will attempt to open an audio port using the Silicon Graphics Audio
Library (AL). If the attempt to open an audio port was successful, the
library will create an audio port with the following format:
movipid:movieid
where pid is the system process ID which is actually using the audio
port, and movieid is the movie ID which contains the sound track being
Page 1
mvBindOpenGLWindow(3dm)mvBindOpenGLWindow(3dm)
played on the port. For more information, see the manual page for the
alOpenPort(3dm) call. If the attempt to open an audio port is
unsuccessful (perhaps there are no free audio ports, or the system you
are using does not have audio capability), the Movie Playback Library
will play the image track of the movie without the accompanying audio
track.
You may bind a movie to only one window at a time. Once you have invoked
mvBindOpenGLWindow(3dm) on a movie it will remain bound to the window
until you call mvUnbindOpenGLWindow(3dm) or mvUnbindWindow(3dm) or close
the movie using mvClose(3dm).
A window may contain more than one movie, i.e. you may bind the same
window to more than one movie.
Before you destroy any window which contains movies, you should either
Dis-associate the movies from the window using mvUnbindOpenGLWindow (or
mvUnbindWindow) or close the movies using mvClose(3dm).
mvBindOpenGLWindow(3dm) and mvUnbindOpenGLWindow(3dm) return DM_SUCCESS
upon success, and DM_FAILURE in the event of error. If an error occurs,
you may call mvGetErrno(3dm) to obtain the code describing the error.
If you plan to play multiple movies at the same time in the same
application, you should advise the Movie Playback Library of the maximum
number of movies. See mvSetNumMoviesHint(3dm).
See mvPort(3dm) for details on how to more accurately control the setup
of the graphics screen, audio, and video output devices.
HARDWARE ACCELERATIONmvBindOpenGLWindow(3dm) may set up the Movie Playback Library engine so
that it will play the requested movie using hardware accelerated
decompression. Currently supported hardware accelerators include Octane
Compression (on Octane with Octane Video).
Hardware accelerated decompression is achieved on these systems using a
memory->decompressor->video out->graphics path. O2's builtin ICE is also
supported, although the data path is memory->decompressor->memory.
If a movie is bound with mvBindOpenGLWindow(3dm) and the movie has a
single IMAGE track in which all frames are compatible with the Octane
Compression Hardware Accelerator, then the Movie Playback Library engine
will attempt to play the movie using Octane Compression if you have set
the hardware acceleration flag for this movie.
Page 2
mvBindOpenGLWindow(3dm)mvBindOpenGLWindow(3dm)
See mvSetMovieHwAcceleration(3dm) for details. (This feature may also be
turned on by setting the MV_TRY_IMPACTCOMP environment variable).
Movies that are successfully bound in this way will be displayed in a
video window that is directly on top of the specified window passed to
mvBindOpenGLWindow(3dm). The movie will also play simulataneously on the
video output port as well. The compression hardware will be kept open by
the Movie Library until the movie is unbound or closed. One caveat is
that, because movies that are played through Octane Compression are
displayed on a window on top of the one passed to
mvBindOpenGLWindow(3dm), any drawing to that window will be obscured by
the video window. Movies that are bound and accelerated using a memory-
>decompressor->memory (e.g. on O2) do not suffer this caveat.
mvBindOpenGLWindow(3dm) only supports playback in singled-buffered OpenGL
GL_RGBA_MODE mode windows. For playing movies in doubled-buffered
windows, see mvOpenPort(3dm).
OSF/Motif is a trademark of the Open Software Foundation, Inc.
ENVIRONMENT
MV_TRY_IMPACTCOMP
SEE ALSOmvClose(3dm), mvIntro(3dm), mvOpen(3dm), mvSetNumMoviesHint(3dm),
mvPort(3dm), mvHwAccel(3dm).
Page 3
