FileDocCategorySizeDatePackage
BasicProcessor.javaAPI DocJMF 2.1.1e3942Mon May 12 12:20:50 BST 2003com.sun.media

BasicProcessor

public abstract class BasicProcessor extends BasicPlayer implements Processor
BasicProcessor implements the bases of a javax.media.Processor. It handles all the Processor state transitions, event handling and management of any Controller under its control.

Fields Summary
static String
NOT_CONFIGURED_ERROR
Constructors Summary
Methods Summary
public javax.media.protocol.ContentDescriptorgetContentDescriptor()
Return the output content-type.

return
The current output content-type.
exception
NotConfiguredError if the Processor is Unrealized.

	if (getState() < Processor.Configured)
	    throw new NotConfiguredError("getContentDescriptor " + NOT_CONFIGURED_ERROR);
	return null;
    
public javax.media.protocol.DataSourcegetDataOutput()
Return the output DataSource of the Processor. The output DataSource is the output connection of the Processor through which it supplies the processed streams.

return
The output DataSource of the Processor.
exception
NotRealizedError if the Processor is not realized.

	if (getState() < Realized)
	    throw new NotRealizedError("getDataOutput cannot be called before the Processor is realized"); 
	return null;
    
public javax.media.protocol.ContentDescriptor[]getSupportedContentDescriptors()
Return all the content-types which this Processor's output supports. The Processor builds the ContentDescriptor array according to the input DataSource attached to the Processor and according to the codecs and multiplexers installed in the system.

return
An array of the the content-types supported by the Processor.
exception
NotConfiguredError if the Processor is Unrealized.

	if (getState() < Processor.Configured)
	    throw new NotConfiguredError("getSupportedContentDescriptors " + NOT_CONFIGURED_ERROR);
	return new ContentDescriptor[0];
    
public javax.media.control.TrackControl[]getTrackControls()
Return the tracks in the media. This method can only be called after the Processor has been configured. A NotConfiguredError is thrown if getTrackControls is called and the Processor is in the Unrealized or Configuring states.

return
An array of the tracks in the media. An emtpy array is returned if there is no TrackControl available for this Processor.
exception
NotConfiguredError if the Processor is Unrealized.

	if (getState() < Processor.Configured)
	    throw new NotConfiguredError("getTrackControls " + NOT_CONFIGURED_ERROR);
	return new TrackControl[0];
    
protected booleanisConfigurable()
A processor is configurable.


             
       
	return true;
    
public javax.media.protocol.ContentDescriptorsetContentDescriptor(javax.media.protocol.ContentDescriptor ocd)
Set the output content-type. If setContentDescriptor is not called, the output DataSource's output will be on individual tracks.

param
outputContentDescriptor the content-type of the output.
exception
NotConfiguredError if the Processor is Unrealized. realized state and it does not support format changes after it has been realized.

	if (getState() < Processor.Configured)
	    throw new NotConfiguredError("setContentDescriptor " + NOT_CONFIGURED_ERROR);
	return ocd;