Share via


IRenderEngine Interface

 
Microsoft DirectShow 9.0

IRenderEngine Interface

The IRenderEngine interface renders a DirectShow Editing Services (DES) project by constructing a filter graph from a timeline .

DES provides two components that implement this interface:

  • The basic render engine creates uncompressed output. You can use the output for preview, or route it through compression filters and write it to a file.
  • The smart render engine creates compressed output, using smart recompression . With smart recompression, a source file is recompressed only if its format differs from the output format. A source with a matching format is written directly to the output file. Depending on the scenario, smart recompression can greatly improve rendering time.

The smart render engine also supports the ISmartRenderEngine interface.

Although an application can create a filter graph and pass it to a render engine, the typical scenario is for the render engine to create the filter graph. Building the graph is a two-stage process. First, build the front end by calling the IRenderEngine::ConnectFrontEnd method. Then connect the output pins on the front end to the desired rendering filters:

  • Video and audio renderers for preview, or
  • Compressors, multiplexers, and file writers to generate the final output.

In addition to the methods inherited from IUnknown, the IRenderEngine interface exposes the following methods.

Method Description
Commit Not implemented.
ConnectFrontEnd Builds the front end of the filter graph from the current timeline.
Decommit Not implemented.
DoSmartRecompression Not supported.
GetCaps Not implemented.
GetFilterGraph Retrieves the filter graph that the render engine has constructed, if any.
GetGroupOutputPin Retrieves the output pin for the specified group.
GetTimelineObject Retrieves the timeline that the render engine is currently using.
GetVendorString Retrieves the vendor string.
RenderOutputPins Creates the previewing portion of the filter graph.
ScrapIt Discards the render engine's filter graph and all associated objects.
SetDynamicReconnectLevel Sets the level of dynamic reconnection during rendering.
SetFilterGraph Specifies a filter graph for the render engine to use.
SetInterestRange Not supported.
SetInterestRange2 Not supported.
SetRenderRange Sets the range of time to be rendered.
SetRenderRange2 Sets the range of time to be rendered, as a double.
SetSourceConnectCallback Not supported.
SetSourceNameValidation Specifies how the render engine validates file names.
SetTimelineObject Sets the timeline for the render engine to use.
UseInSmartRecompressionGraph Not supported.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also