Table of Contents

Class TVTunerTuneChannelsEventArgs

Namespace
VisioForge.Core.Types.Events
Assembly
VisioForge.Core.dll

Provides data for the TV tuner channel scanning event that occurs during automatic channel discovery or manual frequency tuning operations.

public class TVTunerTuneChannelsEventArgs : EventArgs

Inheritance

Inherited Members

Remarks

This event is raised repeatedly during channel scanning to provide real-time feedback about:

  • Signal detection at each frequency
  • Channel identification when signals are found
  • Overall scanning progress
The event enables applications to build channel lists, show scanning progress, and make decisions about signal quality during the tuning process.

Constructors

TVTunerTuneChannelsEventArgs(bool, int, int, int)

Initializes a new instance of the VisioForge.Core.Types.Events.TVTunerTuneChannelsEventArgs class.

public TVTunerTuneChannelsEventArgs(bool signalPresent, int channel, int frequency, int progress)

Parameters

signalPresent bool

Value indicating whether signal present.

channel int

TV / Radio channel.

frequency int

TV / Radio frequency.

progress int

Tuning progress.

Properties

Channel

Gets the physical or virtual channel number.

public int Channel { get; }

Property Value

int

Remarks

For analog TV, this is typically the channel number (2-69). For digital TV, this might be the physical channel containing multiple virtual channels. The exact meaning depends on the broadcast standard (ATSC, DVB, ISDB, etc.).

Frequency

Gets the frequency in Hertz (Hz) being tuned.

public int Frequency { get; }

Property Value

int

Remarks

The frequency is provided in Hz for precision. Common conversions:

  • MHz = Frequency / 1,000,000
  • kHz = Frequency / 1,000
Typical ranges:
  • VHF-Low (channels 2-6): 54-88 MHz
  • VHF-High (channels 7-13): 174-216 MHz
  • UHF (channels 14-69): 470-806 MHz

Progress

Gets the overall scanning progress as a percentage (0-100).

public int Progress { get; }

Property Value

int

Remarks

This value indicates how much of the total frequency range or channel list has been scanned. It's useful for progress bars and determining when the scan is complete (Progress = 100).

SignalPresent

Gets a value indicating whether a valid signal is present at the current frequency.

public bool SignalPresent { get; }

Property Value

bool

Remarks

True indicates that a broadcast signal has been detected and locked. This doesn't guarantee the signal quality is good enough for viewing, but indicates that a carrier is present and demodulation is possible.