Class MP4OutputBlock

Namespace

VisioForge.Core.MediaBlocks.Sinks

Assembly

VisioForge.Core.dll

MP4 multimedia container output block for creating industry-standard MP4 video files with integrated encoding capabilities. Provides comprehensive MP4 file creation with configurable video and audio encoders, supporting H.264/H.265 video with AAC/MP3 audio for professional video production, streaming content preparation, and multimedia distribution with broad device compatibility. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class MP4OutputBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals, IMediaBlockDynamicInputs

Inheritance

object

MediaBlock

MP4OutputBlock

Implements

IMediaBlock

IDisposable

IMediaBlockInternals

IMediaBlockDynamicInputs

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

MP4OutputBlock(string)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sinks.MP4OutputBlock class with default H.264 and AAC encoders. Creates an MP4 output block configured for high-quality video production with industry-standard codecs.

public MP4OutputBlock(string filename)

Parameters

filename string

The output MP4 file path where the encoded multimedia content will be written.

MP4OutputBlock(MP4SinkSettings, IH264EncoderSettings, IAACEncoderSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sinks.MP4OutputBlock class with custom H.264 and AAC encoder settings. Provides full control over video and audio compression parameters for professional MP4 file creation.

public MP4OutputBlock(MP4SinkSettings sinkSettings, IH264EncoderSettings h264settings, IAACEncoderSettings aacSettings)

Parameters

sinkSettings MP4SinkSettings

The MP4 container sink settings defining output file configuration.

h264settings IH264EncoderSettings

The H.264 video encoder settings controlling video compression quality and parameters.

aacSettings IAACEncoderSettings

The AAC audio encoder settings controlling audio compression quality and parameters.

MP4OutputBlock(MP4SinkSettings, IH264EncoderSettings, MP3EncoderSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sinks.MP4OutputBlock class with H.264 video and MP3 audio encoders. Provides widely compatible MP4 output with H.264 video compression and MP3 audio for broad device support.

public MP4OutputBlock(MP4SinkSettings sinkSettings, IH264EncoderSettings h264settings, MP3EncoderSettings mp3Settings)

Parameters

sinkSettings MP4SinkSettings

The MP4 container sink settings defining output file configuration.

h264settings IH264EncoderSettings

The H.264 video encoder settings controlling video compression quality and parameters.

mp3Settings MP3EncoderSettings

The MP3 audio encoder settings controlling audio compression quality and parameters.

MP4OutputBlock(MP4SinkSettings, IHEVCEncoderSettings, IAACEncoderSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sinks.MP4OutputBlock class with HEVC/H.265 video and AAC audio encoders. Provides next-generation video compression with HEVC for superior quality at lower bitrates with AAC audio.

public MP4OutputBlock(MP4SinkSettings sinkSettings, IHEVCEncoderSettings h264settings, IAACEncoderSettings aacSettings)

Parameters

sinkSettings MP4SinkSettings

The MP4 container sink settings defining output file configuration.

h264settings IHEVCEncoderSettings

The HEVC/H.265 video encoder settings controlling advanced video compression quality and parameters.

aacSettings IAACEncoderSettings

The AAC audio encoder settings controlling audio compression quality and parameters.

MP4OutputBlock(MP4SinkSettings, IHEVCEncoderSettings, MP3EncoderSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.Sinks.MP4OutputBlock class with HEVC/H.265 video and MP3 audio encoders. Provides next-generation video compression with HEVC for superior quality at lower bitrates with MP3 audio.

public MP4OutputBlock(MP4SinkSettings sinkSettings, IHEVCEncoderSettings h264settings, MP3EncoderSettings mp3Settings)

Parameters

sinkSettings MP4SinkSettings

The MP4 container sink settings defining output file configuration.

h264settings IHEVCEncoderSettings

The HEVC/H.265 video encoder settings controlling advanced video compression quality and parameters.

mp3Settings MP3EncoderSettings

The MP3 audio encoder settings controlling audio compression quality and parameters.

Properties

Input

Gets the primary input pad (first in the collection of dynamic inputs).

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets all input pads available on this block (dynamic collection for video and audio).

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the primary output pad (none for output blocks that write to files).

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads available on this block (none for output blocks).

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Type

Gets the media block type identifier for MP4 output operations.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Builds and initializes the MP4 output block within the pipeline context. Creates the MP4 sink, video and audio encoders, and establishes all necessary connections for encoding and writing multimedia content to the MP4 file.

public override bool Build()

Returns

bool

true if the MP4 output block was successfully built and configured; otherwise, false.

CleanUp()

Cleans up all resources associated with the MP4 output operations, including encoders, sink, and file handles.

public void CleanUp()

CreateNewInput(MediaBlockPadMediaType)

Creates a new input pad for the specified media type, enabling dynamic addition of video and audio streams.

public MediaBlockPad CreateNewInput(MediaBlockPadMediaType mediaType)

Parameters

mediaType MediaBlockPadMediaType

The type of media (Video, Audio, or Subtitle) for the new input pad.

Returns

MediaBlockPad

A new MediaBlockPad configured for the specified media type.

Dispose(bool)

Releases unmanaged and managed resources used by the MP4 output block. Properly disposes of GStreamer elements, encoders, and file writing resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

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

GetCore()

Gets the core GStreamer element wrapper for advanced configuration and monitoring.

public BaseElement GetCore()

Returns

BaseElement

Always null for composite output blocks with multiple internal elements.

GetElement()

Gets the native GStreamer element for direct GStreamer pipeline integration.

public Element GetElement()

Returns

Element

Always null for composite output blocks with multiple internal elements.

GetFilenameOrURL()

Gets the current output filename or URL where the MP4 content is being written.

public string GetFilenameOrURL()

Returns

string

The file path or URL string for the MP4 output destination.

GetInput(MediaBlockPadMediaType)

Retrieves an existing input pad for the specified media type from the current collection.

public MediaBlockPad GetInput(MediaBlockPadMediaType mediaType)

Parameters

mediaType MediaBlockPadMediaType

The type of media (Video, Audio, or Subtitle) to search for.

Returns

MediaBlockPad

The first matching MediaBlockPad for the specified media type, or null if not found.

IsAvailable(IH264EncoderSettings, IAACEncoderSettings)

Determines whether MP4 output functionality is available on the current system with the specified encoder settings. Requires GStreamer MP4 muxer and the specified video and audio encoder plugins to be installed and functional.

public static bool IsAvailable(IH264EncoderSettings h264settings, IAACEncoderSettings aacSettings)

Parameters

h264settings IH264EncoderSettings

The H.264 video encoder settings to validate for availability.

aacSettings IAACEncoderSettings

The AAC audio encoder settings to validate for availability.

Returns

bool

true if MP4 output with the specified encoders is supported; otherwise, false.

SetFilenameOrURL(string)

Updates the output filename or URL for the MP4 file destination, allowing dynamic output redirection.

public void SetFilenameOrURL(string value)

Parameters

value string

The new file path or URL where MP4 content should be written.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Sets the pipeline context for this MP4 output block, providing access to the parent pipeline and logging context.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The parent MediaBlocks pipeline containing this MP4 output block.

See Also

MediaBlock

IMediaBlockInternals

IDisposable