In This Topic ▼

MasterStream Property

Summary

Gets or sets the master stream that other streams must synchronize to after the file is written.

Syntax

C++/CLI

public virtual CaptureMasterStream MasterStream { get; set; }

public: 
virtual property CaptureMasterStream MasterStream { 
   CaptureMasterStream get(); 
   void set (    CaptureMasterStream ); 
}

Property Value

An CaptureMasterStream representing the master stream selection.

Remarks

Gets or sets the master stream that other streams must synchronize to after the file is written. The value must be one of the CaptureMasterStream enumeration values. Different streams in the capture scenario can be captured at different rates if you are using separate audio and video capture cards. By specifying a master stream that all others must synchronize to, this method adjusts the frame rate or audio sampling rate to account for drifts in the rates. To eliminate capture drifts that can occur between audio sampling rates and video frame rates, it is best that you use combined audio/video cards for capture of large files. Assignment can raise an error exception. For more information, refer to the Error Codes.

Example

using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
// capture control 
CaptureCtrl capturectrl; 
 
// output file 
string outFile = Path.Combine(LEAD_VARS.MediaDir, "CaptureCtrl_MasterStreamExample.avi"); 
 
public void MasterStreamExample() 
{ 
   // reference the capture control 
   capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set the source video device, select using your device name here 
      if (capturectrl.VideoDevices["USB"] == null) 
      { 
         throw new Exception("No USB video device available"); 
      } 
 
      capturectrl.VideoDevices["USB"].Selected = true; 
 
      // set the source audio device, select using your device name here 
      if (capturectrl.AudioDevices["USB"] == null) 
      { 
         throw new Exception("No USB audio device available"); 
      } 
 
      capturectrl.AudioDevices["USB"].Selected = true; 
 
      // select a video compressor 
      capturectrl.VideoCompressors.Mpeg4.Selected = true; 
 
      // select an audio compressor 
      capturectrl.AudioCompressors.AC3.Selected = true; 
 
      // set the target output file 
      capturectrl.TargetFile = outFile; 
 
      // subscribe to the started event 
      capturectrl.Started += CaptureCtrl_Started; 
 
      // set master stream to CaptureMasterStream.Video 
      capturectrl.MasterStream = CaptureMasterStream.Video; 
 
      // start capture 
      capturectrl.StartCapture(CaptureMode.VideoAndAudio); 
 
      // get master stream  
      CaptureMasterStream MasterStream = capturectrl.MasterStream; 
 
      // set the result to what we expect 
      _result = (MasterStream == CaptureMasterStream.Video); 
   } 
   catch (COMException) 
   { 
      _result = false; 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
 
void CaptureCtrl_Started(object sender, EventArgs e) 
{ 
   // stop the capture (we do not need a complete capture for this example) 
   capturectrl.StopCapture(); 
} 
 
static class LEAD_VARS 
{ 
   public const string MediaDir = @"C:\LEADTOOLS23\Media"; 
}

Requirements

Target Platforms

Reference

CaptureCtrl Class

CaptureCtrl Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Multimedia Assembly

Introduction

Getting Started

Namespaces

Leadtools.Multimedia Namespace

Leadtools.Multimedia.Common Namespace

Assemblies