Class RP_Integer

java.lang.Object

org.jjazz.rhythm.api.RP_Integer

All Implemented Interfaces:

Cloneable, RhythmParameter<Integer>, RpEnumerable<Integer>

Direct Known Subclasses:

RP_SYS_Intensity, RP_SYS_TempoFactor

public class RP_Integer
extends Object
implements RhythmParameter<Integer>, RpEnumerable<Integer>, Cloneable

A RhythmParemeter representing positive integer values.

Constructor Summary

Constructors

Constructor	Description
RP_Integer(String id, String name, String description, boolean isPrimary, int defaultVal, int minValue, int maxValue, int step)	Create a RP_Integer.Created instance is primary by default.

Method Summary

Modifier and Type	Method	Description
final double	calculatePercentage(Integer value)
final Integer	calculateValue(double y)	Calculate the RhythmParameter value corresponding to a percentage of the value range.
<T> Integer	convertValue(RhythmParameter<T> rp, T value)	Convert the value of a compatible RhythmParameter to a value for this RhythmParameter.
boolean	equals(Object obj)
RP_Integer	getCopy(Rhythm r)	Get a copy of this RhythmParameter.
final Integer	getDefaultValue()
final String	getDescription()	The description of this rhythm parameter.
final String	getDisplayName()
String	getDisplayValue(Integer value)	Get a short String representation of the value.
final String	getId()
final Integer	getMaxValue()
final Integer	getMinValue()
final Integer	getNextValue(Integer value)	Get the next value after specified value.
final List<Integer>	getPossibleValues()	Get the list of possible values for this RhythmParameter.
final Integer	getPreviousValue(Integer value)	Get the next value before specified value.
final int	getStep()
String	getValueDescription(Integer value)	Provide an optional description or help text associated to the specified value.
int	hashCode()
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.
final boolean	isValidValue(Integer value)
Integer	loadFromString(String s)	Try to convert the specified string to a RhythmParameter value.
String	saveAsString(Integer value)	Try to convert the specified RhythmParameter value to a string.
final String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

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

cloneValue

Constructor Details

RP_Integer

public RP_Integer(String id,
 String name,
 String description,
 boolean isPrimary,
 int defaultVal,
 int minValue,
 int maxValue,
 int step)

Create a RP_Integer.Created instance is primary by default.

Parameters:

id -

name -

description -

isPrimary -

defaultVal -

minValue -

maxValue -

step -

Method Details

getCopy

public RP_Integer getCopy(Rhythm r)

Description copied from interface: RhythmParameter

Get a copy of this RhythmParameter.

Specified by:

getCopy in interface RhythmParameter<Integer>

Parameters:

r - Can be null. Optionally set the target Rhythm of the returned RhythmParameter -though it might be ignored by the implementing method.

Returns:

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<Integer>

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getStep

public final int getStep()

getDescription

public final String getDescription()

Description copied from interface: RhythmParameter

The description of this rhythm parameter.

Specified by:

getDescription in interface RhythmParameter<Integer>

Returns:

getMaxValue

public final Integer getMaxValue()

Specified by:

getMaxValue in interface RpEnumerable<Integer>

getMinValue

public final Integer getMinValue()

Specified by:

getMinValue in interface RpEnumerable<Integer>

getId

public final String getId()

Specified by:

getId in interface RhythmParameter<Integer>

Returns:

A unique identifier. Usually the english name.

getDisplayName

public final String getDisplayName()

Specified by:

getDisplayName in interface RhythmParameter<Integer>

Returns:

The localized display name of the rhythm parameter.

getNextValue

public final Integer getNextValue(Integer value)

Description copied from interface: RpEnumerable

Get the next value after specified value.

Specified by:

getNextValue in interface RpEnumerable<Integer>

Parameters:

value -

Returns:

Object

getPreviousValue

public final Integer getPreviousValue(Integer value)

Description copied from interface: RpEnumerable

Get the next value before specified value.

Specified by:

getPreviousValue in interface RpEnumerable<Integer>

Parameters:

value -

Returns:

Object

getDefaultValue

public final Integer getDefaultValue()

Specified by:

getDefaultValue in interface RhythmParameter<Integer>

Returns:

Object The default value.

isValidValue

public final boolean isValidValue(Integer value)

Specified by:

isValidValue in interface RhythmParameter<Integer>

Parameters:

value -

Returns:

True is value is valid.

calculateValue

public final Integer calculateValue(double y)

Description copied from interface: RpEnumerable

Calculate the RhythmParameter value corresponding to a percentage of the value range.

For example if RhythmParameter is an integer between 0 and 4: percentage=0 -> value=0 percentage=0.5 -> value=2 percentage=1 -> value=4.

Specified by:

calculateValue in interface RpEnumerable<Integer>

Parameters:

y - A float between 0 and 1.

Returns:

A RhythmParameter value.

calculatePercentage

public final double calculatePercentage(Integer value)

Specified by:

calculatePercentage in interface RpEnumerable<Integer>

Parameters:

value -

Returns:

A percentage between 0 and 1 representing value in the range of the possible values.

toString

public final String toString()

Overrides:

toString in class Object

getPossibleValues

public final List<Integer> getPossibleValues()

Description copied from interface: RpEnumerable

Get the list of possible values for this RhythmParameter.

Only the first 10000 values are returned.

Specified by:

getPossibleValues in interface RpEnumerable<Integer>

Returns:

saveAsString

public String saveAsString(Integer value)

Description copied from interface: RhythmParameter

Try to convert the specified RhythmParameter value to a string.

Specified by:

saveAsString in interface RhythmParameter<Integer>

Parameters:

value -

Returns:

Can be null if value is invalid.

See Also:

• RhythmParameter.loadFromString(java.lang.String)

loadFromString

public Integer loadFromString(String s)

Description copied from interface: RhythmParameter

Try to convert the specified string to a RhythmParameter value.

Specified by:

loadFromString in interface RhythmParameter<Integer>

Parameters:

s - A string produced by valueToString().

Returns:

Can be null if conversion failed.

See Also:

• RhythmParameter.saveAsString(E)

getValueDescription

public String getValueDescription(Integer value)

Description copied from interface: RhythmParameter

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

Specified by:

getValueDescription in interface RhythmParameter<Integer>

Parameters:

value -

Returns:

Can be null.

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<Integer>

Parameters:

rp -

Returns:

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

convertValue

public <T> Integer convertValue(RhythmParameter<T> rp,
 T value)

Description copied from interface: RhythmParameter

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

Specified by:

convertValue in interface RhythmParameter<Integer>

Type Parameters:

T - A RhythmParameter value

Parameters:

rp - A compatible RhythmParameter

value - The value to convert

Returns:

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

getDisplayValue

public String getDisplayValue(Integer value)

Description copied from interface: RhythmParameter

Get a short String representation of the value.

Specified by:

getDisplayValue in interface RhythmParameter<Integer>

Parameters:

value -

Returns:

Can be an empty String.