mvHwAccel(3dm)                                                  mvHwAccel(3dm)


NAME
     mvGetMovieHwAcceleration, mvSetMovieHwAcceleration - Set/get movie
     hardware acceleration


SYNOPSIS
     #include <dmedia/moviefile.h>

     DMstatus mvGetMovieHwAcceleration( MVid movie, DMboolean *hasHw );

     DMstatus mvSetMovieHwAcceleration( MVid movie, DMboolean tryHw );


DESCRIPTION
     mvSetMovieHwAcceleration(3dm) should be used to tell the Movie Playback
     Library to use hardware acceleration when available for a given movie.
     mvSetMovieHwAcceleration(3dm) must not be called while a movie is
     currently bound to a window (or port).

     Calling this routine with a tryHw value of DM_TRUE does NOT insure that
     hardware acceleration will actually be used.  An application can
     determine whether or not acceleration is actually used by calling
     mvGetMovieHwAcceleration(3dm).

     Binding a movie to a window may change the state of the hardware
     acceleration for that movie.  In other words, the Movie Playback Library
     may decide to not use hardware acceleration for a movie once it is bound.


DEFAULTS
     The default use of hardware acceleration is system dependent.  On systems
     with ICE hardware (O2), the default is to use hardware acceleration when
     the movie is compatible with the hardware.  On all other systems, the
     default is not to use hardware acceleration.


SUPPORTED HARDWARE
     Octane Compression (optional for Octane systems) is supported.  Octane
     Compression will only be used when Octane Video is also available.  Only
     one movie can use this hardware at a time.  Furthermore, the accelerator
     is only used for JPEG movies that are compatible with the Octane
     Compression hardware.  Octane Compresssion supports both SGI JPEG and
     QuickTime MJPEG A field based movies.


     The ICE hardware is supported on O2 systems.  This accelerator is only
     used for DIF streams (DV, DVCPROC) or JPEG movies that are compatible
     with the ICE hardware.  There is a finite (but large) maximum number of
     simultaneous ICE connections.  ICE supports SGI JPEG and QuickTime MJPEG
     A movies as well as DIF streams (DV, DVCPRO).


SEE ALSO
     cl_impactcomp(dm), dmic(dm), mvIntro(3dm), mvBindOpenGLWindow(3dm).


                                                                        Page 2