Informikon

This is an introduction to programming Dowitchers applications. We just wrote the shortest program to display a video. I suppose there is a need for "Tutorial 0" which would explain the basic concepts of programming audio and video on Microsoft with DirectShow: things like media types and samples, pins and filters, and the graph of filters for an application. Maybe I'll just paste in the Introduction to my tutorials "Programming DirectShow application in C#".

The support files (including all the source code) can be found here.

Assuming you have a basic understanding of the previous concepts, we start our program with a declaration of the Dowitchers namespaces:

 // we'll be using these
using Dowitchers;
using Dowitchers.Graph;
using Dowitchers.Filters; 
   

// create a form to display the video
Form form = new Form();
form.Visible = false;
 
// use a panel to fill the form
Panel panel = new Panel();
panel.Parent = form;
panel.Dock = DockStyle.Fill;
 
// the VideoControl handles the repaint event
VideoControl videoControl = new VideoControl();
videoControl.Parent = panel;
videoControl.Dock = DockStyle.Fill; 
   

// create a graph object
Graph graph = new Graph();
try
 {
      // the MDX object that will be used to display the video
      // if your vid card supports ps_2 then can use Direct3DPresenter instead
      IPresenter presenter = new DirectDraw7Presenter(graph, form, videoControl);
 
      // the source filter created from the uri
      IFilter filter;
 
      if (graph.AddSource(new Uri("file:///" + args[0]), out filter))
      {
         // if we recognize the format, render it
         graph.Render(filter);
        // start the graph running
         graph.State = MediaState.Running;
      }
} 
   

We create a Graph object, then a presenter object that wraps the Managed DirectX device used for the application. We are now ready to call the Graph AddSource method to try to identify the media format used and setup the appropriate internal data structures. If this succeeds, we call the Render method with filter object returned by the AddSource method. Then we get the graph running.

We are now ready to display the result and we make sure that when the user closes the window, we stopped all worker threads:

Application.Run(form);
// make sure all worker threads are done executing
graph.State = MediaState.Stopped; 
   

That's it. If you're familiar with DirectShow, you should feel right at home with Dowitchers.

With the Vfw wrapper, you should be able to play most avi files if you have ffshow installed on your machine.

---

Bookmark it...