Package org.jjazz.phrasetransform.api.rps

Class RP_SYS_DrumsTransform

java.lang.Object

org.jjazz.phrasetransform.api.rps.RP_SYS_DrumsTransform

All Implemented Interfaces:

RhythmParameter<RP_SYS_DrumsTransformValue>

public class RP_SYS_DrumsTransform
extends Object
implements RhythmParameter<RP_SYS_DrumsTransformValue>

A RhythmParameter to transform a drums phrase.

Constructor Summary

Constructors

Constructor	Description
RP_SYS_DrumsTransform(RhythmVoice rv, boolean primary)

Method Summary

Modifier and Type	Method	Description
RP_SYS_DrumsTransformValue	cloneValue(RP_SYS_DrumsTransformValue value)	Clone the specified value.
<T> RP_SYS_DrumsTransformValue	convertValue(RhythmParameter<T> rp, T rpValue)	Convert the value of a compatible RhythmParameter to a value for this RhythmParameter.
RP_SYS_DrumsTransformValue	getDefaultValue()
String	getDescription()	The description of this rhythm parameter.
String	getDisplayName()
String	getDisplayValue(RP_SYS_DrumsTransformValue value)	Get a short String representation of the value.
static RP_SYS_DrumsTransform	getDrumsTransformRp(Rhythm r)	Find the first RP_SYS_DrumsTransform instance in the rhythm parameters of r.
String	getId()
Rhythm	getRhythm()
RhythmVoice	getRhythmVoice()
String	getValueDescription(RP_SYS_DrumsTransformValue value)	Provide an optional description or help text associated to the specified value.
boolean	isCompatibleWith(RhythmParameter<?> rp)	Indicate if rp is compatible with this RhythmParameter.
boolean	isPrimary()	Indicate if this RhythmParameter is a primary parameter for its rhythm.
boolean	isValidValue(RP_SYS_DrumsTransformValue value)
RP_SYS_DrumsTransformValue	loadFromString(String s)	Try to convert the specified string to a RhythmParameter value.
String	saveAsString(RP_SYS_DrumsTransformValue v)	Try to convert the specified RhythmParameter value to a string.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

RP_SYS_DrumsTransform

public RP_SYS_DrumsTransform(RhythmVoice rv,
 boolean primary)

Parameters:

rv - Must have a Rhythm container defined and type==RhythmVoice.Type.DRUMS

primary -

Method Details

getRhythm

public Rhythm getRhythm()

isPrimary

public boolean isPrimary()

Description copied from interface: RhythmParameter

Indicate if this RhythmParameter is a primary parameter for its rhythm.

This information is made available mainly for the user interface, e.g. to select which RhythmParameters to show first.

Default implementation returns true.

Specified by:

isPrimary in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

getRhythmVoice

public RhythmVoice getRhythmVoice()

getId

public String getId()

Specified by:

getId in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

A unique identifier. Usually the english name.

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

The localized display name of the rhythm parameter.

getDescription

public String getDescription()

Description copied from interface: RhythmParameter

The description of this rhythm parameter.

Specified by:

getDescription in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

getValueDescription

public String getValueDescription(RP_SYS_DrumsTransformValue value)

Description copied from interface: RhythmParameter

Provide an optional description or help text associated to the specified value.

Specified by:

getValueDescription in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

Can be null.

getDefaultValue

public RP_SYS_DrumsTransformValue getDefaultValue()

Specified by:

getDefaultValue in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

Object The default value.

saveAsString

public String saveAsString(RP_SYS_DrumsTransformValue v)

Description copied from interface: RhythmParameter

Try to convert the specified RhythmParameter value to a string.

Specified by:

saveAsString in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

Can be null if value is invalid or RhytmParameter does not have this capability.

See Also:

• RhythmParameter.loadFromString(java.lang.String)

loadFromString

public RP_SYS_DrumsTransformValue loadFromString(String s)

Description copied from interface: RhythmParameter

Try to convert the specified string to a RhythmParameter value.

Specified by:

loadFromString in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Parameters:

s - A string produced by valueToString().

Returns:

Can be null if conversion failed.

See Also:

• RhythmParameter.saveAsString(E)

isValidValue

public boolean isValidValue(RP_SYS_DrumsTransformValue value)

Specified by:

isValidValue in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

True is value is valid.

cloneValue

public RP_SYS_DrumsTransformValue cloneValue(RP_SYS_DrumsTransformValue value)

Description copied from interface: RhythmParameter

Clone the specified value.

The default implementation just return value, which is fine is E is an immutable class. If E is mutable, this method must be overridden.

Specified by:

cloneValue in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

A copy of the specified value.

toString

public String toString()

Overrides:

toString in class Object

isCompatibleWith

public boolean isCompatibleWith(RhythmParameter<?> rp)

Description copied from interface: RhythmParameter

Indicate if rp is compatible with this RhythmParameter.

NOTE: if rp1 is compatible with rp2, then rp2 must be compatible with rp1 as well.

Specified by:

isCompatibleWith in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

True if a rp's value can be converted to a value for this RhythmParameter.

convertValue

public <T> RP_SYS_DrumsTransformValue convertValue(RhythmParameter<T> rp,
 T rpValue)

Description copied from interface: RhythmParameter

Convert the value of a compatible RhythmParameter to a value for this RhythmParameter.

Specified by:

convertValue in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Type Parameters:

T - A RhythmParameter value

Parameters:

rp - A compatible RhythmParameter

rpValue - The value to convert

Returns:

The rpValue converted for this RhythmParameter. Can't be null.

getDisplayValue

public String getDisplayValue(RP_SYS_DrumsTransformValue value)

Description copied from interface: RhythmParameter

Get a short String representation of the value.

Specified by:

getDisplayValue in interface RhythmParameter<RP_SYS_DrumsTransformValue>

Returns:

Can be an empty String.

getDrumsTransformRp

public static RP_SYS_DrumsTransform getDrumsTransformRp(Rhythm r)

Find the first RP_SYS_DrumsTransform instance in the rhythm parameters of r.

Parameters:

r -

Returns:

Can be null if not found