org.gstreamer.interfaces
Class Tuner

java.lang.Object
  extended by org.gstreamer.lowlevel.NativeValue
      extended by org.gstreamer.interfaces.GstInterface
          extended by org.gstreamer.interfaces.Tuner

public class Tuner
extends GstInterface

Interface for elements providing tuner operations


Nested Class Summary
static interface Tuner.CHANNEL_CHANGED
          Signal emitted when the channel on a tuner changes
static interface Tuner.FREQUENCY_CHANGED
          Signal emitted when the frequency on a channel changes
static interface Tuner.NORM_CHANGED
          Signal emitted when the norm on a tuner changes
static interface Tuner.SIGNAL_CHANGED
          Signal emitted when the signal strength on a channel changes
 
Nested classes/interfaces inherited from class org.gstreamer.interfaces.GstInterface
GstInterface.ListElementCreator<E>
 
Field Summary
 
Fields inherited from class org.gstreamer.interfaces.GstInterface
element, handle
 
Method Summary
 void connect(Tuner.CHANNEL_CHANGED listener)
          Add a listener for channel-changed messages.
 void connect(Tuner.FREQUENCY_CHANGED listener)
          Add a listener for frequency-changed messages.
 void connect(Tuner.NORM_CHANGED listener)
          Add a listener for norm-changed messages.
 void connect(Tuner.SIGNAL_CHANGED listener)
          Add a listener for signal-changed messages.
 void disconnect(Tuner.CHANNEL_CHANGED listener)
          Disconnect the listener for channel-changed messages.
 void disconnect(Tuner.FREQUENCY_CHANGED listener)
          Disconnect the listener for frequency-changed messages.
 void disconnect(Tuner.NORM_CHANGED listener)
          Disconnect the listener for norm-changed messages.
 void disconnect(Tuner.SIGNAL_CHANGED listener)
          Disconnect the listener for signal-changed messages.
 TunerChannel getChannel()
          Retrieves the current channel from the tuner.
 TunerChannel getChannelByName(java.lang.String name)
          Finds a channel with the specified name
 java.util.List<TunerChannel> getChannelList()
          Retrieves a list of channels (e.g.
 TunerNorm getNorm()
          Gets the current video norm from the given tuner object for the currently selected channel.
 TunerNorm getNormByName(java.lang.String name)
          Finds a TunerNorm with the specified name
 java.util.List<TunerNorm> getNormList()
          Retrieves a list of available norms on the currently tuned channel.
 void setChannel(TunerChannel channel)
          Tunes this tuner to the given channel.
 void setNorm(TunerNorm norm)
          Changes the video norm on this tuner to the given norm
static Tuner wrap(Element element)
          Wraps the Element in a Tuner interface
 
Methods inherited from class org.gstreamer.interfaces.GstInterface
getElement, nativeValue, objectList
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

wrap

public static final Tuner wrap(Element element)
Wraps the Element in a Tuner interface

Parameters:
element - the element to use as a Tuner
Returns:
a Tuner for the element

getChannelList

public java.util.List<TunerChannel> getChannelList()
Retrieves a list of channels (e.g. 'composite', 's-video') from the tuner

Returns:
a list of channels available on this tuner

getNormList

public java.util.List<TunerNorm> getNormList()
Retrieves a list of available norms on the currently tuned channel.

Returns:
a list of norms available on the current channel

setChannel

public void setChannel(TunerChannel channel)
Tunes this tuner to the given channel.

Parameters:
channel - the channel to tune to

getChannel

public TunerChannel getChannel()
Retrieves the current channel from the tuner.

Returns:
the current channel of the tuner

getChannelByName

public TunerChannel getChannelByName(java.lang.String name)
Finds a channel with the specified name

Parameters:
name - the name of the channel to find
Returns:
the TunerChannel if found, else null

setNorm

public void setNorm(TunerNorm norm)
Changes the video norm on this tuner to the given norm

Parameters:
norm - the norm to use for the current channel

getNorm

public TunerNorm getNorm()
Gets the current video norm from the given tuner object for the currently selected channel.

Returns:
the current norm

getNormByName

public TunerNorm getNormByName(java.lang.String name)
Finds a TunerNorm with the specified name

Parameters:
name - the name of the norm to find
Returns:
the TunerNorm if found, else null

connect

public void connect(Tuner.NORM_CHANGED listener)
Add a listener for norm-changed messages.

Parameters:
listener - the listener to be called when the norm changes

disconnect

public void disconnect(Tuner.NORM_CHANGED listener)
Disconnect the listener for norm-changed messages.

Parameters:
listener - the listener that was registered to receive the message.

connect

public void connect(Tuner.CHANNEL_CHANGED listener)
Add a listener for channel-changed messages.

Parameters:
listener - The listener to be called when the channel changes

disconnect

public void disconnect(Tuner.CHANNEL_CHANGED listener)
Disconnect the listener for channel-changed messages.

Parameters:
listener - The listener that was registered to receive the message.

connect

public void connect(Tuner.FREQUENCY_CHANGED listener)
Add a listener for frequency-changed messages.

Parameters:
listener - The listener to be called when the frequency changes

disconnect

public void disconnect(Tuner.FREQUENCY_CHANGED listener)
Disconnect the listener for frequency-changed messages.

Parameters:
listener - The listener that was registered to receive the message.

connect

public void connect(Tuner.SIGNAL_CHANGED listener)
Add a listener for signal-changed messages.

Parameters:
listener - The listener to be called when the signal strength changes

disconnect

public void disconnect(Tuner.SIGNAL_CHANGED listener)
Disconnect the listener for signal-changed messages.

Parameters:
listener - The listener that was registered to receive the message.