Microsoft DirectX 8.1 (C++)

RenderEngine Object

Renders a DirectShow Editing Services (DES) project by constructing a filter graph from a timeline.

DES provides two objects that rendering timelines:

The RenderEngine object creates uncompressed output. You can use the output for preview, or route it through compression filters and write it to a file.
The SmartRenderEngine object 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.

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 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.

This object has the following methods.

Method	Description
Commit	Not supported for Visual Basic.
ConnectFrontEnd	Builds the front end of the filter graph from the current timeline.
Decommit	Not supported for Visual Basic.
DoSmartRecompression	Not supported for Visual Basic.
GetCaps	Not supported for Visual Basic.
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.
SetDynamicReconnectLevel	Sets the level of dynamic reconnection during rendering.
SetFilterGraph	Specifies a filter graph for the render engine to use.
SetInterestRange	Not supported for Visual Basic.
SetInterestRange2	Not supported for Visual Basic.
SetRenderRange	Not supported for Visual Basic.
SetRenderRange2	Sets the range of time on the timeline to be rendered.
SetSourceConnectCallback	Not supported for Visual Basic.
SetSourceNameValidation	Specifies how the render engine validates file names.
SetTimelineObject	Sets the timeline for the render engine to use.
ScrapIt	Discards the render engine's filter graph and all associated objects.
UseInSmartRecompressionGraph	Not supported for Visual Basic.

Requirements

Include a reference in your project to "Dexter 1.0 Type Library" (Qedit.dll).