AAX_IACFEffectParameters.h

Go to the documentation of this file.

/*================================================================================================*/
/*
 *
 *  Copyright 2013 by Avid Technology, Inc.
 *  All rights reserved.
 *  
 *  CONFIDENTIAL: This document contains confidential information.  Do not 
 *  read or examine this document unless you are an Avid Technology employee
 *  or have signed a non-disclosure agreement with Avid Technology which protects
 *  the confidentiality of this document.  DO NOT DISCLOSE ANY INFORMATION 
 *  CONTAINED IN THIS DOCUMENT TO ANY THIRD-PARTY WITHOUT THE PRIOR WRITTEN CONSENT 
 *  OF Avid Technolgy, INC.
 *
 */

/*================================================================================================*/
 

#ifndef AAX_IACFEFFECTPARAMETERS_H
#define AAX_IACFEFFECTPARAMETERS_H

#include "AAX.h"
#include "AAX_IAutomationDelegate.h"
#include "AAX_IString.h"
#include "AAX_IParameter.h"
#include "AAX_IController.h"

#ifdef __clang__
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wnon-virtual-dtor"
#endif

#include "acfunknown.h"

class AAX_IACFEffectParameters : public IACFUnknown
{
public:
    
    virtual AAX_Result          Initialize(IACFUnknown * iController) = 0;  
    virtual AAX_Result          Uninitialize () = 0;
    

    virtual AAX_Result          NotificationReceived( /* AAX_ENotificationEvent */ AAX_CTypeID iNotificationType, const void * iNotificationData, uint32_t  iNotificationDataSize) = 0;
    
    
    virtual AAX_Result          GetNumberOfParameters ( int32_t * oNumControls )   const = 0;
    virtual AAX_Result          GetMasterBypassParameter ( AAX_IString * oIDString )   const = 0;
    virtual AAX_Result          GetParameterIsAutomatable ( AAX_CParamID iParameterID, AAX_CBoolean * oAutomatable )   const = 0;
    virtual AAX_Result          GetParameterNumberOfSteps ( AAX_CParamID iParameterID, int32_t * oNumSteps )   const = 0;
    virtual AAX_Result          GetParameterName ( AAX_CParamID iParameterID, AAX_IString * oName )   const = 0;
    virtual AAX_Result          GetParameterNameOfLength ( AAX_CParamID iParameterID, AAX_IString * oName, int32_t iNameLength )   const = 0;
    virtual AAX_Result          GetParameterDefaultNormalizedValue ( AAX_CParamID iParameterID, double * oValue )   const = 0;
    virtual AAX_Result          SetParameterDefaultNormalizedValue ( AAX_CParamID iParameterID, double iValue ) = 0;
    virtual AAX_Result          GetParameterType ( AAX_CParamID iParameterID, AAX_EParameterType * oParameterType )   const = 0;
    virtual AAX_Result          GetParameterOrientation ( AAX_CParamID iParameterID, AAX_EParameterOrientation * oParameterOrientation )   const = 0;
    virtual AAX_Result          GetParameter ( AAX_CParamID iParameterID, AAX_IParameter ** oParameter )  = 0;
    virtual AAX_Result          GetParameterIndex ( AAX_CParamID iParameterID, int32_t * oControlIndex )   const = 0;
    virtual AAX_Result          GetParameterIDFromIndex ( int32_t iControlIndex, AAX_IString * oParameterIDString )   const = 0;
    virtual AAX_Result          GetParameterValueInfo ( AAX_CParamID iParameterID, int32_t iSelector, int32_t* oValue) const = 0;
    
    
    
