OpenShot Library | OpenShotAudio 0.2.2
|
Represents a mapping between an arbitrary range of values and a normalised 0->1 range. More...
#include <juce_NormalisableRange.h>
Public Types | |
using | ValueRemapFunction = std::function< ValueType(ValueType rangeStart, ValueType rangeEnd, ValueType valueToRemap)> |
A function object which can remap a value in some way based on the start and end of a range. More... | |
Public Member Functions | |
NormalisableRange ()=default | |
Creates a continuous range that performs a dummy mapping. | |
NormalisableRange (const NormalisableRange &)=default | |
NormalisableRange & | operator= (const NormalisableRange &)=default |
NormalisableRange (NormalisableRange &&)=default | |
NormalisableRange & | operator= (NormalisableRange &&)=default |
NormalisableRange (ValueType rangeStart, ValueType rangeEnd, ValueType intervalValue, ValueType skewFactor, bool useSymmetricSkew=false) noexcept | |
Creates a NormalisableRange with a given range, interval and skew factor. More... | |
NormalisableRange (ValueType rangeStart, ValueType rangeEnd) noexcept | |
Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor. More... | |
NormalisableRange (ValueType rangeStart, ValueType rangeEnd, ValueType intervalValue) noexcept | |
Creates a NormalisableRange with a given range and interval, but a dummy skew-factor. More... | |
NormalisableRange (Range< ValueType > range) noexcept | |
Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor. More... | |
NormalisableRange (Range< ValueType > range, ValueType intervalValue) noexcept | |
Creates a NormalisableRange with a given range and interval, but a dummy skew-factor. More... | |
NormalisableRange (ValueType rangeStart, ValueType rangeEnd, ValueRemapFunction convertFrom0To1Func, ValueRemapFunction convertTo0To1Func, ValueRemapFunction snapToLegalValueFunc={}) noexcept | |
Creates a NormalisableRange with a given range and an injective mapping function. More... | |
ValueType | convertTo0to1 (ValueType v) const noexcept |
Uses the properties of this mapping to convert a non-normalised value to its 0->1 representation. More... | |
ValueType | convertFrom0to1 (ValueType proportion) const noexcept |
Uses the properties of this mapping to convert a normalised 0->1 value to its full-range representation. More... | |
ValueType | snapToLegalValue (ValueType v) const noexcept |
Takes a non-normalised value and snaps it based on either the interval property of this NormalisableRange or the lambda function supplied to the constructor. More... | |
Range< ValueType > | getRange () const noexcept |
Returns the extent of the normalisable range. More... | |
void | setSkewForCentre (ValueType centrePointValue) noexcept |
Given a value which is between the start and end points, this sets the skew such that convertFrom0to1 (0.5) will return this value. More... | |
Public Attributes | |
ValueType | start = 0 |
The minimum value of the non-normalised range. More... | |
ValueType | end = 1 |
The maximum value of the non-normalised range. More... | |
ValueType | interval = 0 |
The snapping interval that should be used (for a non-normalised value). More... | |
ValueType | skew = 1 |
An optional skew factor that alters the way values are distribute across the range. More... | |
bool | symmetricSkew = false |
If true, the skew factor applies from the middle of the slider to each of its ends. More... | |
Represents a mapping between an arbitrary range of values and a normalised 0->1 range.
The properties of the mapping also include an optional snapping interval and skew-factor.
Definition at line 43 of file juce_NormalisableRange.h.
using juce::NormalisableRange< ValueType >::ValueRemapFunction = std::function<ValueType(ValueType rangeStart, ValueType rangeEnd, ValueType valueToRemap)> |
A function object which can remap a value in some way based on the start and end of a range.
Definition at line 96 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range, interval and skew factor.
Definition at line 55 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.
Definition at line 67 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.
Definition at line 75 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.
Definition at line 84 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.
Definition at line 90 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Creates a NormalisableRange with a given range and an injective mapping function.
rangeStart | The minimum value in the range. |
rangeEnd | The maximum value in the range. |
convertFrom0To1Func | A function which uses the current start and end of this NormalisableRange and produces a mapped value from a normalised value. |
convertTo0To1Func | A function which uses the current start and end of this NormalisableRange and produces a normalised value from a mapped value. |
snapToLegalValueFunc | A function which uses the current start and end of this NormalisableRange to take a mapped value and snap it to the nearest legal value. |
Definition at line 111 of file juce_NormalisableRange.h.
|
inlinenoexcept |
Uses the properties of this mapping to convert a non-normalised value to its 0->1 representation.
Definition at line 128 of file juce_NormalisableRange.h.
References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.
|
inlinenoexcept |
Uses the properties of this mapping to convert a normalised 0->1 value to its full-range representation.
Definition at line 152 of file juce_NormalisableRange.h.
References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.
|
inlinenoexcept |
Takes a non-normalised value and snaps it based on either the interval property of this NormalisableRange or the lambda function supplied to the constructor.
Definition at line 180 of file juce_NormalisableRange.h.
References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::interval, and juce::NormalisableRange< ValueType >::start.
|
inlinenoexcept |
Returns the extent of the normalisable range.
Definition at line 192 of file juce_NormalisableRange.h.
References juce::NormalisableRange< ValueType >::end, and juce::NormalisableRange< ValueType >::start.
|
inlinenoexcept |
Given a value which is between the start and end points, this sets the skew such that convertFrom0to1 (0.5) will return this value.
If you have used lambda functions for convertFrom0to1Func and convertFrom0to1Func in the constructor of this class then the skew value is ignored.
centrePointValue | this must be greater than the start of the range and less than the end. |
Definition at line 202 of file juce_NormalisableRange.h.
References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.
ValueType juce::NormalisableRange< ValueType >::start = 0 |
The minimum value of the non-normalised range.
Definition at line 213 of file juce_NormalisableRange.h.
Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), juce::NormalisableRange< ValueType >::getRange(), juce::NormalisableRange< ValueType >::setSkewForCentre(), and juce::NormalisableRange< ValueType >::snapToLegalValue().
ValueType juce::NormalisableRange< ValueType >::end = 1 |
The maximum value of the non-normalised range.
Definition at line 216 of file juce_NormalisableRange.h.
Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), juce::NormalisableRange< ValueType >::getRange(), juce::NormalisableRange< ValueType >::setSkewForCentre(), and juce::NormalisableRange< ValueType >::snapToLegalValue().
ValueType juce::NormalisableRange< ValueType >::interval = 0 |
The snapping interval that should be used (for a non-normalised value).
Use 0 for a continuous range.
If you have used a lambda function for snapToLegalValueFunction in the constructor of this class then the interval is ignored.
Definition at line 224 of file juce_NormalisableRange.h.
Referenced by juce::NormalisableRange< ValueType >::snapToLegalValue().
ValueType juce::NormalisableRange< ValueType >::skew = 1 |
An optional skew factor that alters the way values are distribute across the range.
The skew factor lets you skew the mapping logarithmically so that larger or smaller values are given a larger proportion of the available space.
A factor of 1.0 has no skewing effect at all. If the factor is < 1.0, the lower end of the range will fill more of the slider's length; if the factor is > 1.0, the upper end of the range will be expanded.
If you have used lambda functions for convertFrom0to1Func and convertFrom0to1Func in the constructor of this class then the skew value is ignored.
Definition at line 238 of file juce_NormalisableRange.h.
Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), and juce::NormalisableRange< ValueType >::setSkewForCentre().
bool juce::NormalisableRange< ValueType >::symmetricSkew = false |
If true, the skew factor applies from the middle of the slider to each of its ends.
Definition at line 241 of file juce_NormalisableRange.h.
Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), and juce::NormalisableRange< ValueType >::setSkewForCentre().