OpenShot Library | libopenshot-audio 0.2.0
juce::NormalisableRange< ValueType > Class Template Reference

Represents a mapping between an arbitrary range of values and a normalised 0->1 range. More...

#include <juce_NormalisableRange.h>

Public Member Functions

 NormalisableRange ()=default
 Creates a continuous range that performs a dummy mapping.
 
 NormalisableRange (const NormalisableRange &)=default
 
NormalisableRangeoperator= (const NormalisableRange &)=default
 
 NormalisableRange (NormalisableRange &&other)
 
NormalisableRangeoperator= (NormalisableRange &&other)
 
 NormalisableRange (ValueType rangeStart, ValueType rangeEnd, ValueType intervalValue, ValueType skewFactor, bool useSymmetricSkew=false) noexcept
 Creates a NormalisableRange with a given range, interval and skew factor.
 
 NormalisableRange (ValueType rangeStart, ValueType rangeEnd) noexcept
 Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.
 
 NormalisableRange (ValueType rangeStart, ValueType rangeEnd, ValueType intervalValue) noexcept
 Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.
 
 NormalisableRange (Range< ValueType > range) noexcept
 Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.
 
 NormalisableRange (Range< ValueType > range, ValueType intervalValue) noexcept
 Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.
 
 NormalisableRange (ValueType rangeStart, ValueType rangeEnd, std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType normalisedValue)> convertFrom0To1Func, std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType mappedValue)> convertTo0To1Func, std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType valueToSnap)> snapToLegalValueFunc=nullptr) noexcept
 Creates a NormalisableRange with a given range and an injective mapping function.
 
ValueType convertTo0to1 (ValueType v) const noexcept
 Uses the properties of this mapping to convert a non-normalised value to its 0->1 representation.
 
ValueType convertFrom0to1 (ValueType proportion) const noexcept
 Uses the properties of this mapping to convert a normalised 0->1 value to its full-range representation.
 
ValueType snapToLegalValue (ValueType v) const noexcept
 Takes a non-normalised value and snaps it based on either the interval property of this NormalisedRange or the lambda function supplied to the constructor.
 
Range< ValueType > getRange () const noexcept
 Returns the extent of the normalisable range.
 
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.
 

Public Attributes

ValueType start = 0
 The minimum value of the non-normalised range.
 
ValueType end = 1
 The maximum value of the non-normalised range.
 
ValueType interval = 0
 The snapping interval that should be used (for a non-normalised value).
 
ValueType skew = 1
 An optional skew factor that alters the way values are distribute across the range.
 
bool symmetricSkew = false
 If true, the skew factor applies from the middle of the slider to each of its ends.
 

Detailed Description

template<typename ValueType>
class juce::NormalisableRange< ValueType >

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.

See also
Range

Definition at line 43 of file juce_NormalisableRange.h.

Constructor & Destructor Documentation

