VSTGUI  4.10
Graphical User Interface Framework not only for VST plugins
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
VSTGUI::Standalone::Value Namespace Reference

value create and helper functions More...

Namespaces

namespace  Detail
 

Classes

class  ListenerT
 Value listener More...
 
class  Listener
 Value listener More...
 

Functions

Create values
ValuePtr make (const UTF8String &id, IValue::Type initialValue=0., const ValueConverterPtr &valueConverter=nullptr)
 make a value in the normalized range [0..1]
 
ValuePtr makeStepValue (const UTF8String &id, IStepValue::StepType numSteps, IValue::Type initialValue=0., const ValueConverterPtr &valueConverter=nullptr)
 make a step value
 
ValuePtr makeStringListValue (const UTF8String &id, const std::initializer_list< IStringListValue::StringType > &strings, IValue::Type initialValue=0.)
 make a string list value
 
ValuePtr makeStringListValue (const UTF8String &id, const IStringListValue::StringList &strings)
 make a string list value
 
ValuePtr makeStaticStringValue (const UTF8String &id, const UTF8String &value)
 make a static string value
 
ValuePtr makeStaticStringValue (const UTF8String &id, UTF8String &&value)
 make a static string value
 
ValuePtr makeStringValue (const UTF8String &id, const UTF8String &initialString)
 make a string value
 
ValuePtr makeStringValue (const UTF8String &id, UTF8String &&initialString)
 make a string value
 
Create value converters
ValueConverterPtr makePercentConverter ()
 make a percent value converter
 
ValueConverterPtr makeRangeConverter (IValue::Type minValue, IValue::Type maxValue, uint32_t stringPrecision=4)
 make a range value converter
 
Value helper functions
IValue::Type plainToNormalize (IValue &value, IValue::Type plainValue)
 
IValue::Type normalizeToPlain (IValue &value, IValue::Type normalizeValue)
 
IValue::Type stepToNormalize (IValue &value, IStepValue::StepType stepValue)
 
IStepValue::StepType normalizeToStep (IValue &value, IValue::Type normalizeValue)
 
IValue::Type currentPlainValue (IValue &value)
 
IStepValue::StepType currentStepValue (IValue &value)
 
UTF8String currentStringValue (IValue &value)
 
void performSingleEdit (IValue &value, IValue::Type newValue)
 
void performSinglePlainEdit (IValue &value, IValue::Type plainValue)
 
bool performSingleStepEdit (IValue &value, IStepValue::StepType step)
 
bool performStringValueEdit (IValue &value, const UTF8String &str)
 
bool performStringAppendValueEdit (IValue &value, const UTF8String &str)
 

Detailed Description

value create and helper functions

Function Documentation

IValue::Type VSTGUI::Standalone::Value::currentPlainValue ( IValue &  value)
inline
IStepValue::StepType VSTGUI::Standalone::Value::currentStepValue ( IValue &  value)
inline
UTF8String VSTGUI::Standalone::Value::currentStringValue ( IValue &  value)
inline
ValuePtr VSTGUI::Standalone::Value::make ( const UTF8String &  id,
IValue::Type  initialValue = 0.,
const ValueConverterPtr &  valueConverter = nullptr 
)

make a value in the normalized range [0..1]

Parameters
idvalue ID
initialValueinitial value
valueConvertervalue converter
Returns
shared value pointer
ValueConverterPtr VSTGUI::Standalone::Value::makePercentConverter ( )

make a percent value converter

converts normalized values to the range [0..100]

ValueConverterPtr VSTGUI::Standalone::Value::makeRangeConverter ( IValue::Type  minValue,
IValue::Type  maxValue,
uint32_t  stringPrecision = 4 
)

make a range value converter

converts normalized values to the range [minValue..maxValue]

ValuePtr VSTGUI::Standalone::Value::makeStaticStringValue ( const UTF8String &  id,
const UTF8String &  value 
)

make a static string value

a static string value is an inactive unchangeable value

Parameters
idvalue ID
valuestatic string
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStaticStringValue ( const UTF8String &  id,
UTF8String &&  value 
)

make a static string value

a static string value is an inactive unchangeable value

Parameters
idvalue ID
valuestatic string
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStepValue ( const UTF8String &  id,
IStepValue::StepType  numSteps,
IValue::Type  initialValue = 0.,
const ValueConverterPtr &  valueConverter = nullptr 
)

make a step value

Parameters
idvalue ID
numStepsnumber of discrete steps, must be greater than zero
initialValueinitial value in the normalized range [0..1]
valueConvertervalue converter
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStringListValue ( const UTF8String &  id,
const std::initializer_list< IStringListValue::StringType > &  strings,
IValue::Type  initialValue = 0. 
)

make a string list value

a string list value is a step value where each step has a string representation.

to modify the string list you can cast the returned value object to IStringListValue and use the updateStringList method.

Parameters
idvalue ID
stringsstring list
initialValueinitial value in the normalized range [0..1]
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStringListValue ( const UTF8String &  id,
const IStringListValue::StringList &  strings 
)

make a string list value

the returned value object has the IStringListValue interface

Parameters
idvalue ID
stringsstring list
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStringValue ( const UTF8String &  id,
const UTF8String &  initialString 
)

make a string value

a string value has always the same numerical but different string representations

Parameters
idvalue ID
valueinitial string
Returns
shared value pointer
ValuePtr VSTGUI::Standalone::Value::makeStringValue ( const UTF8String &  id,
UTF8String &&  initialString 
)

make a string value

a string value has always the same numerical but different string representations

Parameters
idvalue ID
valueinitial string
Returns
shared value pointer
IValue::Type VSTGUI::Standalone::Value::normalizeToPlain ( IValue &  value,
IValue::Type  normalizeValue 
)
inline
IStepValue::StepType VSTGUI::Standalone::Value::normalizeToStep ( IValue &  value,
IValue::Type  normalizeValue 
)
inline
void VSTGUI::Standalone::Value::performSingleEdit ( IValue &  value,
IValue::Type  newValue 
)
inline
void VSTGUI::Standalone::Value::performSinglePlainEdit ( IValue &  value,
IValue::Type  plainValue 
)
inline
bool VSTGUI::Standalone::Value::performSingleStepEdit ( IValue &  value,
IStepValue::StepType  step 
)
inline
bool VSTGUI::Standalone::Value::performStringAppendValueEdit ( IValue &  value,
const UTF8String &  str 
)
inline
bool VSTGUI::Standalone::Value::performStringValueEdit ( IValue &  value,
const UTF8String &  str 
)
inline
IValue::Type VSTGUI::Standalone::Value::plainToNormalize ( IValue &  value,
IValue::Type  plainValue 
)
inline
IValue::Type VSTGUI::Standalone::Value::stepToNormalize ( IValue &  value,
IStepValue::StepType  stepValue 
)
inline