|  |  |  | GStreamer Base Plugins 0.10 Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
| gsttunerchannelgsttunerchannel — A channel from an element implementing the GstTuner interface. | 
#include <gst/interfaces/tuner.h>
                    GstTunerChannel;
enum                GstTunerChannelFlags;
#define             GST_TUNER_CHANNEL_HAS_FLAG          (channel,
                                                         flag)
The GstTunerChannel object is provided by an element implementing the GstTuner interface.
GstTunerChannel provides a name and flags to determine the type and capabilities of the channel. If the GST_TUNER_CHANNEL_FREQUENCY flag is set, then the channel also information about the minimum and maximum frequency, and range of the reported signal strength.
typedef struct {
  gchar               *label;
  GstTunerChannelFlags flags;
  gfloat               freq_multiplicator;
  gulong               min_frequency;
  gulong               max_frequency;
  gint                 min_signal;
  gint                 max_signal;
} GstTunerChannel;
| gchar * | A string containing a descriptive name for this channel | 
| GstTunerChannelFlags  | A set of GstTunerChannelFlags for this channel | 
| gfloat  | The step size (in Hz) for the frequency setting. | 
| gulong  | Minimum valid frequency setting (in Hz). | 
| gulong  | Maximum valid frequency setting (in Hz). | 
| gint  | Minimum reported signal strength value. | 
| gint  | Maximum reported signal strength value. | 
typedef enum {
  GST_TUNER_CHANNEL_INPUT     = (1<<0),
  GST_TUNER_CHANNEL_OUTPUT    = (1<<1),
  GST_TUNER_CHANNEL_FREQUENCY = (1<<2),
  GST_TUNER_CHANNEL_AUDIO     = (1<<3)
} GstTunerChannelFlags;
An enumeration for flags indicating the available capabilities of a GstTunerChannel.
#define GST_TUNER_CHANNEL_HAS_FLAG(channel, flag)
Macro to check if the given flag is set on a channel
| 
 | A GstTunerChannel | 
| 
 | The flag to check for | 
"frequency-changed" signalvoid user_function (GstTunerChannel *tunerchannel, gulong frequency, gpointer user_data) : Run Last
Reports that the current frequency has changed.
| 
 | The GstTunerChannel | 
| 
 | The new frequency (an unsigned long) | 
| 
 | user data set when the signal handler was connected. | 
"signal-changed" signalvoid user_function (GstTunerChannel *tunerchannel, gint signal, gpointer user_data) : Run Last
Reports that the signal strength has changed.
See Also: gst_tuner_signal_strength()
| 
 | The GstTunerChannel | 
| 
 | The new signal strength (an integer) | 
| 
 | user data set when the signal handler was connected. |