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 DMTRUE 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
     Cosmo Compress (optional for Indy systems) is supported.  Cosmp Compress
     will only be used when Indy Video or Indy Video 601 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
     Comso Compress/Indy Video hardware. Cosmo Compress does NOT support
     QuickTime MJPEG A.


     Impact Compression (optional for Indigo2 systems) is supported.  Impact
     Compression will only be used when Impact 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 Impact
     Compression hardware.  Impact Compresssion supports both SGI JPEG and
     QuickTime MJPEG A field based movies.



                                                                        Page 1

mvHwAccel(3dm)                                                  mvHwAccel(3dm)



     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
     clcosmo(dm), climpactcomp(dm), dmic(dm), mvIntro(3dm),
     mvBindOpenGLWindow(3dm).





































                                                                        Page 2