Difference between revisions of "Tutorial"

From Theora Playback Library
Jump to: navigation, search
(added updating section)
(updating)
Line 20: Line 20:
 
  }
 
  }
  
== updating ==
+
== Updating ==
  
 
Be sure to update the [http://libtheoraplayer.sourceforge.net/api/html/class_theora_video_manager.html TheoraVideoManager] each frame to advance the current time for playing videos:
 
Be sure to update the [http://libtheoraplayer.sourceforge.net/api/html/class_theora_video_manager.html TheoraVideoManager] each frame to advance the current time for playing videos:

Revision as of 10:09, 3 January 2010

The first thing you need to do is download the latest compiled sdk or source tarball from the Releases page.

Init

To initialise the library, create an instance of the TheoraVideoManager class:

TheoraVideoManager *mgr=new TheoraVideoManager();

Loading video

TheoraVideoClip *clip=mgr->createVideoClip("path/to/video/file.ogg");

Grabbing frames

TheoraVideoFrame *frame=clip->getNextFrame();
if (frame)
{
    // transfer the frame pixels to your display device, texure, graphical context or whatever you use.
    clip->popFrame(); // be sure to pop the frame from the frame queue when you're done
}

Updating

Be sure to update the TheoraVideoManager each frame to advance the current time for playing videos:

mgr->update(time_increase);

time_increase can be computed by grabbing the current time (eg. GetTickCount() on Windows) and substracting the previous frame's time stamp from it.

Audio

Theora Playback Library features an abstracted audio interface, see Audio/Video Player demo for more information.

Destruction

When you destroy the TheoraVideoManager, all video clip objects get destroyed along with it.

delete mgr;