TheoraVideoPlugin Materials        

Example material script

material SimpleVideo
 {
   technique
   {
     pass
     {
       texture_unit
       {
         __texture_source ogg_video__
         __{__
           __filename clip.ogg__
           __precache 16__
           __play_mode play__
         __}__
       }
     }
   }
 }


As you can see, the only difference between a normal OGRE material is located in the texture_unit block.

texture_source
It is very important to append ''ogg_video__ to the end of the line, so OGRE knows which plugin to use.

filename
This is obvious :-) The file can be placed in any location defined in Ogre::ResourceGroupManager, as well as in Zip files or your custom Ogre-compliant resource management method.

play_mode
Determines the starting play state, can be:

  • play - default
  • pause


precache
How many frames should this video render in advance. If not specified, the default is 16.

output
Determines output mode, how Theora's YUV pixels are converted:

  • rgb - default, decodes YUV to RGB via CPU
  • yuv - directly transfers YUV pixels to the texture, useful only if you use shader-based YUV decoding.
  • grey - outputs greyscale pixel (Y channel)


speed
N/A yet.