AAX_CParameter.h

Go to the documentation of this file.

/*================================================================================================*/
/*
 *
 *  Copyright 2013-2017, 2019, 2021, 2023 Avid Technology, Inc.
 *  All rights reserved.
 *  
 *  CONFIDENTIAL: this document contains confidential information of Avid. Do
 *  not disclose to any third party. Use of the information contained in this
 *  document is subject to an Avid SDK license.
 *
 */
 
/*================================================================================================*/
 
 
#ifndef AAX_CPARAMETER_H
#define AAX_CPARAMETER_H
 
#include "AAX_Assert.h"
#include "AAX_IParameter.h"
#include "AAX_ITaperDelegate.h"
#include "AAX_IDisplayDelegate.h"
#include "AAX_IAutomationDelegate.h"
#include "AAX_CString.h"                    //concrete class required for name.
 
#include <cstring>
#include <list>
#include <map>
 
 
#if 0
#pragma mark -
#endif
 
 
template <typename T>
class AAX_CParameterValue : public AAX_IParameterValue
{
public:
    enum Defaults {
        eParameterDefaultMaxIdentifierSize = kAAX_ParameterIdentifierMaxSize,
        eParameterDefaultMaxIdentifierLength = eParameterDefaultMaxIdentifierSize - 1 // NULL terminated
    };
    
public:
    AAX_DEFAULT_DTOR_OVERRIDE(AAX_CParameterValue);
    
    AAX_DEFAULT_MOVE_CTOR(AAX_CParameterValue);
    AAX_DEFAULT_MOVE_OPER(AAX_CParameterValue);
    
    AAX_DELETE(AAX_CParameterValue& operator=(const AAX_CParameterValue&));
    
    explicit AAX_CParameterValue(AAX_CParamID identifier);
    
    explicit AAX_CParameterValue(AAX_CParamID identifier, const T& value);
    
    explicit AAX_CParameterValue(const AAX_CParameterValue<T>& other);
    
public: // AAX_CParameterValue<T> implementation
    const T& Get() const { return mValue; }
    void Set(const T& inValue) { mValue = inValue; }
    
public: // AAX_IParameterValue implementation
    
    AAX_IParameterValue*    Clone() const AAX_OVERRIDE { return new AAX_CParameterValue<T>(*this); }
    AAX_CParamID            Identifier() const AAX_OVERRIDE { return mIdentifier; }
    
    bool                    GetValueAsBool(bool* value) const AAX_OVERRIDE; 
    bool                    GetValueAsInt32(int32_t* value) const AAX_OVERRIDE; 
    bool                    GetValueAsFloat(float* value) const AAX_OVERRIDE; 
    bool                    GetValueAsDouble(double* value) const AAX_OVERRIDE; 
    bool                    GetValueAsString(AAX_IString* value) const AAX_OVERRIDE; 
    
private:
    void InitIdentifier(const char* inIdentifier);
    
private:
    char mIdentifier[eParameterDefaultMaxIdentifierSize];
    T mValue;
};
 
 
 
template <typename T>
AAX_CParameterValue<T>::AAX_CParameterValue(AAX_CParamID identifier)
: mValue()
{
    InitIdentifier(identifier);
}
 
template <typename T>
AAX_CParameterValue<T>::AAX_CParameterValue(AAX_CParamID identifier, const T& value)
: mValue(value)
{
    InitIdentifier(identifier);
}
 
template <typename T>
AAX_CParameterValue<T>::AAX_CParameterValue(const AAX_CParameterValue<T>& other)
: mValue(other.mValue)
{
    InitIdentifier(other.mIdentifier);
}
 
