![]() |
AAX SDK
2.4.1
Avid Audio Extensions Development Kit
|
#include <AAX_CParameter.h>
Generic implementation of an AAX_IParameter.
This is a concrete, templatized implementation of AAX_IParameter for parameters with standard types such as float
, uint32
, bool
, etc.
Many different behaviors can be composited into this class as delegates. AAX_ITaperDelegate and AAX_IDisplayDelegate are two examples of delegates that this class uses in order to apply custom behaviors to the AAX_IParameter interface.
Plug-in developers can subclass these delegates to create adaptable, reusable parameter behaviors, which can then be "mixed in" to individual AAX_CParameter objects without the need to modify the objects themselves.
Public Types | |
enum | Type { eParameterTypeUndefined = 0 , eParameterTypeBool = 1 , eParameterTypeInt32 = 2 , eParameterTypeFloat = 3 , eParameterTypeCustom = 4 } |
enum | Defaults { eParameterDefaultNumStepsDiscrete = 2 , eParameterDefaultNumStepsContinuous = 128 } |
Public Member Functions | |
AAX_CParameter (AAX_CParamID identifier, const AAX_IString &name, T defaultValue, const AAX_ITaperDelegate< T > &taperDelegate, const AAX_IDisplayDelegate< T > &displayDelegate, bool automatable=false) | |
Constructs an AAX_CParameter object using the specified taper and display delegates. More... | |
AAX_CParameter (const AAX_IString &identifier, const AAX_IString &name, T defaultValue, const AAX_ITaperDelegate< T > &taperDelegate, const AAX_IDisplayDelegate< T > &displayDelegate, bool automatable=false) | |
Constructs an AAX_CParameter object using the specified taper and display delegates. More... | |
AAX_CParameter (const AAX_IString &identifier, const AAX_IString &name, T defaultValue, bool automatable=false) | |
Constructs an AAX_CParameter object with no delegates. More... | |
AAX_CParameter (const AAX_IString &identifier, const AAX_IString &name, bool automatable=false) | |
Constructs an AAX_CParameter object with no delegates or default value. More... | |
AAX_DEFAULT_MOVE_CTOR (AAX_CParameter) | |
AAX_DEFAULT_MOVE_OPER (AAX_CParameter) | |
AAX_DELETE (AAX_CParameter()) | |
AAX_DELETE (AAX_CParameter(const AAX_CParameter &other)) | |
AAX_DELETE (AAX_CParameter &operator=(const AAX_CParameter &other)) | |
~AAX_CParameter () AAX_OVERRIDE | |
Virtual destructor used to delete all locally allocated pointers. More... | |
AAX_IParameterValue * | CloneValue () const AAX_OVERRIDE |
Clone the parameter's value to a new AAX_IParameterValue object. More... | |
bool | GetValueAsString (AAX_IString *) const |
Retrieves the parameter's value as a string. More... | |
bool | SetValueWithBool (bool value) |
Sets the parameter's value as a bool. More... | |
bool | SetValueWithInt32 (int32_t value) |
Sets the parameter's value as an int32_t. More... | |
bool | SetValueWithFloat (float value) |
Sets the parameter's value as a float. More... | |
bool | SetValueWithDouble (double value) |
Sets the parameter's value as a double. More... | |
bool | SetValueWithString (const AAX_IString &value) |
Sets the parameter's value as a string. More... | |
bool | GetNormalizedValueFromBool (bool value, double *normalizedValue) const |
Converts a bool to a normalized parameter value. More... | |
bool | GetNormalizedValueFromInt32 (int32_t value, double *normalizedValue) const |
Converts an integer to a normalized parameter value. More... | |
bool | GetNormalizedValueFromFloat (float value, double *normalizedValue) const |
Converts a float to a normalized parameter value. More... | |
bool | GetNormalizedValueFromDouble (double value, double *normalizedValue) const |
Converts a double to a normalized parameter value. More... | |
bool | GetBoolFromNormalizedValue (double inNormalizedValue, bool *value) const |
Converts a normalized parameter value to a bool representing the corresponding real value. More... | |
bool | GetInt32FromNormalizedValue (double inNormalizedValue, int32_t *value) const |
Converts a normalized parameter value to an integer representing the corresponding real value. More... | |
bool | GetFloatFromNormalizedValue (double inNormalizedValue, float *value) const |
Converts a normalized parameter value to a float representing the corresponding real value. More... | |
bool | GetDoubleFromNormalizedValue (double inNormalizedValue, double *value) const |
Converts a normalized parameter value to a double representing the corresponding real value. More... | |
Identification methods | |
AAX_CParamID | Identifier () const AAX_OVERRIDE |
Returns the parameter's unique identifier. More... | |
void | SetName (const AAX_CString &name) AAX_OVERRIDE |
Sets the parameter's display name. More... | |
const AAX_CString & | Name () const AAX_OVERRIDE |
Returns the parameter's display name. More... | |
void | AddShortenedName (const AAX_CString &name) AAX_OVERRIDE |
Sets the parameter's shortened display name. More... | |
const AAX_CString & | ShortenedName (int32_t iNumCharacters) const AAX_OVERRIDE |
Returns the parameter's shortened display name. More... | |
void | ClearShortenedNames () AAX_OVERRIDE |
Clears the internal list of shortened display names. More... | |
Taper methods | |
void | SetNormalizedDefaultValue (double normalizedDefault) AAX_OVERRIDE |
Sets the parameter's default value using its normalized representation. More... | |
double | GetNormalizedDefaultValue () const AAX_OVERRIDE |
Returns the normalized representation of the parameter's real default value. More... | |
void | SetToDefaultValue () AAX_OVERRIDE |
Restores the state of this parameter to its default value. More... | |
void | SetNormalizedValue (double newNormalizedValue) AAX_OVERRIDE |
Sets a parameter value using it's normalized representation. More... | |
double | GetNormalizedValue () const AAX_OVERRIDE |
Returns the normalized representation of the parameter's current real value. More... | |
void | SetNumberOfSteps (uint32_t numSteps) AAX_OVERRIDE |
Sets the number of discrete steps for this parameter. More... | |
uint32_t | GetNumberOfSteps () const AAX_OVERRIDE |
Returns the number of discrete steps used by the parameter. More... | |
uint32_t | GetStepValue () const AAX_OVERRIDE |
Returns the current step for the current value of the parameter. More... | |
double | GetNormalizedValueFromStep (uint32_t iStep) const AAX_OVERRIDE |
Returns the normalized value for a given step. More... | |
uint32_t | GetStepValueFromNormalizedValue (double normalizedValue) const AAX_OVERRIDE |
Returns the step value for a normalized value of the parameter. More... | |
void | SetStepValue (uint32_t iStep) AAX_OVERRIDE |
Returns the current step for the current value of the parameter. More... | |
void | SetType (AAX_EParameterType iControlType) AAX_OVERRIDE |
Sets the type of this parameter. More... | |
AAX_EParameterType | GetType () const AAX_OVERRIDE |
Returns the type of this parameter as an AAX_EParameterType. More... | |
void | SetOrientation (AAX_EParameterOrientation iOrientation) AAX_OVERRIDE |
Sets the orientation of this parameter. More... | |
AAX_EParameterOrientation | GetOrientation () const AAX_OVERRIDE |
Returns the orientation of this parameter. More... | |
void | SetTaperDelegate (AAX_ITaperDelegateBase &inTaperDelegate, bool inPreserveValue=true) AAX_OVERRIDE |
Sets the parameter's taper delegate. More... | |
Display methods | |
void | SetDisplayDelegate (AAX_IDisplayDelegateBase &inDisplayDelegate) AAX_OVERRIDE |
Sets the parameter's display delegate. More... | |
bool | GetValueString (AAX_CString *valueString) const AAX_OVERRIDE |
Serializes the parameter value into a string. More... | |
bool | GetValueString (int32_t iMaxNumChars, AAX_CString *valueString) const AAX_OVERRIDE |
Serializes the parameter value into a string, size hint included. More... | |
bool | GetNormalizedValueFromBool (bool value, double *normalizedValue) const AAX_OVERRIDE |
Converts a bool to a normalized parameter value. More... | |
bool | GetNormalizedValueFromInt32 (int32_t value, double *normalizedValue) const AAX_OVERRIDE |
Converts an integer to a normalized parameter value. More... | |
bool | GetNormalizedValueFromFloat (float value, double *normalizedValue) const AAX_OVERRIDE |
Converts a float to a normalized parameter value. More... | |
bool | GetNormalizedValueFromDouble (double value, double *normalizedValue) const AAX_OVERRIDE |
Converts a double to a normalized parameter value. More... | |
bool | GetNormalizedValueFromString (const AAX_CString &valueString, double *normalizedValue) const AAX_OVERRIDE |
Converts a given string to a normalized parameter value. More... | |
bool | GetBoolFromNormalizedValue (double normalizedValue, bool *value) const AAX_OVERRIDE |
Converts a normalized parameter value to a bool representing the corresponding real value. More... | |
bool | GetInt32FromNormalizedValue (double normalizedValue, int32_t *value) const AAX_OVERRIDE |
Converts a normalized parameter value to an integer representing the corresponding real value. More... | |
bool | GetFloatFromNormalizedValue (double normalizedValue, float *value) const AAX_OVERRIDE |
Converts a normalized parameter value to a float representing the corresponding real value. More... | |
bool | GetDoubleFromNormalizedValue (double normalizedValue, double *value) const AAX_OVERRIDE |
Converts a normalized parameter value to a double representing the corresponding real value. More... | |
bool | GetStringFromNormalizedValue (double normalizedValue, AAX_CString &valueString) const AAX_OVERRIDE |
Converts a normalized parameter value to a string representing the corresponding real value. More... | |
bool | GetStringFromNormalizedValue (double normalizedValue, int32_t iMaxNumChars, AAX_CString &valueString) const AAX_OVERRIDE |
Converts a normalized parameter value to a string representing the corresponding real, size hint included. value. More... | |
bool | SetValueFromString (const AAX_CString &newValueString) AAX_OVERRIDE |
Converts a string to a real parameter value and sets the parameter to this value. More... | |
Automation methods | |
void | SetAutomationDelegate (AAX_IAutomationDelegate *iAutomationDelegate) AAX_OVERRIDE |
Sets the automation delegate (if one is required) More... | |
bool | Automatable () const AAX_OVERRIDE |
Returns true if the parameter is automatable, false if it is not. More... | |
void | Touch () AAX_OVERRIDE |
Signals the automation system that a control has been touched. More... | |
void | Release () AAX_OVERRIDE |
Signals the automation system that a control has been released. More... | |
Typed accessors | |
bool | GetValueAsBool (bool *value) const AAX_OVERRIDE |
Retrieves the parameter's value as a bool. More... | |
bool | GetValueAsInt32 (int32_t *value) const AAX_OVERRIDE |
Retrieves the parameter's value as an int32_t. More... | |
bool | GetValueAsFloat (float *value) const AAX_OVERRIDE |
Retrieves the parameter's value as a float. More... | |
bool | GetValueAsDouble (double *value) const AAX_OVERRIDE |
Retrieves the parameter's value as a double. More... | |
bool | GetValueAsString (AAX_IString *value) const AAX_OVERRIDE |
Retrieves the parameter's value as a string. More... | |
bool | SetValueWithBool (bool value) AAX_OVERRIDE |
Sets the parameter's value as a bool. More... | |
bool | SetValueWithInt32 (int32_t value) AAX_OVERRIDE |
Sets the parameter's value as an int32_t. More... | |
bool | SetValueWithFloat (float value) AAX_OVERRIDE |
Sets the parameter's value as a float. More... | |
bool | SetValueWithDouble (double value) AAX_OVERRIDE |
Sets the parameter's value as a double. More... | |
bool | SetValueWithString (const AAX_IString &value) AAX_OVERRIDE |
Sets the parameter's value as a string. More... | |
Host interface methods | |
void | UpdateNormalizedValue (double newNormalizedValue) AAX_OVERRIDE |
Sets the parameter's state given a normalized value. More... | |
![]() | |
virtual | ~AAX_IParameter () |
Virtual destructor. More... | |
Direct methods on AAX_CParameter | |
These methods can be used to access the parameter's state and properties. These methods are specific to the concrete AAX_CParameter class and are not part of the AAX_IParameter interface. | |
AAX_CStringAbbreviations | mNames |
bool | mAutomatable |
uint32_t | mNumSteps |
AAX_EParameterType | mControlType |
AAX_EParameterOrientation | mOrientation |
AAX_ITaperDelegate< T > * | mTaperDelegate |
AAX_IDisplayDelegate< T > * | mDisplayDelegate |
AAX_IAutomationDelegate * | mAutomationDelegate |
bool | mNeedNotify |
AAX_CParameterValue< T > | mValue |
T | mDefaultValue |
void | SetValue (T newValue) |
Initiates a host request to set the parameter's value. More... | |
T | GetValue () const |
Returns the parameter's value. More... | |
void | SetDefaultValue (T newDefaultValue) |
Set the parameter's default value. More... | |
T | GetDefaultValue () const |
Returns the parameter's default value. More... | |
const AAX_ITaperDelegate< T > * | TaperDelegate () const |
Returns a reference to the parameter's taper delegate. More... | |
const AAX_IDisplayDelegate< T > * | DisplayDelegate () const |
Returns a reference to the parameter's display delegate. More... | |
enum AAX_CParameter::Type |
enum AAX_CParameter::Defaults |
AAX_CParameter< T >::AAX_CParameter | ( | AAX_CParamID | identifier, |
const AAX_IString & | name, | ||
T | defaultValue, | ||
const AAX_ITaperDelegate< T > & | taperDelegate, | ||
const AAX_IDisplayDelegate< T > & | displayDelegate, | ||
bool | automatable = false |
||
) |
Constructs an AAX_CParameter object using the specified taper and display delegates.
The delegates are passed in by reference to prevent ambiguities of object ownership. For more information about identifer
and name
, please consult the base AAX_IParameter interface.
[in] | identifier | Unique ID for the parameter, these can only be 31 characters long at most. (the fixed length is a requirement for some optimizations in the host) |
[in] | name | The parameter's unabbreviated display name |
[in] | defaultValue | The parameter's default value |
[in] | taperDelegate | A delegate representing the parameter's taper behavior |
[in] | displayDelegate | A delegate representing the parameter's display conversion behavior |
[in] | automatable | A flag to set whether the parameter will be visible to the host's automation system |
taperDelegate
.As of Pro Tools 10.2, DAE will check for a matching parameter NAME and not an ID when reading in automation data from a session saved with an AAX plug-ins RTAS/TDM counter part.
As of Pro Tools 11.1, AAE will first try to match ID. If that fails, AAE will fall back to matching by Name.
References AAX_CParameter< T >::SetToDefaultValue().
AAX_CParameter< T >::AAX_CParameter | ( | const AAX_IString & | identifier, |
const AAX_IString & | name, | ||
T | defaultValue, | ||
const AAX_ITaperDelegate< T > & | taperDelegate, | ||
const AAX_IDisplayDelegate< T > & | displayDelegate, | ||
bool | automatable = false |
||
) |
Constructs an AAX_CParameter object using the specified taper and display delegates.
This constructor uses an AAX_IString for the parameter identifier, which can be a more flexible solution for some plug-ins.
References AAX_CParameter< T >::SetToDefaultValue().
AAX_CParameter< T >::AAX_CParameter | ( | const AAX_IString & | identifier, |
const AAX_IString & | name, | ||
T | defaultValue, | ||
bool | automatable = false |
||
) |
Constructs an AAX_CParameter object with no delegates.
Delegates may be set on this object after construction. Most parameter operations will not work until after delegages have been set.
References AAX_CParameter< T >::SetToDefaultValue().
AAX_CParameter< T >::AAX_CParameter | ( | const AAX_IString & | identifier, |
const AAX_IString & | name, | ||
bool | automatable = false |
||
) |
Constructs an AAX_CParameter object with no delegates or default value.
Delegates and default value may be set on this object after construction. Most parameter operations will not work until after delegages have been set.
References AAX_CParameter< T >::SetToDefaultValue().
AAX_CParameter< T >::~AAX_CParameter |
Virtual destructor used to delete all locally allocated pointers.
AAX_CParameter< T >::AAX_DEFAULT_MOVE_CTOR | ( | AAX_CParameter< T > | ) |
Move constructor and move assignment operator are allowed
AAX_CParameter< T >::AAX_DEFAULT_MOVE_OPER | ( | AAX_CParameter< T > | ) |
AAX_CParameter< T >::AAX_DELETE | ( | AAX_CParameter< T >() | ) |
Default constructor not allowed, except by possible wrappering classes.
AAX_CParameter< T >::AAX_DELETE | ( | AAX_CParameter< T >(const AAX_CParameter< T > &other) | ) |
AAX_CParameter< T >::AAX_DELETE | ( | AAX_CParameter< T > & | operator = (const AAX_CParameter< T > &other) | ) |
|
virtual |
Clone the parameter's value to a new AAX_IParameterValue object.
The returned object is independent from the AAX_IParameter. For example, changing the state of the returned object will not result in a change to the original AAX_IParameter.
Implements AAX_IParameter.
|
virtual |
Returns the parameter's unique identifier.
This unique ID is used by the Parameter Manager and by outside applications to uniquely identify and target control messages. This value may not be changed after the parameter has been constructed.
Implements AAX_IParameter.
|
virtual |
Sets the parameter's display name.
This name is used for display only, it is not used for indexing or identifying the parameter This name may be changed after the parameter has been created, but display name changes may not be recognized by all AAX hosts.
[in] | name | Display name that will be assigned to the parameter |
Implements AAX_IParameter.
|
virtual |
Returns the parameter's display name.
Implements AAX_IParameter.
|
virtual |
Sets the parameter's shortened display name.
This name is used for display only, it is not used for indexing or identifying the parameter These names show up when the host asks for shorter length parameter names for display on Control Surfaces or other string length constrained situations.
[in] | name | Shortened display names that will be assigned to the parameter |
Implements AAX_IParameter.
|
virtual |
Returns the parameter's shortened display name.
Implements AAX_IParameter.
References AAX_CString::Get().
|
virtual |
Clears the internal list of shortened display names.
Implements AAX_IParameter.
|
virtual |
Sets the parameter's default value using its normalized representation.
Implements AAX_IParameter.
|
virtual |
Returns the normalized representation of the parameter's real default value.
Implements AAX_IParameter.
|
virtual |
Restores the state of this parameter to its default value.
Implements AAX_IParameter.
Referenced by AAX_CParameter< T >::AAX_CParameter().
|
virtual |
Sets a parameter value using it's normalized representation.
For more information regarding normalized values, see Parameter Manager
[in] | newNormalizedValue | New value (normalized) to which the parameter will be set |
Implements AAX_IParameter.
|
virtual |
Returns the normalized representation of the parameter's current real value.
Implements AAX_IParameter.
|
virtual |
Sets the number of discrete steps for this parameter.
Stepped parameter values are useful for discrete parameters and for "jumping" events such as mouse wheels, page up/down, etc. The parameter's step size is used to specify the coarseness of those changes.
[in] | numSteps | The number of steps that the parameter will use |
Implements AAX_IParameter.
References AAX_ASSERT.
|
virtual |
Returns the number of discrete steps used by the parameter.
See SetNumberOfSteps() for more information about parameter steps.
Implements AAX_IParameter.
|
virtual |
Returns the current step for the current value of the parameter.
See SetNumberOfSteps() for more information about parameter steps.
Implements AAX_IParameter.
|
virtual |
Returns the normalized value for a given step.
See SetNumberOfSteps() for more information about parameter steps.
Implements AAX_IParameter.
|
virtual |
Returns the step value for a normalized value of the parameter.
See SetNumberOfSteps() for more information about parameter steps.
Implements AAX_IParameter.
|
virtual |
Returns the current step for the current value of the parameter.
See SetNumberOfSteps() for more information about parameter steps.
Implements AAX_IParameter.
|
virtual |
Sets the type of this parameter.
See GetType for use cases
[in] | iControlType | The parameter's new type as an AAX_EParameterType |
Implements AAX_IParameter.
|
virtual |
Returns the type of this parameter as an AAX_EParameterType.
Implements AAX_IParameter.
|
virtual |
Sets the orientation of this parameter.
[in] | iOrientation | The parameter's new orientation |
Implements AAX_IParameter.
|
virtual |
Returns the orientation of this parameter.
Implements AAX_IParameter.
|
virtual |
Sets the parameter's taper delegate.
[in] | inTaperDelegate | A reference to the parameter's new taper delegate |
[in] | inPreserveValue |
Implements AAX_IParameter.
References AAX_ITaperDelegate< T >::Clone().
|
virtual |
Sets the parameter's display delegate.
[in] | inDisplayDelegate | A reference to the parameter's new display delegate |
Implements AAX_IParameter.
References AAX_IDisplayDelegate< T >::Clone().
|
virtual |
Serializes the parameter value into a string.
[out] | valueString | A string representing the parameter's real value |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Serializes the parameter value into a string, size hint included.
[in] | iMaxNumChars | A size hint for the size of the string being requested. Useful for control surfaces and other limited area text fields. (make sure that size of desired string also has room for null termination) |
[out] | valueString | A string representing the parameter's real value |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a bool to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts an integer to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a float to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a double to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a given string to a normalized parameter value.
[in] | valueString | A string representing a possible real value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with valueString |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a bool representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to bool was successful |
false | The conversion to bool was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to an integer representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to int32_t was successful |
false | The conversion to int32_t was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a float representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to float was successful |
false | The conversion to float was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a double representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to double was successful |
false | The conversion to double was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a string representing the corresponding real value.
[in] | normalizedValue | A normalized parameter value |
[out] | valueString | A string representing the parameter value associated with normalizedValue |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a string representing the corresponding real, size hint included. value.
[in] | normalizedValue | A normalized parameter value |
[in] | iMaxNumChars | A size hint for the size of the string being requested. Useful for control surfaces and other limited area text fields. (make sure that size of desired string also has room for null termination) |
[out] | valueString | A string representing the parameter value associated with normalizedValue |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a string to a real parameter value and sets the parameter to this value.
[in] | newValueString | A string representing the parameter's new real value |
true | The string conversion was successful |
false | The string conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the automation delegate (if one is required)
[in] | iAutomationDelegate | A reference to the parameter manager's automation delegate interface |
Implements AAX_IParameter.
References AAX_IAutomationDelegate::RegisterParameter().
|
virtual |
Returns true if the parameter is automatable, false if it is not.
Implements AAX_IParameter.
|
virtual |
Signals the automation system that a control has been touched.
Call this method in response to GUI events that begin editing, such as a mouse down. After this method has been called you are free to call SetNormalizedValue() as much as you need, e.g. in order to respond to subsequent mouse moved events. Call Release() to free the parameter for updates from other controls.
Implements AAX_IParameter.
|
virtual |
Signals the automation system that a control has been released.
Call this method in response to GUI events that complete editing, such as a mouse up. Once this method has been called you should not call SetNormalizedValue() again until after the next call to Touch().
Implements AAX_IParameter.
|
virtual |
Retrieves the parameter's value as a bool.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to bool was successful |
false | The conversion to bool was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Retrieves the parameter's value as an int32_t.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to int32_t was successful |
false | The conversion to int32_t was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Retrieves the parameter's value as a float.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to float was successful |
false | The conversion to float was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Retrieves the parameter's value as a double.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to double was successful |
false | The conversion to double was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Retrieves the parameter's value as a string.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to string was successful |
false | The conversion to string was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a bool.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from bool was successful |
false | The conversion from bool was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as an int32_t.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from int32_t was successful |
false | The conversion from int32_t was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a float.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from float was successful |
false | The conversion from float was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a double.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from double was successful |
false | The conversion from double was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a string.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from string was successful |
false | The conversion from string was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's state given a normalized value.
This is the second half of the parameter setting operation that is initiated with a call to SetValue(). Parameters should not be set directly using this method; instead, use SetValue().
[in] | newNormalizedValue | Normalized value that will be used to set the parameter's new state |
Implements AAX_IParameter.
void AAX_CParameter< T >::SetValue | ( | T | newValue | ) |
Initiates a host request to set the parameter's value.
This method normalizes the provided value and sends a request for the value change to the AAX host. The host responds with a call to AAX_IParameter::UpdateNormalizedValue() to complete the set operation.
[in] | newValue | The parameter's new value |
T AAX_CParameter< T >::GetValue |
Returns the parameter's value.
This is the parameter's real, logical value and should not be normalized
void AAX_CParameter< T >::SetDefaultValue | ( | T | newDefaultValue | ) |
Set the parameter's default value.
This is the parameter's real, logical value and should not be normalized
[in] | newDefaultValue | The parameter's new default value |
T AAX_CParameter< T >::GetDefaultValue |
Returns the parameter's default value.
This is the parameter's real, logical value and should not be normalized
const AAX_ITaperDelegate< T > * AAX_CParameter< T >::TaperDelegate |
Returns a reference to the parameter's taper delegate.
const AAX_IDisplayDelegate< T > * AAX_CParameter< T >::DisplayDelegate |
Returns a reference to the parameter's display delegate.
|
virtual |
Retrieves the parameter's value as a string.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion to string was successful |
false | The conversion to string was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a bool.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from bool was successful |
false | The conversion from bool was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as an int32_t.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from int32_t was successful |
false | The conversion from int32_t was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a float.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from float was successful |
false | The conversion from float was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a double.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from double was successful |
false | The conversion from double was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Sets the parameter's value as a string.
[out] | value | The parameter's real value. Set only if conversion is successful. |
true | The conversion from string was successful |
false | The conversion from string was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a bool to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts an integer to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a float to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a double to a normalized parameter value.
[in] | value | A value for the parameter |
[out] | normalizedValue | The normalized parameter value associated with value |
true | The value conversion was successful |
false | The value conversion was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a bool representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to bool was successful |
false | The conversion to bool was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to an integer representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to int32_t was successful |
false | The conversion to int32_t was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a float representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to float was successful |
false | The conversion to float was unsuccessful |
Implements AAX_IParameter.
|
virtual |
Converts a normalized parameter value to a double representing the corresponding real value.
[in] | normalizedValue | The normalized value to convert |
[out] | value | The converted value. Set only if conversion is successful. |
true | The conversion to double was successful |
false | The conversion to double was unsuccessful |
Implements AAX_IParameter.
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |