javax.media
Interface Renderer

All Known Subinterfaces:
VideoRenderer

public abstract interface Renderer
extends PlugIn

A base Renderer interface. A Renderer is the final stage of the processing pipeline. It renders the media to a pre-defined destination, e.g. screen for video, speaker for audio.
A Renderer can be used by the Player as the master time base for synchronization, if the Renderer implements the Clock interface. In such case, the Renderer should update the media time and time base as media is being processed accordingly.

Since:
JMF 2.0

Fields inherited from class javax.media.PlugIn
BUFFER_PROCESSED_FAILED, BUFFER_PROCESSED_OK, INPUT_BUFFER_NOT_CONSUMED, OUTPUT_BUFFER_NOT_FILLED
 
Method Summary
 Format[] getSupportedInputFormats()
          Lists the possible input formats supported by this plug-in.
 int process(Buffer buffer)
          Processes the data and renders it to the output device represented by this renderer.
 Format setInputFormat(Format format)
          Set the data input format.
 void start()
          Informs the renderer to start rendering any data available in its internal buffers.
 void stop()
          Informs the renderer to stop rendering data.
 
Methods inherited from interface javax.media.PlugIn
close, getName, open, reset
 
Methods inherited from interface javax.media.Controls
getControl, getControls
 

Method Detail

getSupportedInputFormats

public Format[] getSupportedInputFormats()
Lists the possible input formats supported by this plug-in.

setInputFormat

public Format setInputFormat(Format format)
Set the data input format.
Returns:
null if the format is not supported or the nearest valid format to the one specified. Fills in NOT_SPECIFIED fields if possible with preferred values.

start

public void start()
Informs the renderer to start rendering any data available in its internal buffers.

stop

public void stop()
Informs the renderer to stop rendering data.

process

public int process(Buffer buffer)
Processes the data and renders it to the output device represented by this renderer.
Returns:
BUFFER_PROCESSED_OK if the processing is successful. Other possible return codes are defined in PlugIn.
See Also:
PlugIn