In This Topic ▼

Balance Property

Summary

Gets or sets the balance value of the audio stream for the preview output.

Syntax

C++/CLI

public virtual int Balance { get; set; }

public: 
virtual property int Balance { 
   int get(); 
   void set (    int ); 
}

Property Value

A value representing the balance.

Remarks

Allowed values range from -10000 to 10000, where -10000 indicates that the right channel will receive no signal, 10000 indicates that the left channel will receive no signal, and 0 indicates that both channels will get the same amount of the audio signal. This property applied on the preview output only, the audio stream in the captured content will not be affected.

Example

using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void CaptureAudioExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   // output file for capture 
   string outFile = Path.Combine(LEAD_VARS.MediaDir, "CaptureCtrl_CaptureAudioExample.mp3"); 
 
   try 
   { 
      // select a audio capture device 
      if (capturectrl.AudioDevices["USB"] == null) 
         throw new Exception("No USB audio device available"); 
 
      capturectrl.AudioDevices["USB"].Selected = true; 
 
      // set the audio compressor 
      capturectrl.AudioCompressors.AC3.Selected = true; 
 
      // set the target output file and format 
      capturectrl.TargetFile = outFile; 
      capturectrl.TargetFormat = TargetFormatType.MP3; 
 
      // unmute the audio, balanced and full volume 
      capturectrl.Mute = false; 
      capturectrl.Balance = 0; 
      capturectrl.Volume = 0; 
 
      // check whether we can capture audio 
      if (capturectrl.IsModeAvailable(CaptureMode.Audio)) 
      { 
         capturectrl.TimeLimit = 5;      // just 5 seconds of capture time 
         capturectrl.UseTimeLimit = true; 
 
         // start the capture process 
         capturectrl.StartCapture(CaptureMode.Audio); 
 
         // 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 (capturectrl.State == CaptureState.Running) 
            Application.DoEvents(); 
 
         // set the result 
         _result = File.Exists(outFile); 
      } 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
 
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