All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class guinea.player.ParallelSamples

java.lang.Object
   |
   +----guinea.player.Sample
           |
           +----guinea.player.ParallelSamples

public class ParallelSamples

extends Sample

implements SampleListener, SamplePositionListener, Serializable

Constructor Index

· ParallelSamples(Sample[])

· ParallelSamples(SoundSample[])

Method Index

· addSamplePositionListener(SamplePositionListener)

Adds the specified sample position listener to receive position events from this sample.

· close()

Close the sample.

· finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

· getChannels()

Get number of channels in sample.

· getFadeLength()

Get the length of crossfade.

· getFadeType()

Get fade type.

· getPlaying()

Get the currently playing sample.

· getPlayingIndex()

Get the index of currently playing sample.

· getPositionNotifyInterval()

· getSampleID()

Get the sample ID used with the player.

· getSamples()

· isLoopable()

Whether sample can be looped.

· removeSamplePositionListener(SamplePositionListener)

Removes the specified sample position listener so it no longer receives position events from this sample.

· sampleLooped(SampleEvent)

Called when sample has looped.

· samplePositionChanged(SamplePositionEvent)

Called when sample position has changed.

· sampleStarted(SampleEvent)

Called when sample has started.

· sampleStopped(SampleEvent)

Called when sample has stopped or was stopped.

· setFadeLength(double)

Set the length of the crossfade from one sample to another.

· setFadeType(String)

Set fade type.

· setLooping(boolean)

Set looping status of sample.

· setPlayer(Player)

Set the player this sample is using.

· setPlaying(int)

Switch to one of the samples contained in this parallel sample.

· setPlaying(SoundSample)

Switch to one of the samples contained in this parallel sample.

· setPosition(long)

Seek to a given sample frame.

· setPositionNotifyInterval(double)

Set sample position notification interval.

· setPositionNotifyInterval(int)

Set sample position notification interval.

· setVolume(Volume)

Set volume of sample.

· start(long)

Start playing the sample at given time.

· startWait()

Start playing the sample and wait for it to start before returning.

· startWait(long)

Start playing the sample at a given time and wait for it to start before returning.

· stop()

Stop playing.

· unload()

Unload sample.

· waitForStart()

Wait for sample to start.

· waitForStop()

Wait for sample to stop.

Constructors

 public ParallelSamples(Sample samples[])

 public ParallelSamples(SoundSample samples[])

Methods

 public String getSampleID()

Get the sample ID used with the player.

Overrides:

getSampleID in class Sample

 public void setPlayer(Player player)

Set the player this sample is using.

Overrides:

setPlayer in class Sample

 public Sample[] getSamples()

 public int getChannels()

Get number of channels in sample.

Returns:

number of channels

 public void setPlaying(SoundSample s)

Switch to one of the samples contained in this parallel sample.

Parameters:

s - the sample to which to switch.

 public void setPlaying(int index)

Switch to one of the samples contained in this parallel sample.

Parameters:

index - the index of the sample to which to switch. The order is the same as when constructing this sample.

 public int getPlayingIndex()

Get the index of currently playing sample.

Returns:

number of current sample or -1 if sample is not yet set.

 public Sample getPlaying()

Get the currently playing sample.

Returns:

current sample or null if sample is not yet set.

 public void setFadeLength(double length)

Set the length of the crossfade from one sample to another.

Parameters:

length - the length of fade in seconds.

 public double getFadeLength()

Get the length of crossfade.

Returns:

the length of crossfade in seconds.

 public void setFadeType(String type)

Set fade type.

Parameters:

type - the type of fade, 'linear' or 'exp'.

 public String getFadeType()

Get fade type.

Returns:

the fade type, 'linear' or 'exp'.

 public synchronized void unload()

Unload sample.

 public void close()

Close the sample.

Overrides:

close in class Sample

 public void start(long frame)

Start playing the sample at given time.

Parameters:

frame - output frame number.

Overrides:

start in class Sample

 public long startWait(long frame) throws InterruptedException

Start playing the sample at a given time and wait for it to start before returning.

Parameters:

frame - output frame number.

Returns:

the timestamp indicating the starting time of sample. If frame was non-zero, the same value should be returned unless framedrops occured. Values less that zero indicate errors.

Throws: InterruptedException

if the wait was interrupted

 public long startWait() throws InterruptedException

Start playing the sample and wait for it to start before returning.

Returns:

the timestamp indicating the starting time of sample. Values less that zero indicate errors.

Throws: InterruptedException

if the wait was interrupted

 public synchronized long waitForStart() throws InterruptedException

Wait for sample to start.

Returns:

timestamp of samples start.

Throws: InterruptedException

if the wait was interrupted

 public void stop()

Stop playing.

Overrides:

stop in class Sample

 public synchronized long waitForStop() throws InterruptedException

Wait for sample to stop.

Returns:

timestamp of samples ending.

Throws: InterruptedException

if the wait was interrupted

 public void setPosition(long pos) throws SampleException

Seek to a given sample frame.

Parameters:

pos - the sample frame number where to seek

Throws: SampleException

thrown if position was out of bounds

Overrides:

setPosition in class Sample

 public void setVolume(Volume vol)

Set volume of sample. Sets volume of all channels.

Parameters:

vol - volume of sample.

Overrides:

setVolume in class Sample

 public void addSamplePositionListener(SamplePositionListener l)

Adds the specified sample position listener to receive position events from this sample.

Parameters:

l - the sample position listener.

Overrides:

addSamplePositionListener in class Sample

 public void removeSamplePositionListener(SamplePositionListener l)

Removes the specified sample position listener so it no longer receives position events from this sample.

Parameters:

l - the sample position listener.

Overrides:

removeSamplePositionListener in class Sample

 public void setLooping(boolean loop)

Set looping status of sample.

Parameters:

loop - set to true if looping is wanted, false otherwise.

Overrides:

setLooping in class Sample

 public boolean isLoopable()

Whether sample can be looped.

Overrides:

isLoopable in class Sample

 public void setPositionNotifyInterval(int numFrames)

Set sample position notification interval.

Parameters:

numFrames - the interval in sample frames.

 public void setPositionNotifyInterval(double millis)

Set sample position notification interval.

Parameters:

numFrames - the interval in milliseconds.

 public int getPositionNotifyInterval()

 public void sampleStarted(SampleEvent e)

Called when sample has started. Event's timestamp tells when sample started playing.

 public void sampleStopped(SampleEvent e)

Called when sample has stopped or was stopped. Event's timestamp tells when sample stopped playing.

 public void sampleLooped(SampleEvent e)

Called when sample has looped. Event's timestamp tells when sample looped and started playing from start.

 public void samplePositionChanged(SamplePositionEvent e)

Called when sample position has changed.

 protected void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

Overrides:

finalize in class Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index