    virtual AAX_Result          GetParameterValueFromString ( AAX_CParamID iParameterID, double * oValue, const AAX_IString & iValueString )   const = 0;
    virtual AAX_Result          GetParameterStringFromValue ( AAX_CParamID iParameterID, double iValue, AAX_IString * oValueString, int32_t iMaxLength )   const = 0;
    virtual AAX_Result          GetParameterValueString ( AAX_CParamID iParameterID, AAX_IString* oValueString, int32_t iMaxLength  )   const = 0;
    virtual AAX_Result          GetParameterNormalizedValue ( AAX_CParamID iParameterID, double * oValuePtr )   const = 0;
    virtual AAX_Result          SetParameterNormalizedValue ( AAX_CParamID iParameterID, double iValue ) = 0;   
    virtual AAX_Result          SetParameterNormalizedRelative ( AAX_CParamID iParameterID, double iValue ) = 0;
    
    
    
    virtual AAX_Result          TouchParameter ( AAX_CParamID iParameterID ) = 0;
    virtual AAX_Result          ReleaseParameter ( AAX_CParamID iParameterID ) = 0;
    virtual AAX_Result          UpdateParameterTouch ( AAX_CParamID iParameterID, AAX_CBoolean iTouchState ) = 0;
    
    
    virtual AAX_Result          UpdateParameterNormalizedValue ( AAX_CParamID iParameterID, double iValue, AAX_EUpdateSource iSource ) = 0; 
    virtual AAX_Result          UpdateParameterNormalizedRelative ( AAX_CParamID iParameterID, double iValue ) = 0;
    virtual AAX_Result          GenerateCoefficients() = 0; 


    virtual AAX_Result          ResetFieldData (AAX_CFieldIndex iFieldIndex, void * oData, uint32_t iDataSize) const = 0;

    
    virtual AAX_Result          GetNumberOfChunks ( int32_t * oNumChunks )   const = 0;
    virtual AAX_Result          GetChunkIDFromIndex ( int32_t iIndex, AAX_CTypeID * oChunkID )   const = 0;
    virtual AAX_Result          GetChunkSize ( AAX_CTypeID iChunkID, uint32_t * oSize )   const = 0;
    virtual AAX_Result          GetChunk ( AAX_CTypeID iChunkID, AAX_SPlugInChunk * oChunk )   const = 0;
    virtual AAX_Result          SetChunk ( AAX_CTypeID iChunkID, const AAX_SPlugInChunk * iChunk ) = 0;
    virtual AAX_Result          CompareActiveChunk ( const AAX_SPlugInChunk * iChunkP, AAX_CBoolean * oIsEqual )   const = 0;
    virtual AAX_Result          GetNumberOfChanges ( int32_t * oNumChanges )   const = 0;   

    
    virtual AAX_Result          TimerWakeup( ) = 0;
    
    virtual AAX_Result          GetCurveData( /* AAX_ECurveType */ AAX_CTypeID iCurveType, const float * iValues, uint32_t iNumValues, float * oValues ) const = 0;
    
    virtual AAX_Result          GetCustomData( AAX_CTypeID iDataBlockID, uint32_t iDataSize, void* oData, uint32_t* oDataWritten) const = 0;
    
    virtual AAX_Result          SetCustomData( AAX_CTypeID iDataBlockID, uint32_t iDataSize, const void* iData ) = 0;

    virtual AAX_Result          DoMIDITransfers() = 0;
};

struct AAX_SHybridRenderInfo
{
    float**                     mAudioInputs;
    int32_t*                    mNumAudioInputs;
    float**                     mAudioOutputs;
    int32_t*                    mNumAudioOutputs;
    int32_t*                    mNumSamples;
    AAX_CTimestamp*             mClock;                 
};

class AAX_IACFEffectParameters_V2 : public AAX_IACFEffectParameters
{
public:
    
    virtual AAX_Result          RenderAudio_Hybrid(AAX_SHybridRenderInfo* ioRenderInfo) = 0;
    
    virtual AAX_Result          UpdateMIDINodes ( AAX_CFieldIndex iFieldIndex, AAX_CMidiPacket& iPacket ) = 0;

    virtual AAX_Result          UpdateControlMIDINodes ( AAX_CTypeID nodeID, AAX_CMidiPacket& iPacket ) = 0;
};

#ifdef __clang__
#pragma clang diagnostic pop
#endif

#endif // AAX_IACFEFFECTPARAMETERS_H