◆ NormalisableRange() [1/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( NormalisableRange< ValueType > &&  other)
inline

Definition at line 53 of file juce_NormalisableRange.h.

◆ NormalisableRange() [2/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( ValueType  rangeStart,
ValueType  rangeEnd,
ValueType  intervalValue,
ValueType  skewFactor,
bool  useSymmetricSkew = false 
)
inlinenoexcept

Creates a NormalisableRange with a given range, interval and skew factor.

Definition at line 79 of file juce_NormalisableRange.h.

◆ NormalisableRange() [3/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( ValueType  rangeStart,
ValueType  rangeEnd 
)
inlinenoexcept

Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.

Definition at line 91 of file juce_NormalisableRange.h.

◆ NormalisableRange() [4/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( ValueType  rangeStart,
ValueType  rangeEnd,
ValueType  intervalValue 
)
inlinenoexcept

Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.

Definition at line 99 of file juce_NormalisableRange.h.

◆ NormalisableRange() [5/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( Range< ValueType >  range)
inlinenoexcept

Creates a NormalisableRange with a given range, continuous interval, but a dummy skew-factor.

Definition at line 108 of file juce_NormalisableRange.h.

◆ NormalisableRange() [6/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( Range< ValueType >  range,
ValueType  intervalValue 
)
inlinenoexcept

Creates a NormalisableRange with a given range and interval, but a dummy skew-factor.

Definition at line 114 of file juce_NormalisableRange.h.

◆ NormalisableRange() [7/7]

template<typename ValueType >
juce::NormalisableRange< ValueType >::NormalisableRange ( ValueType  rangeStart,
ValueType  rangeEnd,
std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType normalisedValue)>  convertFrom0To1Func,
std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType mappedValue)>  convertTo0To1Func,
std::function< ValueType(ValueType currentRangeStart, ValueType currentRangeEnd, ValueType valueToSnap)>  snapToLegalValueFunc = nullptr 
)
inlinenoexcept

Creates a NormalisableRange with a given range and an injective mapping function.

Parameters
rangeStartThe minimum value in the range.
rangeEndThe maximum value in the range.
convertFrom0To1FuncA function which uses the current start and end of this NormalisableRange and produces a mapped value from a normalised value.
convertTo0To1FuncA function which uses the current start and end of this NormalisableRange and produces a normalised value from a mapped value.
snapToLegalValueFuncA 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 130 of file juce_NormalisableRange.h.

Member Function Documentation

◆ operator=()

template<typename ValueType >
NormalisableRange & juce::NormalisableRange< ValueType >::operator= ( NormalisableRange< ValueType > &&  other)
inline

Definition at line 64 of file juce_NormalisableRange.h.

◆ convertTo0to1()

template<typename ValueType >
ValueType juce::NormalisableRange< ValueType >::convertTo0to1 ( ValueType  v) const
inlinenoexcept

Uses the properties of this mapping to convert a non-normalised value to its 0->1 representation.

Definition at line 147 of file juce_NormalisableRange.h.

References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.

◆ convertFrom0to1()

template<typename ValueType >
ValueType juce::NormalisableRange< ValueType >::convertFrom0to1 ( ValueType  proportion) const
inlinenoexcept

Uses the properties of this mapping to convert a normalised 0->1 value to its full-range representation.

Definition at line 171 of file juce_NormalisableRange.h.

References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.

◆ snapToLegalValue()

template<typename ValueType >
ValueType juce::NormalisableRange< ValueType >::snapToLegalValue ( ValueType  v) const
inlinenoexcept

Takes a non-normalised value and snaps it based on either the interval property of this NormalisedRange or the lambda function supplied to the constructor.

Definition at line 199 of file juce_NormalisableRange.h.

References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::interval, and juce::NormalisableRange< ValueType >::start.

◆ getRange()

template<typename ValueType >
Range< ValueType > juce::NormalisableRange< ValueType >::getRange ( ) const
inlinenoexcept

Returns the extent of the normalisable range.

Definition at line 211 of file juce_NormalisableRange.h.

References juce::NormalisableRange< ValueType >::end, and juce::NormalisableRange< ValueType >::start.

◆ setSkewForCentre()

template<typename ValueType >
void juce::NormalisableRange< ValueType >::setSkewForCentre ( ValueType  centrePointValue)
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.

Parameters
centrePointValuethis must be greater than the start of the range and less than the end.

Definition at line 221 of file juce_NormalisableRange.h.

References juce::NormalisableRange< ValueType >::end, juce::NormalisableRange< ValueType >::skew, juce::NormalisableRange< ValueType >::start, and juce::NormalisableRange< ValueType >::symmetricSkew.

Member Data Documentation

◆ start

◆ end

◆ interval

template<typename ValueType >
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 243 of file juce_NormalisableRange.h.

Referenced by juce::NormalisableRange< ValueType >::snapToLegalValue().

◆ skew

template<typename ValueType >
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 257 of file juce_NormalisableRange.h.

Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), and juce::NormalisableRange< ValueType >::setSkewForCentre().

◆ symmetricSkew

template<typename ValueType >
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 260 of file juce_NormalisableRange.h.

Referenced by juce::NormalisableRange< ValueType >::convertFrom0to1(), juce::NormalisableRange< ValueType >::convertTo0to1(), and juce::NormalisableRange< ValueType >::setSkewForCentre().


The documentation for this class was generated from the following file: