TheoraVideoPlugin Materials

From Ogre Wiki

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.