In This Topic ▼

InterleaveMode Property

Summary

Gets or sets the current interleave mode used when writing the target file.

Syntax

C++

public virtual ConvertInterleavingMode InterleaveMode { get; set; }

Public Overridable Property InterleaveMode As ConvertInterleavingMode

public: 
virtual property ConvertInterleavingMode InterleaveMode { 
   ConvertInterleavingMode get(); 
   void set (    ConvertInterleavingMode ); 
}

Property Value

An ConvertInterleavingMode enumeration value specifying the interleave mode.

Remarks

Not all file formats support interleaving. For example, AVI file format supports interleave mode, while WMV file format does not. The interleave mode is ignored for the formats that do not support it. Interleave mode tells the multiplexer (the module that combines audio and video into one file) the method for combining data from various streams (video, audio, etc) in the file. Some interleaving modes will require more processing and more memory, but will generate files more suitable for streaming. Other interleaving modes will be faster, and should be used when speed is necessary (for example, during capture).

For a list of possible values, refer to the ConvertInterleavingMode enumeration value.

Example

using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
public bool _result = false; 
public ConvertCtrlForm _form = new ConvertCtrlForm(); 
 
public void InterleaveModeExample() 
{ 
   // reference the convert control 
   ConvertCtrl convertctrl = _form.ConvertCtrl; 
 
   // output file names 
   string inFile = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi"); 
   string outFile = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_InterleaveModeExample.avi"); 
 
   try 
   { 
      // set the source video 
      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; 
 
      // check the video capture dialog properties if available 
      if (convertctrl.HasDialog(ConvertDlg.TargetFormat)) 
         convertctrl.ShowDialog(ConvertDlg.TargetFormat, _form); 
 
      // If the video interleave mode is not full, set it 
      if (convertctrl.InterleaveMode != ConvertInterleavingMode.Full) 
      { 
         // set the interleave mode here 
         convertctrl.InterleaveMode = ConvertInterleavingMode.Full; 
 
         // set the result to what we expect 
         _result = true; 
      } 
 
      // run the capture 
      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(); 
} 
 
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() 
 
Public Sub InterleaveModeExample() 
   ' reference the convert control 
   Dim convertctrl As ConvertCtrl = _form.ConvertCtrl 
 
   ' output file names 
   Dim inFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi") 
   Dim outFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_InterleaveModeExample.avi") 
 
   Try 
      ' set the source video 
      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 
 
      ' check the video capture dialog properties if available 
      If convertctrl.HasDialog(ConvertDlg.TargetFormat) Then 
         convertctrl.ShowDialog(ConvertDlg.TargetFormat, _form) 
      End If 
 
      ' If the video interleave mode is not full, set it 
      If convertctrl.InterleaveMode <> ConvertInterleavingMode.Full Then 
         ' set the interleave mode here 
         convertctrl.InterleaveMode = ConvertInterleavingMode.Full 
 
         ' set the result to what we expect 
         _result = True 
      End If 
 
      ' run the capture 
      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 
 
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