template<typename T>
bool        AAX_CParameterValue<T>::GetValueAsBool(bool* /*value*/) const
{
    return false;
}
template <>
bool        AAX_CParameterValue<bool>::GetValueAsBool(bool* value) const;
 
 
template<typename T>
bool        AAX_CParameterValue<T>::GetValueAsInt32(int32_t* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameterValue<int32_t>::GetValueAsInt32(int32_t* value) const;
 
template<typename T>
bool        AAX_CParameterValue<T>::GetValueAsFloat(float* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameterValue<float>::GetValueAsFloat(float* value) const;
 
template<typename T>
bool        AAX_CParameterValue<T>::GetValueAsDouble(double* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameterValue<double>::GetValueAsDouble(double* value) const;
 
template<typename T>
bool        AAX_CParameterValue<T>::GetValueAsString(AAX_IString* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameterValue<AAX_CString>::GetValueAsString(AAX_IString* value) const;
 
template<typename T>
void AAX_CParameterValue<T>::InitIdentifier(const char *inIdentifier)
{
 
    const size_t len = strlen(inIdentifier);
    AAX_ASSERT(len < eParameterDefaultMaxIdentifierSize);
    if (len < eParameterDefaultMaxIdentifierSize)
    {
        std::strncpy(mIdentifier, inIdentifier, 1+len);
        mIdentifier[len] = 0;
    }
    else
    {
        std::strncpy(mIdentifier, inIdentifier, eParameterDefaultMaxIdentifierLength);
        mIdentifier[eParameterDefaultMaxIdentifierLength] = 0;
    }
}
 
 
#if 0
#pragma mark -
#endif
 
 
template <typename T>
class AAX_CParameter : public AAX_IParameter
{
public:
    
    enum Type {
        eParameterTypeUndefined = 0,
        eParameterTypeBool = 1,
        eParameterTypeInt32 = 2,
        eParameterTypeFloat = 3,
        eParameterTypeCustom = 4
    };
    
    enum Defaults {
        eParameterDefaultNumStepsDiscrete = 2,
        eParameterDefaultNumStepsContinuous = 128
    };
    
    AAX_CParameter(AAX_CParamID identifier, const AAX_IString& name, T defaultValue, const AAX_ITaperDelegate<T>& taperDelegate, const AAX_IDisplayDelegate<T>& displayDelegate, bool automatable=false);
    
    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);
    
    AAX_CParameter(const AAX_IString& identifier, const AAX_IString& name, T defaultValue, bool automatable=false);
    
    AAX_CParameter(const AAX_IString& identifier, const AAX_IString& name, bool automatable=false);
    
    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;
    
    AAX_IParameterValue*    CloneValue() const AAX_OVERRIDE; 
    
    AAX_CParamID        Identifier() const AAX_OVERRIDE; 
    void                SetName(const AAX_CString& name) AAX_OVERRIDE; 
    const AAX_CString&  Name() const AAX_OVERRIDE; 
    void                AddShortenedName(const AAX_CString& name) AAX_OVERRIDE; 
    const AAX_CString&  ShortenedName(int32_t iNumCharacters) const AAX_OVERRIDE; 
    void                ClearShortenedNames() AAX_OVERRIDE; 
 
    void                SetNormalizedDefaultValue(double normalizedDefault) AAX_OVERRIDE; 
    double              GetNormalizedDefaultValue() const AAX_OVERRIDE; 
    void                SetToDefaultValue() AAX_OVERRIDE; 
    void                SetNormalizedValue(double newNormalizedValue) AAX_OVERRIDE; 
    double              GetNormalizedValue() const AAX_OVERRIDE; 
    void                SetNumberOfSteps(uint32_t numSteps) AAX_OVERRIDE; 
    uint32_t            GetNumberOfSteps() const AAX_OVERRIDE; 
    uint32_t            GetStepValue() const AAX_OVERRIDE; 
    double              GetNormalizedValueFromStep(uint32_t iStep) const AAX_OVERRIDE; 
    uint32_t            GetStepValueFromNormalizedValue(double normalizedValue) const AAX_OVERRIDE; 
    void                SetStepValue(uint32_t iStep) AAX_OVERRIDE; 
    void                SetType(AAX_EParameterType iControlType) AAX_OVERRIDE; 
    AAX_EParameterType  GetType() const AAX_OVERRIDE; 
    void                SetOrientation( AAX_EParameterOrientation iOrientation ) AAX_OVERRIDE; 
    AAX_EParameterOrientation   GetOrientation() const AAX_OVERRIDE; 
    void                SetTaperDelegate(AAX_ITaperDelegateBase& inTaperDelegate,bool inPreserveValue=true) AAX_OVERRIDE; 
 
    void                SetDisplayDelegate(AAX_IDisplayDelegateBase& inDisplayDelegate) AAX_OVERRIDE; 
    bool                GetValueString( AAX_CString* valueString) const AAX_OVERRIDE; 
    bool                GetValueString(int32_t iMaxNumChars, AAX_CString* valueString) const AAX_OVERRIDE; 
    bool                GetNormalizedValueFromBool(bool value, double *normalizedValue) const AAX_OVERRIDE; 
    bool                GetNormalizedValueFromInt32(int32_t value, double *normalizedValue) const AAX_OVERRIDE; 
    bool                GetNormalizedValueFromFloat(float value, double *normalizedValue) const AAX_OVERRIDE; 
    bool                GetNormalizedValueFromDouble(double value, double *normalizedValue) const AAX_OVERRIDE; 
    bool                GetNormalizedValueFromString(const AAX_CString& valueString, double *normalizedValue) const AAX_OVERRIDE; 
    bool                GetBoolFromNormalizedValue(double normalizedValue, bool* value) const AAX_OVERRIDE; 
    bool                GetInt32FromNormalizedValue(double normalizedValue, int32_t* value) const AAX_OVERRIDE; 
    bool                GetFloatFromNormalizedValue(double normalizedValue, float* value) const AAX_OVERRIDE; 
    bool                GetDoubleFromNormalizedValue(double normalizedValue, double* value) const AAX_OVERRIDE; 
    bool                GetStringFromNormalizedValue(double normalizedValue, AAX_CString& valueString) const AAX_OVERRIDE; 
    bool                GetStringFromNormalizedValue(double normalizedValue, int32_t iMaxNumChars, AAX_CString& valueString) const AAX_OVERRIDE; 
    bool                SetValueFromString(const AAX_CString&   newValueString) AAX_OVERRIDE; 
 
    void                SetAutomationDelegate ( AAX_IAutomationDelegate * iAutomationDelegate ) AAX_OVERRIDE; 
    bool                Automatable() const AAX_OVERRIDE; 
    void                Touch() AAX_OVERRIDE; 
    void                Release() AAX_OVERRIDE; 
    
    bool                GetValueAsBool(bool* value) const AAX_OVERRIDE; 
    bool                GetValueAsInt32(int32_t* value) const AAX_OVERRIDE; 
    bool                GetValueAsFloat(float* value) const AAX_OVERRIDE; 
    bool                GetValueAsDouble(double* value) const AAX_OVERRIDE; 
    bool                GetValueAsString(AAX_IString* value) const AAX_OVERRIDE; 
    bool                SetValueWithBool(bool value) AAX_OVERRIDE; 
    bool                SetValueWithInt32(int32_t value) AAX_OVERRIDE; 
    bool                SetValueWithFloat(float value) AAX_OVERRIDE; 
    bool                SetValueWithDouble(double value) AAX_OVERRIDE; 
    bool                SetValueWithString(const AAX_IString& value) AAX_OVERRIDE; 
    
    void                UpdateNormalizedValue(double newNormalizedValue) AAX_OVERRIDE; 
    
    void                            SetValue(T newValue );
    T                               GetValue() const;
    void                            SetDefaultValue(T newDefaultValue);
    T                               GetDefaultValue() const;
    const AAX_ITaperDelegate<T>*    TaperDelegate() const;
    const AAX_IDisplayDelegate<T>*  DisplayDelegate() const;
    
protected:
    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;
    
private:
    void InitializeNumberOfSteps();
};
 
 
 
template <typename T>
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)
: mNames(name)
, mAutomatable(automatable)
, mNumSteps(0) // Default set below for discrete/continuous
, mControlType( AAX_eParameterType_Continuous )
, mOrientation( AAX_eParameterOrientation_Default )
, mTaperDelegate(taperDelegate.Clone())
, mDisplayDelegate(displayDelegate.Clone())
, mAutomationDelegate(0)
, mNeedNotify(true)
, mValue(identifier)
, mDefaultValue(defaultValue)
{ 
    this->InitializeNumberOfSteps();
    this->SetToDefaultValue();
}
 
template <typename T>
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)
: mNames(name)
, mAutomatable(automatable)
, mNumSteps(0) // Default set below for discrete/continuous
, mControlType( AAX_eParameterType_Continuous )
, mOrientation( AAX_eParameterOrientation_Default )
, mTaperDelegate(taperDelegate.Clone())
, mDisplayDelegate(displayDelegate.Clone())
, mAutomationDelegate(0)
, mNeedNotify(true)
, mValue(identifier.Get())
, mDefaultValue(defaultValue)
{
    this->InitializeNumberOfSteps();
    this->SetToDefaultValue();
}
 
template <typename T>
AAX_CParameter<T>::AAX_CParameter(const AAX_IString& identifier, const AAX_IString& name, T defaultValue, bool automatable)
: mNames(name)
, mAutomatable(automatable)
, mNumSteps(0)
, mControlType( AAX_eParameterType_Continuous )
, mOrientation( AAX_eParameterOrientation_Default )
, mTaperDelegate(NULL)
, mDisplayDelegate(NULL)
, mAutomationDelegate(NULL)
, mNeedNotify(true)
, mValue(identifier)
, mDefaultValue(defaultValue)
{
    this->InitializeNumberOfSteps();
    this->SetToDefaultValue();
}
 
template <typename T>
AAX_CParameter<T>::AAX_CParameter(const AAX_IString& identifier, const AAX_IString& name, bool automatable)
: mNames(name)
, mAutomatable(automatable)
, mNumSteps(0)
, mControlType( AAX_eParameterType_Continuous )
, mOrientation( AAX_eParameterOrientation_Default )
, mTaperDelegate(NULL)
, mDisplayDelegate(NULL)
, mAutomationDelegate(NULL)
, mNeedNotify(true)
, mValue(identifier)
, mDefaultValue()
{
    this->InitializeNumberOfSteps();
    this->SetToDefaultValue(); // WARNING: uninitialized default value
}
 
template <typename T>
AAX_CParameter<T>::~AAX_CParameter()
{
    //Make sure to remove any registration with the token system.
    SetAutomationDelegate(0);
    
    delete mTaperDelegate;
    mTaperDelegate = 0;
    delete mDisplayDelegate;
    mDisplayDelegate = 0;
}
 
template <typename T>
AAX_IParameterValue*    AAX_CParameter<T>::CloneValue() const
{
    return new AAX_CParameterValue<T>(mValue);
}
 
template <typename T>
AAX_CParamID        AAX_CParameter<T>::Identifier() const                   
{   
    return mValue.Identifier();
}
 
template <typename T>
void        AAX_CParameter<T>::SetName(const AAX_CString& name) 
{   
    mNames.SetPrimary(name);
    if (mAutomationDelegate) {
        mAutomationDelegate->ParameterNameChanged(this->Identifier());
    }
}
 
template <typename T>
const AAX_CString&  AAX_CParameter<T>::Name() const                     
{   
    return mNames.Primary();
}
 
template <typename T>
void    AAX_CParameter<T>::AddShortenedName(const AAX_CString& name)
{
    mNames.Add(name);
}
 
template <typename T>
const AAX_CString&  AAX_CParameter<T>::ShortenedName(int32_t iNumCharacters) const
{
    return mNames.Get(iNumCharacters);
}
 
template <typename T>
void                AAX_CParameter<T>::ClearShortenedNames()
{
    mNames.Clear();
}
 
 
 
template<typename T>
void    AAX_CParameter<T>::SetValue( T newValue )
{
    double  newNormalizedValue = mTaperDelegate->RealToNormalized(newValue);
 
    // <DMT> Always go through the automation delegate even if the control isn't automatable to prevent fighting with other GUIs.
    // Somewhere back in the automation delegate, or elsewhere in the system, it will determine the differences in behavior surrounding
    // automation.  The only reason that there wouldn't be an automation delegate is if this parameter has yet to be added to a
    // ParameterManager.  Let's put the null value guards in place, just in case, and also for unit tests.
    if ( mAutomationDelegate )
    {
        //TODO: Create RAII utility class for touch/release
        
        //Touch the control
        Touch();
        
        //Send that token.
        mAutomationDelegate->PostSetValueRequest(Identifier(), newNormalizedValue );
 
        //Release the control
        Release();
    }
    else
    {
        mNeedNotify = true;
 
        // In the rare case that an automation delegate doesn't exist, lets still set the value.  It's possible that someone is trying to
        // set the new value before adding the parameter to a parametermanager.
        UpdateNormalizedValue(newNormalizedValue);
    }
}
 
template <typename T>
void    AAX_CParameter<T>::UpdateNormalizedValue(double newNormalizedValue)
{
    T newValue = mTaperDelegate->NormalizedToReal(newNormalizedValue);
    if (mNeedNotify || (mValue.Get() != newValue))
    {
        //Set the new value
        mValue.Set(newValue);
                
        //<DMT> Always notify that the value has changed through the automation delegate to guarantee that all control surfaces and other
        // GUIs get their values updated.
        if (mAutomationDelegate)
            mAutomationDelegate->PostCurrentValue(Identifier(), newNormalizedValue);
 
        // clear flag
        mNeedNotify = false;
    }   
}
 
template <typename T>
void    AAX_CParameter<T>::InitializeNumberOfSteps()
{
    if (mNumSteps == 0) // If no explicit number of steps has been set...
    {
        switch (mControlType)
        {
            case AAX_eParameterType_Discrete:
            {
                // Discrete parameters default to binary unless
                // otherwise specified
                this->SetNumberOfSteps (eParameterDefaultNumStepsDiscrete);
                break;
            }
            case AAX_eParameterType_Continuous:
            {
                // Defaulting to 128 steps to match one full rotation of
                // Command|8 and similar surfaces, which query the num
                // steps to determine tick values for rotary encoders
                this->SetNumberOfSteps (eParameterDefaultNumStepsContinuous);
                break;
            }
            default:
            {
                AAX_ASSERT (0); // Invalid type
                break;
            }
        }
    }
}
 
template<typename T>
T       AAX_CParameter<T>::GetValue()   const
{
    return mValue.Get();
}
 
 
template<typename T>
bool        AAX_CParameter<T>::GetValueAsBool(bool* value) const
{
    return mValue.GetValueAsBool(value);
}
 
template<typename T>
bool        AAX_CParameter<T>::GetValueAsInt32(int32_t* value) const
{
    return mValue.GetValueAsInt32(value);
}
 
template<typename T>
bool        AAX_CParameter<T>::GetValueAsFloat(float* value) const
{
    return mValue.GetValueAsFloat(value);
}
 
template<typename T>
bool        AAX_CParameter<T>::GetValueAsDouble(double* value) const
{
    return mValue.GetValueAsDouble(value);
}
 
template<typename T>
bool        AAX_CParameter<T>::GetValueAsString(AAX_IString* value) const
{
    bool result = false;
    if (value)
    {
        AAX_CString valueString;
        result = this->GetValueString(&valueString);
        if (true == result)
        {
            *value = valueString;
        }
    }
    return result;
}
 
template<>
bool        AAX_CParameter<AAX_CString>::GetValueAsString(AAX_IString* /*value*/) const;
 
 
template<typename T>
bool        AAX_CParameter<T>::SetValueWithBool(bool /*value*/)
{
    return false;
}
template<>
bool        AAX_CParameter<bool>::SetValueWithBool(bool value);
 
template<typename T>
bool        AAX_CParameter<T>::SetValueWithInt32(int32_t /*value*/)
{
    return false;
}
template<>
bool        AAX_CParameter<int32_t>::SetValueWithInt32(int32_t value);
 
template<typename T>
bool        AAX_CParameter<T>::SetValueWithFloat(float /*value*/)
{
    return false;
}
template<>
bool        AAX_CParameter<float>::SetValueWithFloat(float value);
 
template<typename T>
bool        AAX_CParameter<T>::SetValueWithDouble(double /*value*/)
{
    return false;
}
template<>
bool        AAX_CParameter<double>::SetValueWithDouble(double value);
 
template<typename T>
bool        AAX_CParameter<T>::SetValueWithString(const AAX_IString& value)
{
    const AAX_CString valueString(value);
    return this->SetValueFromString(valueString);
}
template<>
bool        AAX_CParameter<AAX_CString>::SetValueWithString(const AAX_IString& value);
 
template<typename T>
void    AAX_CParameter<T>::SetNormalizedDefaultValue(double newNormalizedDefault)
{
    T newDefaultValue = mTaperDelegate->NormalizedToReal(newNormalizedDefault);
    SetDefaultValue(newDefaultValue);
}
 
template<typename T>
double  AAX_CParameter<T>::GetNormalizedDefaultValue() const
{
    double normalizedDefault = mTaperDelegate->RealToNormalized(mDefaultValue);
    return normalizedDefault;
}
 
template<typename T>
void    AAX_CParameter<T>::SetDefaultValue(T newDefaultValue)
{
    newDefaultValue = mTaperDelegate->ConstrainRealValue(newDefaultValue);
    mDefaultValue = newDefaultValue;
}
 
template<typename T>
T       AAX_CParameter<T>::GetDefaultValue() const
{
    return mDefaultValue;
}
 
template<typename T>
void    AAX_CParameter<T>::SetToDefaultValue()
{
    SetValue(mDefaultValue);
}
 
template<typename T>
void    AAX_CParameter<T>::SetNumberOfSteps(uint32_t numSteps)
{
    AAX_ASSERT(0 < numSteps);
    if (0 < numSteps)
    {
        mNumSteps = numSteps;
    }
}
 
template<typename T>
uint32_t    AAX_CParameter<T>::GetNumberOfSteps() const
{
    return mNumSteps;
}
 
template<typename T>
uint32_t    AAX_CParameter<T>::GetStepValue() const
{
    return GetStepValueFromNormalizedValue(this->GetNormalizedValue());
}
 
template<typename T>
double      AAX_CParameter<T>::GetNormalizedValueFromStep(uint32_t iStep) const
{
    double  numSteps = (double) this->GetNumberOfSteps ();
    if ( numSteps < 2.0 )
        return 0.0;
    
    double  valuePerStep = 1.0 / ( numSteps - 1.0 );
    double  value = valuePerStep * (double) iStep;
    if ( value < 0.0 )
        value = 0.0;
    else if ( value > 1.0 )
        value = 1.0;
    
    return value;
}
 
template<typename T>
uint32_t    AAX_CParameter<T>::GetStepValueFromNormalizedValue(double normalizedValue) const
{
    double  numSteps = (double) this->GetNumberOfSteps ();
    if ( numSteps < 2.0 )
        return 0;
    
    double  valuePerStep = 1.0 / ( numSteps - 1.0 );
    double  curStep = ( normalizedValue / valuePerStep ) + 0.5;
    if ( curStep < 0.0 )
        curStep = 0.0;
    else if ( curStep > (double) ( numSteps - 1.0 ) )
        curStep = (double) ( numSteps - 1.0 );
    
    return (uint32_t) curStep;
}
 
template<typename T>
void    AAX_CParameter<T>::SetStepValue(uint32_t iStep)
{
    double  numSteps = (double) this->GetNumberOfSteps ();
    if ( numSteps < 2.0 )
        return;
    
    this->SetNormalizedValue ( GetNormalizedValueFromStep(iStep) );
}
 
template<typename T>
void    AAX_CParameter<T>::SetType(AAX_EParameterType iControlType)
{
    mControlType = iControlType;
}
 
template<typename T>
AAX_EParameterType  AAX_CParameter<T>::GetType() const
{
    return mControlType;
}
 
template<typename T>
void    AAX_CParameter<T>::SetOrientation(AAX_EParameterOrientation iOrientation)
{
    mOrientation = iOrientation;
}
 
template<typename T>
AAX_EParameterOrientation   AAX_CParameter<T>::GetOrientation() const
{
    return mOrientation;
}
 
template<typename T>
void    AAX_CParameter<T>::SetNormalizedValue(double normalizedNewValue)
{
    T newValue = mTaperDelegate->NormalizedToReal(normalizedNewValue);
    this->SetValue(newValue);
}
 
template<typename T>
double  AAX_CParameter<T>::GetNormalizedValue() const
{
    T val = GetValue();
    return mTaperDelegate->RealToNormalized(val);
}   
 
 
template<typename T>
bool    AAX_CParameter<T>::GetValueString(AAX_CString*  valueString) const
{
    return mDisplayDelegate->ValueToString(this->GetValue(), valueString);
}
 
template<typename T>
bool    AAX_CParameter<T>::GetValueString(int32_t /*iMaxNumChars*/, AAX_CString*    valueString) const
{
    return mDisplayDelegate->ValueToString(this->GetValue(), valueString);
}
 
template <typename T>
bool    AAX_CParameter<T>::GetNormalizedValueFromBool(bool /*value*/, double * /*normalizedValue*/) const
{
    return false;
}
template <>
bool    AAX_CParameter<bool>::GetNormalizedValueFromBool(bool value, double *normalizedValue) const;
 
template <typename T>
bool    AAX_CParameter<T>::GetNormalizedValueFromInt32(int32_t /*value*/, double * /*normalizedValue*/) const
{
    return false;
}
template <>
bool    AAX_CParameter<int32_t>::GetNormalizedValueFromInt32(int32_t value, double *normalizedValue) const;
 
template <typename T>
bool    AAX_CParameter<T>::GetNormalizedValueFromFloat(float /*value*/, double * /*normalizedValue*/) const
{
    return false;
}
template <>
bool    AAX_CParameter<float>::GetNormalizedValueFromFloat(float value, double *normalizedValue) const;
 
template <typename T>
bool    AAX_CParameter<T>::GetNormalizedValueFromDouble(double /*value*/, double * /*normalizedValue*/) const
{
    return false;
}
template <>
bool    AAX_CParameter<double>::GetNormalizedValueFromDouble(double value, double *normalizedValue) const;
 
template <typename T>
bool    AAX_CParameter<T>::GetNormalizedValueFromString(const AAX_CString&  valueString, double *normalizedValue) const
{
    //First, convert the string to a value using the wrapped parameter's display delegate.
    T value;
    if (!mDisplayDelegate->StringToValue(valueString, &value))
        return false;
    
    //Then use the wrapped parameter's taper delegate to convert to a normalized representation.
    //If the parameter is out of range, the normalizedValue will be clamped just to be safe.
    *normalizedValue = mTaperDelegate->RealToNormalized(value); 
    return true;    
}
 
template<typename T>
bool        AAX_CParameter<T>::GetBoolFromNormalizedValue(double /*inNormalizedValue*/, bool* /*value*/) const
{
    return false;
}
template <>
bool        AAX_CParameter<bool>::GetBoolFromNormalizedValue(double inNormalizedValue, bool* value) const;
 
 
template<typename T>
bool        AAX_CParameter<T>::GetInt32FromNormalizedValue(double /*inNormalizedValue*/, int32_t* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameter<int32_t>::GetInt32FromNormalizedValue(double inNormalizedValue, int32_t* value) const;
 
template<typename T>
bool        AAX_CParameter<T>::GetFloatFromNormalizedValue(double /*inNormalizedValue*/, float* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameter<float>::GetFloatFromNormalizedValue(double inNormalizedValue, float* value) const;
 
template<typename T>
bool        AAX_CParameter<T>::GetDoubleFromNormalizedValue(double /*inNormalizedValue*/, double* /*value*/) const
{
    return false;
}
template<>
bool        AAX_CParameter<double>::GetDoubleFromNormalizedValue(double inNormalizedValue, double* value) const;
 
template <typename T>
bool    AAX_CParameter<T>::GetStringFromNormalizedValue(double normalizedValue, AAX_CString&    valueString) const
{
    T value = mTaperDelegate->NormalizedToReal(normalizedValue);
    if (!mDisplayDelegate->ValueToString(value, &valueString))
        return false;   
    
    //If the parameter is out of range, we should probably return false, even though we clamped the normalizedValue already just to be safe.
    if ((value > mTaperDelegate->GetMaximumValue()) || (value < mTaperDelegate->GetMinimumValue()))
        return false;   
    return true;
}
 
template <typename T>
bool    AAX_CParameter<T>::GetStringFromNormalizedValue(double normalizedValue, int32_t iMaxNumChars, AAX_CString&  valueString) const
{
    T value = mTaperDelegate->NormalizedToReal(normalizedValue);
    if (!mDisplayDelegate->ValueToString(value, iMaxNumChars, &valueString))
        return false;   
    
    //If the parameter is out of range, we should probably return false, even though we clamped the normalizedValue already just to be safe.
    if ((value > mTaperDelegate->GetMaximumValue()) || (value < mTaperDelegate->GetMinimumValue()))
        return false;   
    return true;
}
 
template<typename T>
bool    AAX_CParameter<T>::SetValueFromString(const AAX_CString&    newValueString)
{   
    T newValue;
    if (!mDisplayDelegate->StringToValue(newValueString, &newValue))
        return false;
    SetValue(newValue);
    return true;
}
 
template<typename T>
void    AAX_CParameter<T>::SetTaperDelegate(AAX_ITaperDelegateBase& inTaperDelegate,bool inPreserveValue)
{
    double  normalizeValue = this->GetNormalizedValue ();
 
    AAX_ITaperDelegate<T>* oldDelegate = mTaperDelegate;
    mTaperDelegate = ((AAX_ITaperDelegate<T> &) inTaperDelegate).Clone();
    delete oldDelegate;
 
    mNeedNotify = true;
    if ( inPreserveValue )
        this->SetValue ( mValue.Get() );
    else this->UpdateNormalizedValue ( normalizeValue );
}
 
template<typename T>
void    AAX_CParameter<T>::SetDisplayDelegate(AAX_IDisplayDelegateBase& inDisplayDelegate)
{
    AAX_IDisplayDelegate<T>* oldDelegate = mDisplayDelegate;
    mDisplayDelegate = ((AAX_IDisplayDelegate<T> &)inDisplayDelegate).Clone();
    delete oldDelegate;
    
    if (mAutomationDelegate != 0)
        mAutomationDelegate->PostCurrentValue(this->Identifier(), this->GetNormalizedValue());      //<DMT> Make sure GUIs are all notified of the change.
}
 
template<typename T>
const AAX_ITaperDelegate<T>*    AAX_CParameter<T>::TaperDelegate() const
{
    return mTaperDelegate;
}
 
template<typename T>
const AAX_IDisplayDelegate<T>*  AAX_CParameter<T>::DisplayDelegate() const
{
    return mDisplayDelegate;
}
 
template<typename T>
bool    AAX_CParameter<T>::Automatable() const          
{   
    return mAutomatable;
}
 
template<typename T>
void    AAX_CParameter<T>::SetAutomationDelegate ( AAX_IAutomationDelegate * iAutomationDelegate )
{
    //Remove the old automation delegate
    if ( mAutomationDelegate )
    {
        mAutomationDelegate->UnregisterParameter ( this->Identifier() );
    }
    
    //Add the new automation delegate, wrapped by the versioning layer.
    mAutomationDelegate = iAutomationDelegate;
    if ( mAutomationDelegate )
        mAutomationDelegate->RegisterParameter ( this->Identifier() );
}
 
template<typename T>
void    AAX_CParameter<T>::Touch()                      
{   
    //<DT>  Always send the touch command, even if the control isn't automatable.
    if (mAutomationDelegate)
        mAutomationDelegate->PostTouchRequest( this->Identifier() );
}               
 
template<typename T>
void    AAX_CParameter<T>::Release()                    
{   
    //<DT>  Always send the release command, even if the control isn't automatable.
    if (mAutomationDelegate)
        mAutomationDelegate->PostReleaseRequest( this->Identifier() );
}
 
 
#if 0
#pragma mark -
#pragma mark AAX_CStatelessParameter
#endif
 
class AAX_CStatelessParameter : public AAX_IParameter
{
public:
    AAX_CStatelessParameter(AAX_CParamID identifier, const AAX_IString& name, const AAX_IString& inValueString)
    : mNames(name)
    , mID(identifier)
    , mAutomationDelegate(NULL)
    , mValueString(inValueString)
    {
    }
    
    AAX_CStatelessParameter(const AAX_IString& identifier, const AAX_IString& name, const AAX_IString& inValueString)
    : mNames(name)
    , mID(identifier)
    , mAutomationDelegate(NULL)
    , mValueString(inValueString)
    {
    }
    
    AAX_DEFAULT_DTOR_OVERRIDE(AAX_CStatelessParameter);
    
    AAX_IParameterValue*    CloneValue() const AAX_OVERRIDE { return NULL; }
    
    AAX_CParamID        Identifier() const AAX_OVERRIDE { return mID.CString(); }
    void                SetName(const AAX_CString& name) AAX_OVERRIDE
    {
        mNames.SetPrimary(name);
        if (mAutomationDelegate) {
            mAutomationDelegate->ParameterNameChanged(this->Identifier());
        }
    }
    const AAX_CString&  Name() const AAX_OVERRIDE { return mNames.Primary(); }
    void                AddShortenedName(const AAX_CString& name) AAX_OVERRIDE { mNames.Add(name); }
    const AAX_CString&  ShortenedName(int32_t iNumCharacters) const AAX_OVERRIDE { return mNames.Get(iNumCharacters); }
    void                ClearShortenedNames() AAX_OVERRIDE { mNames.Clear(); }
    
    bool        Automatable() const AAX_OVERRIDE { return false; }
    void        SetAutomationDelegate( AAX_IAutomationDelegate * iAutomationDelegate ) AAX_OVERRIDE
    {
        //Remove the old automation delegate
        if ( mAutomationDelegate )
        {
            mAutomationDelegate->UnregisterParameter ( this->Identifier() );
        }
        
        //Add the new automation delegate, wrapped by the versioning layer.
        mAutomationDelegate = iAutomationDelegate;
        if ( mAutomationDelegate )
            mAutomationDelegate->RegisterParameter ( this->Identifier() );
    }
    void        Touch() AAX_OVERRIDE { if (mAutomationDelegate) mAutomationDelegate->PostTouchRequest( this->Identifier() ); }
    void        Release() AAX_OVERRIDE { if (mAutomationDelegate) mAutomationDelegate->PostReleaseRequest( this->Identifier() ); }
    
    void        SetNormalizedValue(double /*newNormalizedValue*/) AAX_OVERRIDE {}
    double      GetNormalizedValue() const AAX_OVERRIDE { return 0.; }
    void        SetNormalizedDefaultValue(double /*normalizedDefault*/) AAX_OVERRIDE {}
    double      GetNormalizedDefaultValue() const AAX_OVERRIDE { return 0.; }
    void        SetToDefaultValue() AAX_OVERRIDE {}
    void        SetNumberOfSteps(uint32_t /*numSteps*/) AAX_OVERRIDE {}
    uint32_t    GetNumberOfSteps() const AAX_OVERRIDE { return 1; }
    uint32_t    GetStepValue() const AAX_OVERRIDE { return 0; }
    double      GetNormalizedValueFromStep(uint32_t /*iStep*/) const AAX_OVERRIDE { return 0.; }
    uint32_t    GetStepValueFromNormalizedValue(double /*normalizedValue*/) const AAX_OVERRIDE { return 0; }
    void        SetStepValue(uint32_t /*iStep*/) AAX_OVERRIDE {}
    
    bool        GetValueString(AAX_CString* valueString) const AAX_OVERRIDE { if (valueString) *valueString = mValueString; return true; }
    bool        GetValueString(int32_t /*iMaxNumChars*/, AAX_CString* valueString) const AAX_OVERRIDE { return this->GetValueString(valueString); }
    bool        GetNormalizedValueFromBool(bool /*value*/, double* normalizedValue) const AAX_OVERRIDE { if (normalizedValue) { *normalizedValue = 0.; } return true; }
    bool        GetNormalizedValueFromInt32(int32_t /*value*/, double* normalizedValue) const AAX_OVERRIDE { if (normalizedValue) { *normalizedValue = 0.; } return true; }
    bool        GetNormalizedValueFromFloat(float /*value*/, double* normalizedValue) const AAX_OVERRIDE { if (normalizedValue) { *normalizedValue = 0.; } return true; }
    bool        GetNormalizedValueFromDouble(double /*value*/, double* normalizedValue) const AAX_OVERRIDE { if (normalizedValue) { *normalizedValue = 0.; } return true; }
    bool        GetNormalizedValueFromString(const AAX_CString& /*valueString*/, double* normalizedValue) const AAX_OVERRIDE { if (normalizedValue) { *normalizedValue = 0.; } return true; }
    bool        GetBoolFromNormalizedValue(double /*normalizedValue*/, bool* value) const AAX_OVERRIDE { if (value) { *value = false; } return true; }
    bool        GetInt32FromNormalizedValue(double /*normalizedValue*/, int32_t* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetFloatFromNormalizedValue(double /*normalizedValue*/, float* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetDoubleFromNormalizedValue(double /*normalizedValue*/, double* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetStringFromNormalizedValue(double /*normalizedValue*/, AAX_CString& valueString) const AAX_OVERRIDE { valueString = mValueString; return true; }
    bool        GetStringFromNormalizedValue(double normalizedValue, int32_t /*iMaxNumChars*/, AAX_CString& valueString) const AAX_OVERRIDE { return this->GetStringFromNormalizedValue(normalizedValue, valueString); }
    bool        SetValueFromString(const AAX_CString&   newValueString) AAX_OVERRIDE { mValueString = newValueString; return true; }
    
    bool        GetValueAsBool(bool* value) const AAX_OVERRIDE { if (value) { *value = false; } return true; }
    bool        GetValueAsInt32(int32_t* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetValueAsFloat(float* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetValueAsDouble(double* /*value*/) const AAX_OVERRIDE { return false; }
    bool        GetValueAsString(AAX_IString* /*value*/) const AAX_OVERRIDE { return false; }
    bool        SetValueWithBool(bool /*value*/) AAX_OVERRIDE { return true; }
    bool        SetValueWithInt32(int32_t /*value*/) AAX_OVERRIDE { return false; }
    bool        SetValueWithFloat(float /*value*/) AAX_OVERRIDE { return false; }
    bool        SetValueWithDouble(double /*value*/) AAX_OVERRIDE { return false; }
    bool        SetValueWithString(const AAX_IString& value) AAX_OVERRIDE { mValueString = value; return true; }
    
    void        SetType( AAX_EParameterType /*iControlType*/ ) AAX_OVERRIDE {};
    AAX_EParameterType  GetType() const AAX_OVERRIDE { return AAX_eParameterType_Discrete; }
    
    void        SetOrientation( AAX_EParameterOrientation /*iOrientation*/ ) AAX_OVERRIDE {}
    AAX_EParameterOrientation   GetOrientation() const AAX_OVERRIDE { return AAX_eParameterOrientation_Default; }
    
    void SetTaperDelegate ( AAX_ITaperDelegateBase & /*inTaperDelegate*/, bool /*inPreserveValue*/ ) AAX_OVERRIDE {};
    void SetDisplayDelegate ( AAX_IDisplayDelegateBase & /*inDisplayDelegate*/ ) AAX_OVERRIDE {};
    
    void        UpdateNormalizedValue(double /*newNormalizedValue*/) AAX_OVERRIDE {};
    
protected:
    AAX_CStringAbbreviations mNames;
    AAX_CString mID;
    AAX_IAutomationDelegate * mAutomationDelegate;
    AAX_CString mValueString;
};
 
 
 
 
#endif //AAX_CParameter_H