Table of Contents

Class CustomFormatSettingsDialog

Namespace
VisioForge.Core.UI.WinForms.Dialogs.OutputFormats
Assembly
VisioForge.Core.dll

Windows Forms dialog for configuring custom output format settings. Provides a comprehensive interface for configuring video and audio encoders, multiplexer filters, and file writer options for custom media output formats.

public class CustomFormatSettingsDialog : Form, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl

Inheritance

Implements

Inherited Members

Extension Methods

Remarks

This dialog allows users to configure custom output formats by selecting:

  • Video encoders from either Video Codecs or DirectShow Filters categories
  • Audio encoders from either Audio Codecs or DirectShow Filters categories
  • Multiplexer filters for combining video and audio streams
  • Special file writer filters when needed The dialog supports configuration for DirectCaptureMP4Output, DirectCaptureCustomOutput, and CustomOutput formats.

Constructors

CustomFormatSettingsDialog(string[], string[], string[])

Initializes a new instance of the VisioForge.Core.UI.WinForms.Dialogs.OutputFormats.CustomFormatSettingsDialog class with specified codec and filter arrays. Creates the dialog with pre-defined lists of available codecs and DirectShow filters.

public CustomFormatSettingsDialog(string[] videoCodecs, string[] audioCodecs, string[] dsFilters)

Parameters

videoCodecs string[]

Array of available video codec names to populate the video codec dropdown.

audioCodecs string[]

Array of available audio codec names to populate the audio codec dropdown.

dsFilters string[]

Array of available DirectShow filter names to populate filter dropdowns.

Remarks

This constructor is useful when you have pre-obtained codec and filter lists. The dialog will be populated with these options and default settings will be applied.

CustomFormatSettingsDialog(VideoCaptureCore)

Initializes a new instance of the VisioForge.Core.UI.WinForms.Dialogs.OutputFormats.CustomFormatSettingsDialog class using a VideoCaptureCore instance. Automatically retrieves available codecs and DirectShow filters from the capture core.

public CustomFormatSettingsDialog(VideoCaptureCore core)

Parameters

core VideoCaptureCore

The video capture core instance to query for available codecs and filters.

Remarks

This constructor queries the VideoCaptureCore for available codecs and DirectShow filters, ensuring the dialog shows only options that are actually available on the current system for video capture operations.

CustomFormatSettingsDialog(VideoEditCore)

Initializes a new instance of the VisioForge.Core.UI.WinForms.Dialogs.OutputFormats.CustomFormatSettingsDialog class using a VideoEditCore instance. Automatically retrieves available codecs and DirectShow filters from the edit core.

public CustomFormatSettingsDialog(VideoEditCore core)

Parameters

core VideoEditCore

The video edit core instance to query for available codecs and filters.

Remarks

This constructor queries the VideoEditCore for available codecs and DirectShow filters, ensuring the dialog shows only options that are actually available on the current system for video editing operations.

Methods

Dispose(bool)

Clean up any resources being used by the custom format settings dialog. Disposes of managed resources including UI components when disposing is true.

protected override void Dispose(bool disposing)

Parameters

disposing bool

true if managed resources should be disposed; otherwise, false.

Remarks

This method is called by the Dispose() method and the finalizer. When disposing is true, it's safe to dispose of managed resources.

LoadSettings(DirectCaptureMP4Output)

Loads settings from a DirectCaptureMP4Output configuration object into the dialog controls. Configures the dialog for MP4 direct capture output settings.

public void LoadSettings(DirectCaptureMP4Output directCaptureOutput)

Parameters

directCaptureOutput DirectCaptureMP4Output

The DirectCaptureMP4Output configuration object containing settings to load.

Remarks

This method specifically handles DirectCaptureMP4Output settings, focusing on audio codec configuration since MP4 direct capture typically uses hardware-accelerated video encoding.

LoadSettings(DirectCaptureCustomOutput)

Loads settings from a DirectCaptureCustomOutput configuration object into the dialog controls. Configures the dialog for custom direct capture output settings.

public void LoadSettings(DirectCaptureCustomOutput directCaptureOutput)

Parameters

directCaptureOutput DirectCaptureCustomOutput

The DirectCaptureCustomOutput configuration object containing settings to load.

Remarks

This method handles comprehensive custom direct capture settings including video and audio codec selection, multiplexer configuration, and file writer options.

LoadSettings(CustomOutput)

Loads settings from a CustomOutput configuration object into the dialog controls. Configures the dialog for general custom output settings.

public void LoadSettings(CustomOutput customOutput)

Parameters

customOutput CustomOutput

The CustomOutput configuration object containing settings to load.

Remarks

This method handles general custom output settings including video and audio codec selection, multiplexer configuration, and file writer options for non-direct capture scenarios.

SaveSettings(ref DirectCaptureMP4Output)

Saves settings from the dialog controls into a DirectCaptureMP4Output configuration object. Transfers current dialog settings to the DirectCaptureMP4Output configuration.

public void SaveSettings(ref DirectCaptureMP4Output directCaptureOutput)

Parameters

directCaptureOutput DirectCaptureMP4Output

The DirectCaptureMP4Output configuration object to update with current dialog settings.

Remarks

This method transfers audio codec settings from the dialog to the DirectCaptureMP4Output object, configuring whether to use Audio Codecs or DirectShow Filters category for audio encoding.

SaveSettings(ref DirectCaptureCustomOutput)

Saves settings from the dialog controls into a DirectCaptureCustomOutput configuration object. Transfers all current dialog settings to the DirectCaptureCustomOutput configuration.

public void SaveSettings(ref DirectCaptureCustomOutput directCaptureOutput)

Parameters

directCaptureOutput DirectCaptureCustomOutput

The DirectCaptureCustomOutput configuration object to update with current dialog settings.

Remarks

This method transfers comprehensive custom direct capture settings including video and audio codec selection, multiplexer configuration, and file writer options from the dialog controls.

SaveSettings(ref CustomOutput)

Saves settings from the dialog controls into a CustomOutput configuration object. Transfers all current dialog settings to the CustomOutput configuration.

public void SaveSettings(ref CustomOutput customOutput)

Parameters

customOutput CustomOutput

The CustomOutput configuration object to update with current dialog settings.

Remarks

This method transfers comprehensive custom output settings including video and audio codec selection, multiplexer configuration, and file writer options from the dialog controls.