PreferredMPEG2Splitter Property (ConvertCtrl)

Visual Basic
C#
C++/CLI

'Declaration
 
Public Overridable Property PreferredMPEG2Splitter As String

'Usage
 
Dim instance As ConvertCtrl
Dim value As String
 
instance.PreferredMPEG2Splitter = value
 
value = instance.PreferredMPEG2Splitter

public virtual string PreferredMPEG2Splitter {get; set;}

public:
virtual property String^ PreferredMPEG2Splitter {
   String^ get();
   void set (    String^ value);
}

Property Value

Constants.Filter_MPEG2_Splitter	Microsoft MPEG-2 Splitter.
Constants.Filter_MPEG2_Demux	Microsoft MPEG-2 Demultiplexer.

Gets or sets the preferred MPEG2 splitter display name. A display name uniquely identifies the splitter (or any filter). Display names for software splitters have the following format: @device:sw:GUID\\GUID. For example, Microsoft's 'MPEG-2 Splitter' display name is: @device:sw:{083863F1-70DE-11D0-BD40-00A0C911CE86}\\{3AE86B20-7BE8-11D1-ABE6-00A0C905F375}

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Multimedia
Imports LeadtoolsMultimediaExamples.Fixtures

Public _result As Boolean = False
Public _form As ConvertCtrlForm = New ConvertCtrlForm()
' input and output file names
Private _inFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.mpeg")
Private _outFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_PreferredMPEG2SplitterExample.avi")

Public Sub PreferredMPEG2SplitterExample()
   ' reference the convert control
   Dim convertctrl As ConvertCtrl = _form.ConvertCtrl

   Try
      ' set the source file
      convertctrl.SourceFile = _inFile

      ' select video and audio compressors
      convertctrl.VideoCompressors.Mpeg2.Selected = True
      convertctrl.AudioCompressors.AC3.Selected = True

      ' set the target file and format
      convertctrl.TargetFile = _outFile
      convertctrl.TargetFormat = TargetFormatType.AVI

      ' set the preferred MPEG2 splitter to be the LEAD MPEG2 Transport Demultiplexer.
      ' this avoids a rogue filter with a higher merit from being used to play MPEG2 files.
      convertctrl.PreferredMPEG2Splitter = Leadtools.Multimedia.Constants.Filter_MPEG2_Transport_Demux

      ' subscribe to the complete event to check our result
      AddHandler convertctrl.Complete, AddressOf ConvertCtrl_Complete

      ' set the allowed streams
      convertctrl.AllowedStreams = StreamFormatType.AudioVideoCC

      ' convert it!
      convertctrl.StartConvert()
   Catch e1 As Exception
      _result = False
   End Try

   ' we'll loop on the state and pump messages for this example.
   ' but you should not need to if running from a Windows Forms application.
   Do While convertctrl.State = ConvertState.Running
      Application.DoEvents()
   Loop
End Sub

Private Sub ConvertCtrl_Complete(ByVal sender As Object, ByVal e As EventArgs)
   ' set the result
   _result = File.Exists(_outFile)
End Sub

Public NotInheritable Class LEAD_VARS
Public Const MediaDir As String = "C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 18\Media"
End Class

using Leadtools;
using Leadtools.Multimedia;
using LeadtoolsMultimediaExamples.Fixtures;

public bool _result = false;
public ConvertCtrlForm _form = new ConvertCtrlForm();
// input and output file names
string _inFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_Source.mpeg");
string _outFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_PreferredMPEG2SplitterExample.avi");

public void PreferredMPEG2SplitterExample()
{
   // reference the convert control
   ConvertCtrl convertctrl = _form.ConvertCtrl;

   try
   {
      // set the source file
      convertctrl.SourceFile = _inFile;

      // select video and audio compressors
      convertctrl.VideoCompressors.Mpeg2.Selected = true;
      convertctrl.AudioCompressors.AC3.Selected = true;

      // set the target file and format
      convertctrl.TargetFile = _outFile;
      convertctrl.TargetFormat = TargetFormatType.AVI;

      // set the preferred MPEG2 splitter to be the LEAD MPEG2 Transport Demultiplexer.
      // this avoids a rogue filter with a higher merit from being used to play MPEG2 files.
      convertctrl.PreferredMPEG2Splitter = Constants.Filter_MPEG2_Transport_Demux;

      // subscribe to the complete event to check our result
      convertctrl.Complete += new EventHandler(ConvertCtrl_Complete);

      // set the allowed streams
      convertctrl.AllowedStreams = StreamFormatType.AudioVideoCC;

      // convert it!
      convertctrl.StartConvert();
   }
   catch (Exception)
   {
      _result = false;
   }

   // we'll loop on the state and pump messages for this example.
   // but you should not need to if running from a Windows Forms application.
   while (convertctrl.State == ConvertState.Running)
      Application.DoEvents();
}

void ConvertCtrl_Complete(object sender, EventArgs e)
{
   // set the result
   _result = File.Exists(_outFile);
}

static class LEAD_VARS
{
public const string MediaDir = @"C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 18\Media";
}

Target Platforms

Reference

ConvertCtrl Class
ConvertCtrl Members