LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
AutoTune Method
See Also 
Leadtools.Multimedia Namespace > TVTuner Class : AutoTune Method



Channel
Channel number for which to scan.
Channel
Channel number for which to scan.
Fine tunes the specified channel by scanning for the most precise signal for that channel.

Syntax

Visual Basic (Declaration) 
Public Function AutoTune( _
   ByVal Channel As Integer _
) As Integer
Visual Basic (Usage)Copy Code
Dim instance As TVTuner
Dim Channel As Integer
Dim value As Integer
 
value = instance.AutoTune(Channel)
C# 
public int AutoTune( 
   int Channel
)
C++/CLI 
public:
int AutoTune( 
   int Channel
) 

Parameters

Channel
Channel number for which to scan.

Return Value

nonzero indicates found, zero indicates not found

Example

Visual BasicCopy Code
Public _result As Boolean = False
Public _form As CaptureCtrlForm = New CaptureCtrlForm()
Public Sub AutoTuneExample()
   ' reference the capture control
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl

   Try
      ' try set the analog video capture device, use your device name here
      If Not capturectrl.VideoDevices("Analog") Is Nothing Then
         capturectrl.VideoDevices("Analog").Selected = True
      End If

      ' reference the TV tuner interface
      Dim tvtuner As TVTuner = capturectrl.TVTuner

      ' Check if TV tuner is valid
      If Not tvtuner Is Nothing Then
         ' get the min and max channel info
         Dim minChan As Integer = tvtuner.ChannelMin
         Dim maxChan As Integer = tvtuner.ChannelMax

         ' select a channel between min and max to auto tune, do this for as many channels as desired
         Dim tuneChan As Integer = 25
         Dim ok As Integer = tvtuner.AutoTune(tuneChan)

         ' if we auto-tuned successfully, store the info
         If ok <> 0 Then
            ' store the auto tune information
            tvtuner.StoreAutoTune()
            ' set the result to what we expect
            _result = True
         End If
      End If
   Catch e1 As Exception
      _result = False
   End Try
End Sub
C#Copy Code
public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void AutoTuneExample()
{
   // reference the capture control
   CaptureCtrl capturectrl = _form.CaptureCtrl;

   try
   {
      // try set the analog video capture device, use your device name here
      if (capturectrl.VideoDevices["Analog"] != null)
         capturectrl.VideoDevices["Analog"].Selected = true;

      // reference the TV tuner interface
      TVTuner tvtuner = capturectrl.TVTuner;

      // Check if TV tuner is valid
      if (tvtuner != null)
      {
         // get the min and max channel info
         int minChan = tvtuner.ChannelMin;
         int maxChan = tvtuner.ChannelMax;

         // select a channel between min and max to auto tune, do this for as many channels as desired
         int tuneChan = 25;
         int ok = tvtuner.AutoTune(tuneChan);

         // if we auto-tuned successfully, store the info
         if (ok != 0)
         {
            // store the auto tune information
            tvtuner.StoreAutoTune();
            // set the result to what we expect
            _result = true;
         }
      }
   }
   catch (Exception)
   {
      _result = false;
   }
}

Remarks

Fine tunes the specified channel by scanning for the most precise signal for that channel. This method maps the TV channel to a frequency and searches for the most precise frequency for this channel in the area. Calling this method for every channel in a region or country allows you to create a table of channel and frequency information. Once all channels in the region or country have been scanned, use StoreAutoTune to save the channel information. For more detailed information, refer to the Microsoft documentation for IAMTVTuner.AutoTune

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also