Enum VideoRendererMode

Namespace

VisioForge.Core.Types

Assembly

VisioForge.Core.dll

Specifies the video rendering engine to be used for displaying video frames. The choice of renderer can impact performance, compatibility, and available features.

public enum VideoRendererMode

Fields

VideoRenderer = 0

The legacy Video Renderer, primarily available for WinForms applications. This renderer is deprecated and generally not recommended for new development.

VMR9 = 1

Video Mixing Renderer 9, available for WinForms applications. Offers improved video mixing capabilities compared to the legacy Video Renderer.

EVR = 2

Enhanced Video Renderer (EVR), available on Windows Vista and later. This is a modern renderer offering better performance and quality, especially with hardware acceleration. Available for WinForms applications.

None = 3

No video renderer is used. This might be chosen when only audio processing or file saving is required, or when a custom rendering solution is implemented.

WPF_WinUI_Callback = 4

A rendering mode suitable for WPF, WinUI, or custom callback-based rendering scenarios. This mode typically involves receiving video frames as callbacks for manual rendering.

WPF_NativeHWND = 5

A rendering mode for WPF applications that uses a native HWND (window handle) for rendering. This can offer better performance and compatibility with certain video sources or effects.

Direct2D = 6

Direct2D renderer, offering high-performance 2D graphics rendering. Available for both WinForms and WPF applications.

Direct2DManaged = 7

A managed Direct2D renderer, specifically designed for WPF applications.

MadVR = 8

madVR renderer, a high-quality video renderer known for its advanced scaling and rendering algorithms. Primarily available for WinForms applications.

WinUI = 9

The WinUI 3 renderer, designed for applications built with the WinUI 3 framework.

FrameCallback = 4

An alias for VisioForge.Core.Types.VideoRendererMode.WPF_WinUI_Callback, indicating a mode where video frames are delivered via callbacks for custom rendering.

Remarks

Different rendering modes are optimized for various platforms and scenarios. Some renderers are specific to Windows (WinForms, WPF, WinUI) while others might be more generic or callback-based. EVR (Enhanced Video Renderer) is the modern Windows renderer offering hardware acceleration and is recommended for Windows Vista and later. VMR9 (Video Mixing Renderer 9) is an older renderer still useful for Windows XP compatibility. Direct2D renderers provide high-performance 2D graphics with GPU acceleration, suitable for both WinForms and WPF. WPF_WinUI_Callback and FrameCallback modes deliver raw frames to application code for custom rendering or processing. WPF_NativeHWND uses a native window handle for rendering in WPF, offering better performance than pure WPF rendering. madVR is a third-party high-quality renderer known for superior scaling algorithms and color management. None mode is used when no video rendering is needed (audio-only, file conversion, etc.). The choice depends on target platform, required features, and performance characteristics.