FileDocCategorySizeDatePackage
MergingPullBufferDataSource.javaAPI DocJMF 2.1.1e4778Mon May 12 12:21:04 BST 2003com.ibm.media.protocol

MergingPullBufferDataSource.java

/*
 * @(#)MergingPullBufferDataSource.java	1.2 02/08/21
 *
 * Copyright (c) 1996-2002 Sun Microsystems, Inc.  All rights reserved.
 */
 
package com.ibm.media.protocol;

import java.io.*;

import javax.media.*;
import javax.media.protocol.*;

public class MergingPullBufferDataSource extends PullBufferDataSource {

    MergingDataSource superClass;
    PullBufferStream[] streams;
  
    public MergingPullBufferDataSource(PullBufferDataSource[] sources) {
    
	superClass = new MergingDataSource(sources);
    }

    /**
     * Get the collection of streams that this source
     * manages. The collection of streams is entirely
     * content dependent. The <code>ContentDescriptor</code>
     * of this <CODE>DataSource</CODE> provides the only indication of
     * what streams can be available on this connection.
     *
     * @return The collection of streams for this source.
     */
    public PullBufferStream getStreams()[] {
    
	if (streams == null) {
	    int totalNoOfStreams = 0;
      
	    for (int i = 0; i < superClass.sources.length; i ++) 
		totalNoOfStreams += ((PullBufferDataSource)superClass.sources[i]).getStreams().length;
	    streams = new PullBufferStream[totalNoOfStreams];
	    int totalIndex = 0;
	    for (int sourceIndex = 0; sourceIndex < superClass.sources.length; sourceIndex++) {
		PullBufferStream[] s = ((PullBufferDataSource)superClass.sources[sourceIndex]).getStreams();
		for (int streamIndex = 0; streamIndex < s.length; streamIndex++) 
		    streams[totalIndex++] = s[streamIndex];
	    }
	}
    
	return streams;
    }

    /**
     * Get a string that describes the content-type of the media
     * that the source is providing.
     * <p>
     * It is an error to call <CODE>getContentType</CODE> if the source is
     * not connected.
     *
     * @return The name that describes the media content.
     */
    public String getContentType() {
    
	return superClass.getContentType();
    }
  
    /**
     * Open a connection to the source described by
     * the <CODE>MediaLocator</CODE>.
     * <p>
     *
     * The <CODE>connect</CODE> method initiates communication with the source.
     *
     * @exception IOException Thrown if there are IO problems
     * when <CODE>connect</CODE> is called.
     */
    public void connect() throws IOException {

	superClass.connect();
    }


    /**
     * Close the connection to the source described by the locator.
     * <p>
     * The <CODE>disconnect</CODE> method frees resources used to maintain a
     * connection to the source.
     * If no resources are in use, <CODE>disconnect</CODE> is ignored.
     * If <CODE>stop</CODE> hasn't already been called,
     * calling <CODE>disconnect</CODE> implies a stop.
     *
     */
    public void disconnect() {

	superClass.disconnect();
    }

    /**
     * Initiate data-transfer. The <CODE>start</CODE> method must be
     * called before data is available.
     *(You must call <CODE>connect</CODE> before calling <CODE>start</CODE>.)
     *
     * @exception IOException Thrown if there are IO problems with the source
     * when <CODE>start</CODE> is called.
     */
    public void start() throws IOException {

	superClass.start();
    }

    /**
     * Stop the data-transfer.
     * If the source has not been connected and started,
     * <CODE>stop</CODE> does nothing.
     */
    public void stop() throws IOException {

	superClass.stop();
    }
  
    /**
     * Get the duration of the media represented
     * by this object.
     * The value returned is the media's duration
     * when played at the default rate.
     * If the duration can't be determined  (for example, the media object is presenting live
     * video)  <CODE>getDuration</CODE> returns <CODE>DURATION_UNKNOWN</CODE>.
     *
     * @return A <CODE>Time</CODE> object representing the duration or DURATION_UNKNOWN.
     */
    public Time getDuration() {

	return superClass.getDuration();
    }

    /**
     * Obtain the collection of objects that
     * control the object that implements this interface.
     * <p>
     *
     * If no controls are supported, a zero length
     * array is returned.
     *
     * @return the collection of object controls
     */
    public Object[] getControls() {

	return superClass.getControls();
    }
  
    /**
     * Obtain the object that implements the specified
     * <code>Class</code> or <code>Interface</code>
     * The full class or interface name must be used.
     * <p>
     * 
     * If the control is not supported then <code>null</code>
     * is returned.
     *
     * @return the object that implements the control,
     * or <code>null</code>.
     */
    public Object getControl(String controlType) {
    
	return superClass.getControl(controlType);
    }  
}