Class UniversalDemuxBlock

Namespace

VisioForge.Core.MediaBlocks.Sources

Assembly

VisioForge.Core.dll

Universal demultiplexer block for extracting streams from any supported container format. This versatile block automatically detects and parses various container formats (MP4, MKV, AVI, WebM, etc.) and separates them into individual video, audio, subtitle, and metadata streams. Supports multiple streams of each type, automatic format detection, stream selection, and optimized handling based on MediaFileInfo. Essential for general-purpose media playback, transcoding workflows, multi-stream processing, and applications requiring format-agnostic demultiplexing capabilities. Provides comprehensive stream routing with optional null sinks. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class UniversalDemuxBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

object

MediaBlock

UniversalDemuxBlock

Implements

IMediaBlock

IDisposable

IMediaBlockInternals

Inherited Members

MediaBlock._isBuilt

MediaBlock._pipeline

MediaBlock._pipelineCtx

MediaBlock.GetPipelineContext()

MediaBlock.SetPipelineContext(BlockPipelineContext)

MediaBlock.SetPipeline(MediaBlocksPipeline)

MediaBlock.Context

MediaBlock.Name

MediaBlock.IsBuilt

MediaBlock.Owner

MediaBlock.Type

MediaBlock.ID

MediaBlock.Input

MediaBlock.Inputs

MediaBlock.Output

MediaBlock.Outputs

MediaBlock.HasInputs

MediaBlock.HasOutputs

MediaBlock.Build()

MediaBlock.CreateElements()

MediaBlock.AddElementsToPipeline()

MediaBlock.RemoveElementsFromPipeline()

MediaBlock.DeepCopy(string)

MediaBlock.Reset()

MediaBlock.ToYAMLBlock()

MediaBlock.ClearPads()

MediaBlock.Dispose(bool)

MediaBlock.Dispose()

object.Equals(object?)

object.Equals(object?, object?)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object?, object?)

object.ToString()

Extension Methods

MediaBlockExtensions.GetInputPadByType(IMediaBlock, MediaBlockPadMediaType)

MediaBlockExtensions.GetOutputPadByType(IMediaBlock, MediaBlockPadMediaType)

MediaBlockHelper.SendEndOfStream(MediaBlock)

MediaBlockHelper.SendEvent(MediaBlock, Event)

MediaBlockHelper.SetState(MediaBlock, State)

Constructors

UniversalDemuxBlock(IUniversalDemuxSettings, MediaFileInfo, bool, bool, bool, bool)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sources.UniversalDemuxBlock class with custom settings and stream extraction options.

public UniversalDemuxBlock(IUniversalDemuxSettings settings, MediaFileInfo info, bool renderVideo = true, bool renderAudio = true, bool renderSubtitle = false, bool renderMetadata = false)

Parameters

settings IUniversalDemuxSettings

The demuxer configuration settings.

info MediaFileInfo

The media file information containing stream details. Required for proper stream support.

renderVideo bool

if set to true extract and output video streams.

renderAudio bool

if set to true extract and output audio streams.

renderSubtitle bool

if set to true extract and output subtitle streams.

renderMetadata bool

if set to true extract and output metadata streams.

UniversalDemuxBlock(MediaFileInfo, bool, bool, bool, bool)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sources.UniversalDemuxBlock class with default settings and stream extraction options.

public UniversalDemuxBlock(MediaFileInfo info, bool renderVideo = true, bool renderAudio = true, bool renderSubtitle = false, bool renderMetadata = false)

Parameters

info MediaFileInfo

The media file information containing stream details. Required for proper stream support.

renderVideo bool

if set to true extract and output video streams.

renderAudio bool

if set to true extract and output audio streams.

renderSubtitle bool

if set to true extract and output subtitle streams.

renderMetadata bool

if set to true extract and output metadata streams.

Properties

AudioOutputs

Gets all audio output pads for extracted audio streams. The number of pads matches the number of audio streams in the container.

public MediaBlockPad[] AudioOutputs { get; }

Property Value

MediaBlockPad[]

Input

Gets the input.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets the inputs.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

MetadataOutputs

Gets all metadata output pads for extracted metadata streams.

public MediaBlockPad[] MetadataOutputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the output.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets the outputs.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

SubtitleOutputs

Gets all subtitle output pads for extracted subtitle streams. The number of pads matches the number of subtitle streams in the container.

public MediaBlockPad[] SubtitleOutputs { get; }

Property Value

MediaBlockPad[]

Type

Gets the type.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

VideoOutputs

Gets all video output pads for extracted video streams. The number of pads matches the number of video streams in the container.

public MediaBlockPad[] VideoOutputs { get; }

Property Value

MediaBlockPad[]

Methods

Build()

Constructs and initializes the universal demux and all associated queue elements. This method creates the demux element, sets up dynamic pad handlers for each stream type, creates queue or null sink elements based on rendering options, and establishes output connections.

public override bool Build()

Returns

bool

true if the demux was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this universal demux block. This method disposes of the demux element, all queue elements, null renderers, and clears all collections before resetting the build state.

public void CleanUp()

Dispose(bool)

Releases unmanaged and - optionally - managed resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

GetAudioOutput()

Gets the first audio output pad if available. Convenience method for accessing the primary audio stream.

public MediaBlockPad GetAudioOutput()

Returns

MediaBlockPad

The first audio output pad or null if no audio streams.

GetCore()

Gets the core BaseElement wrapper. Returns null as the demux element is accessed directly without a wrapper.

public BaseElement GetCore()

Returns

BaseElement

Always returns null for this implementation.

GetElement()

Gets the underlying GStreamer element that performs the universal demuxing.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the universal demux.

GetMetadataOutput()

Gets the first metadata output pad if available. Convenience method for accessing the primary metadata stream.

public MediaBlockPad GetMetadataOutput()

Returns

MediaBlockPad

The first metadata output pad or null if no metadata streams.

GetSubtitleOutput()

Gets the first subtitle output pad if available. Convenience method for accessing the primary subtitle stream.

public MediaBlockPad GetSubtitleOutput()

Returns

MediaBlockPad

The first subtitle output pad or null if no subtitle streams.

GetVideoOutput()

Gets the first video output pad if available. Convenience method for accessing the primary video stream.

public MediaBlockPad GetVideoOutput()

Returns

MediaBlockPad

The first video output pad or null if no video streams.

IsAvailable(IUniversalDemuxSettings)

Determines whether this media block is available. Correct NuGet SDK redist should be included into your project. Checks for required demuxer plugins based on the specified settings.

public static bool IsAvailable(IUniversalDemuxSettings settings)

Parameters

settings IUniversalDemuxSettings

The demuxer settings to check availability for.

Returns

bool

true if this media block is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this universal demux block with a pipeline and initializes its internal context. This method is called internally when the block is added to a pipeline.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The MediaBlocksPipeline instance that will manage this block.

See Also

MediaBlock

IMediaBlockInternals

IDisposable