FrameFlux.Wpf 0.1.1

FrameFlux.Wpf

Reusable WPF controls for FrameFlux media playback.

The control is backend-neutral. Reference a backend package and inject its factory during application setup:

Player.PlayerFactory = new FfmpegMediaPlayerFactory();

<frameFlux:MediaView
    Source="{Binding Source}"
    AutoPlay="True"
    Volume="{Binding Volume}"
    IsMuted="{Binding IsMuted}"
    Stretch="Uniform" />

The current FFmpeg backend supports RTSP and RTSPS sources. The control uses the protocol-neutral MediaSource contract so local files and additional media backends can be added without changing the WPF control API.

For end-to-end Windows hardware playback, set MediaView.PresentationMode to NativeSurface or GpuComposition and select a hardware-capable OpenOptions.Video.DecodingPolicy. Both modes accept lease-based D3D11VA frames without reading them back to the CPU.

NativeSurface presents through a DXGI swap chain hosted in a child HWND and remains the minimum-latency option. WPF elements cannot reliably cover that child window because of HWND airspace rules.

GpuComposition converts each decoder texture into a shared BGRA texture, opens it through D3D9Ex, and supplies its surface to WPF D3DImage. Additional children declared inside MediaView can therefore render above the video. Explicit NativeSurface playback is rejected when overlay children exist.

Use Automatic or SoftwareBitmap presentation when portable BGRA frame delivery and snapshot support are required. All three outputs use the same lease-based IMediaVideoOutput contract.

Player.OpenOptions = new MediaOpenOptions
{
    Video = new MediaVideoOptions
    {
        DecodingPolicy = MediaVideoDecodingPolicy.HardwarePreferred
    }
};
Player.PresentationMode = MediaVideoPresentationMode.GpuComposition;

Automatic presentation chooses GpuComposition for a dedicated Windows session with hardware-capable decoding, and SoftwareBitmap otherwise. Explicit GPU modes throw when their requirements are not met. If HardwarePreferred falls back to software, the adaptive output updates EffectivePresentationMode to SoftwareBitmap. Use the read-only IsHardwareVideoDecodingActive and VideoDecoderDiagnostics properties for runtime diagnostics.

FrameReceived exposes managed frames when the active output delivers them. Subscriber exceptions are isolated so one observer cannot block the others.

The WPF bitmap, D3DImage, and native HwndHost outputs own only framework integration and latest-frame queues. Win32 and D3D11 video processing resources live in the shared FrameFlux.Rendering.Windows package.