In This Topic ▼

PreferredMPEG2Splitter Property

Summary

Gets or sets the preferred MPEG2 splitter display name.

Syntax

C++

[EditorAttribute(System.Type, System.Type)] 
public virtual string PreferredMPEG2Splitter { get; set; }

Public Overridable Property PreferredMPEG2Splitter As String

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

Property Value

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

Remarks

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}

Example

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 20\Media"; 
}

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 20\Media" 
End Class

Requirements

Target Platforms

Reference

ConvertCtrl Class

ConvertCtrl Members

Download our FREE evaluation

Help Version 20.0.2020.4.2

Leadtools.Multimedia Assembly

Introduction

Getting Started

Namespaces

Leadtools.Multimedia Namespace

Leadtools.Multimedia.Common Namespace

Assemblies