Enum MediaPlayerSourceMode

Namespace

VisioForge.Core.Types.MediaPlayer

Assembly

VisioForge.Core.dll

Specifies the source mode for Media Player SDK .NET, determining which underlying technology and filters are used for media playback.

public enum MediaPlayerSourceMode

Fields

File_DS = 0

File playback using DirectShow framework.

Uses Windows DirectShow API for media playback. Provides native Windows integration and supports installed DirectShow codecs and filters. Best for standard media formats on Windows platforms with good system codec support.

FFMPEG = 1

FFMPEG-based source for files and network streams.

Uses the FFMPEG library for media decoding and demuxing. Provides excellent format support including rare and professional codecs. Supports both local files and network streams (HTTP, RTSP, RTMP, etc.). Cross-platform compatible and doesn't rely on system codecs.

File_VLC = 2

File playback using VLC engine.

Uses the VLC media player engine (libVLC) for playback. Provides robust playback capabilities with built-in codecs. Good for scenarios where VLC's specific features or codec support is needed. Supports a wide range of formats without requiring system codecs.

Memory_DS = 3

Memory stream playback using DirectShow.

Allows playback from in-memory streams using DirectShow. Useful for playing media data that is already loaded in memory or generated on-the-fly. Requires IStream interface implementation. The stream must be seekable for most media formats.

DVD_DS = 4

DVD disc playback using DirectShow.

Specialized mode for playing DVD discs with full menu support, navigation, and chapter selection. Uses DirectShow DVD Navigator filter. Requires DVD decoding capabilities on the system (either software or hardware DVD decoder).

MMS_WMV_DS = 5

MMS/WMV network stream playback using DirectShow.

Optimized for Microsoft Media Server (MMS) protocol and Windows Media Video (WMV) streams. Uses Windows Media Foundation or DirectShow filters for streaming Windows Media content. Best for legacy Windows Media streaming scenarios.

HTTP_RTSP_VLC = 6

HTTP/RTSP stream playback using VLC engine.

Uses VLC's networking capabilities for HTTP and RTSP stream playback. Provides robust network stream handling with automatic reconnection, buffering, and protocol support. Ideal for IP cameras, streaming servers, and live broadcasts.

Encrypted_File_DS = 7

Encrypted video file playback using DirectShow.

Supports playback of encrypted or DRM-protected media files using DirectShow. Requires appropriate decryption filters or DRM components to be installed. Used for playing protected content with proper authorization.

CustomSource = 8

Custom DirectShow source filter specified by CLSID.

Allows using a custom DirectShow source filter by specifying its CLSID. Useful for proprietary formats or specialized hardware that provides custom filters. The specified filter must be properly registered on the system.

LAV = 9

LAV Filters pack for files and network streams.

Uses the popular open-source LAV Filters for media playback. Provides high-quality video decoding with hardware acceleration support. Excellent for modern codecs like H.264, HEVC, AV1. Supports both local files and various network protocols.

BluRay = 10

Blu-ray disc playback using LAV Filters.

Specialized mode for Blu-ray disc playback using LAV Filters. Supports Blu-ray folder structures and ISO files. Provides menu navigation and chapter support. May require additional libraries for encrypted Blu-ray discs.

Timeshift = 11

Live timeshift source file created by Video Capture SDK .NET.

Plays special timeshift files created by VisioForge Video Capture SDK during live recording. Allows playing a file while it's still being recorded, enabling time-shifting functionality for live TV or surveillance scenarios.

MIDI = 12

MIDI and Karaoke file playback engine.

Specialized playback mode for MIDI music files and Karaoke formats (like CDG+MP3). Supports MIDI synthesis, lyrics display, and karaoke-specific features. Uses Windows MIDI subsystem or custom MIDI rendering engines.

GPU = 13

GPU-accelerated video decoding mode.

Enables hardware-accelerated video decoding using available GPU technologies. Automatically selects from DXVA2, NVIDIA CUVID, Intel Quick Sync, or Direct3D 11 based on hardware availability. Significantly reduces CPU usage for supported codecs. Falls back to software decoding if hardware acceleration is unavailable.

Remarks

The Media Player SDK supports multiple playback engines and technologies. This enumeration allows you to select the most appropriate one based on your requirements for format support, performance, platform compatibility, and special features.