Skip to main content

History: TheoraVideoPlugin Materials

Source of version: 3 (current)

Copy to clipboard
            !!Example material script
{CODE(wrap="1",colors="c++",wiki="1")} material SimpleVideo
 {
   technique
   {
     pass
     {
       texture_unit
       {
         __texture_source ogg_video__
         __{__
           __filename clip.ogg__
           __precache 16__
           __play_mode play__
         __}__
       }
     }
   }
 }{CODE}

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 ((TheoraVideoPlugin Shaders|shader-based YUV decoding)).
* grey - outputs greyscale pixel (Y channel)

__ speed __
N/A yet.