Class JJSwingRhythm

java.lang.Object

org.jjazz.jjswing.api.JJSwingRhythm

All Implemented Interfaces:

Comparable<Rhythm>, Rhythm, ConfigurableMusicGeneratorProvider, MusicGeneratorProvider, YamJJazzRhythm

public class JJSwingRhythm
extends Object
implements YamJJazzRhythm

An advanced swing rhythm which uses a specific generator for the bass (walking, etc.).

Field Summary

Fields inherited from interface org.jjazz.rhythm.api.Rhythm

PROP_RESOURCES_LOADED

Constructor Summary

Constructors

Constructor	Description
JJSwingRhythm()

Method Summary

Modifier and Type	Method	Description
void	addPropertyChangeListener(PropertyChangeListener l)
AccType	getAccType(String rpMuteValue)	Get the AccType corresponding to a RP_SYS_Mute value.
String	getAuthor()
int	getComplexityLevel(String rpVariationValue)	Analyze the RP_Variation value produced by buildRhythmParameters() to retrieve the complexity level.
String	getDescription()
RhythmFeatures	getFeatures()	The general features of this rhythm.
File	getFile()	Optional file from which this rhythm was loaded.
MusicGenerator	getMusicGenerator()
String	getName()
int	getPreferredTempo()
List<RhythmParameter<?>>	getRhythmParameters()
final List<RhythmVoice>	getRhythmVoices()
Style	getStyle()	The Style object associated to this rhythm.
StylePart	getStylePart(String rpValue)	Analyze a RhythmParameter String value produced by buildRhythmParameters() to retrieve the corresponding StylePart.
String[]	getTags()	Can be any keyword strings used to describe the rhythm.
TimeSignature	getTimeSignature()
String	getUniqueId()	A unique string identifier representing this rhythm.
String	getVersion()
boolean	isExtendedRhythm()	True if it's an extended rhythm, false if it's a standard Yamaha rhythm.
boolean	isResourcesLoaded()
void	loadResources()	Tell the rhythm it may load any memory-heavy resources.
void	releaseResources()	Ask the rhythm to release any memory-heavy resources.
void	removePropertyChangeListener(PropertyChangeListener l)
void	setMusicGenerator(MusicGenerator mg)
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.jjazz.rhythm.api.Rhythm

compareTo

Methods inherited from interface org.jjazz.yamjjazz.rhythm.api.YamJJazzRhythm

getRhythmVoice

Constructor Details

JJSwingRhythm

public JJSwingRhythm()
              throws IOException

Throws:

IOException

Method Details

getFile

public File getFile()

Description copied from interface: Rhythm

Optional file from which this rhythm was loaded.

Specified by:

getFile in interface Rhythm

Returns:

Can't be null, but can be an empty path ("") if no file associated.

toString

public String toString()

Overrides:

toString in class Object

getAccType

public AccType getAccType(String rpMuteValue)

Description copied from interface: YamJJazzRhythm

Get the AccType corresponding to a RP_SYS_Mute value.

Specified by:

getAccType in interface YamJJazzRhythm

Parameters:

rpMuteValue - Can't be null

Returns:

Can be null if rpMuteValue is an empty string.

getComplexityLevel

public int getComplexityLevel(String rpVariationValue)

Description copied from interface: YamJJazzRhythm

Analyze the RP_Variation value produced by buildRhythmParameters() to retrieve the complexity level.

Specified by:

getComplexityLevel in interface YamJJazzRhythm

Parameters:

rpVariationValue - eg "Main A-2"

Returns:

eg 2, or -1 if no match.

getStyle

public Style getStyle()

Description copied from interface: YamJJazzRhythm

The Style object associated to this rhythm.

Specified by:

getStyle in interface YamJJazzRhythm

Returns:

getStylePart

public StylePart getStylePart(String rpValue)

Description copied from interface: YamJJazzRhythm

Analyze a RhythmParameter String value produced by buildRhythmParameters() to retrieve the corresponding StylePart.

Specified by:

getStylePart in interface YamJJazzRhythm

Parameters:

rpValue - eg "Main A-2"

Returns:

Main_A or null if no match

isExtendedRhythm

public boolean isExtendedRhythm()

Description copied from interface: YamJJazzRhythm

True if it's an extended rhythm, false if it's a standard Yamaha rhythm.

Specified by:

isExtendedRhythm in interface YamJJazzRhythm

Returns:

getMusicGenerator

public MusicGenerator getMusicGenerator()

Specified by:

getMusicGenerator in interface MusicGeneratorProvider

setMusicGenerator

public void setMusicGenerator(MusicGenerator mg)

Specified by:

setMusicGenerator in interface ConfigurableMusicGeneratorProvider

isResourcesLoaded

public boolean isResourcesLoaded()

Specified by:

isResourcesLoaded in interface Rhythm

loadResources

public void loadResources()
                   throws MusicGenerationException

Description copied from interface: Rhythm

Tell the rhythm it may load any memory-heavy resources.

This will fire a PROP_RESOURCES_LOADED change event with newValue=true.

Specified by:

loadResources in interface Rhythm

Throws:

MusicGenerationException

See Also:

• Rhythm.releaseResources()

releaseResources

public void releaseResources()

Description copied from interface: Rhythm

Ask the rhythm to release any memory-heavy resources.

This will fire a PROP_RESOURCES_LOADED change event with newValue=false.

Specified by:

releaseResources in interface Rhythm

See Also:

• Rhythm.loadResources()

getRhythmVoices

public final List<RhythmVoice> getRhythmVoices()

Specified by:

getRhythmVoices in interface Rhythm

Returns:

The voices for which this rhythm can generate music. Each voice must have a unique name.

getRhythmParameters

public List<RhythmParameter<?>> getRhythmParameters()

Specified by:

getRhythmParameters in interface Rhythm

Returns:

The RhythmParameters that influence the way this rhythm generates music.

getTimeSignature

public TimeSignature getTimeSignature()

Specified by:

getTimeSignature in interface Rhythm

getUniqueId

public String getUniqueId()

Description copied from interface: Rhythm

A unique string identifier representing this rhythm.

It will be used by other serialized objects who want to refer this rhythm -typically a Song object.

Specified by:

getUniqueId in interface Rhythm

Returns:

A non-empty String with spaces trimmed.

getDescription

public String getDescription()

Specified by:

getDescription in interface Rhythm

getFeatures

public RhythmFeatures getFeatures()

Description copied from interface: Rhythm

The general features of this rhythm.

Specified by:

getFeatures in interface Rhythm

Returns:

getPreferredTempo

public int getPreferredTempo()

Specified by:

getPreferredTempo in interface Rhythm

getName

public String getName()

Specified by:

getName in interface Rhythm

getAuthor

public String getAuthor()

Specified by:

getAuthor in interface Rhythm

getVersion

public String getVersion()

Specified by:

getVersion in interface Rhythm

Returns:

Default to "1"

getTags

public String[] getTags()

Description copied from interface: Rhythm

Can be any keyword strings used to describe the rhythm.

Specified by:

getTags in interface Rhythm

Returns:

Default to an empty array.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener l)

Specified by:

addPropertyChangeListener in interface Rhythm

Parameters:

l -

See Also:

• Rhythm.loadResources()
• Rhythm.releaseResources()

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener l)

Specified by:

removePropertyChangeListener in interface Rhythm

Parameters:

l -

See Also:

• Rhythm.loadResources()
• Rhythm.releaseResources()