AAX SDK 2.8.0
Avid Audio Extensions Development Kit
Loading...
Searching...
No Matches
AAX_Properties.h
Go to the documentation of this file.
1/*================================================================================================*/
2/*
3 *
4 * Copyright 2013-2017, 2019-2021, 2023-2024 Avid Technology, Inc.
5 * All rights reserved.
6 *
7 * This file is part of the Avid AAX SDK.
8 *
9 * The AAX SDK is subject to commercial or open-source licensing.
10 *
11 * By using the AAX SDK, you agree to the terms of both the Avid AAX SDK License
12 * Agreement and Avid Privacy Policy.
13 *
14 * AAX SDK License: https://developer.avid.com/aax
15 * Privacy Policy: https://www.avid.com/legal/privacy-policy-statement
16 *
17 * Or: You may also use this code under the terms of the GPL v3 (see
18 * www.gnu.org/licenses).
19 *
20 * THE AAX SDK IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
21 * EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
22 * DISCLAIMED.
23 *
24 */
25
32/*================================================================================================*/
33
34
36#pragma once
37#ifndef AAX_PROPERTIES_H
38#define AAX_PROPERTIES_H
40
41#ifndef _AAX_H_
42#include "AAX.h"
43#endif
44
45
46// Add new values only at the end of existing sections!
47
76// Current CCS doesn't support C++11
77#ifdef _TMS320C6X
79#else
80enum AAX_EProperty : int32_t
81#endif
82{
84 AAX_eProperty_MinProp = 10, // MUST BE EQUAL TO MINIMUM PROPERTY VALUE
85
86//---------------------------------------------------------------------
87#if 0
88#pragma mark Plug-In spec properties
89#endif
266
267//---------------------------------------------------------------------
268#if 0
269#pragma mark ProcessProc properties
270#endif
327
328//---------------------------------------------------------------------
329#if 0
330#pragma mark General properties
331#endif
408
409//---------------------------------------------------------------------
410#if 0
411#pragma mark TI-specific properties
412#endif
451
452//---------------------------------------------------------------------
453#if 0
454#pragma mark General properties (continued)
455#endif
476
477//---------------------------------------------------------------------
478#if 0
479#pragma mark AAX Hybrid properties
480#endif
508
509//---------------------------------------------------------------------
510#if 0
511#pragma mark Offline (AudioSuite) properties
512#endif
656
657 AAX_eProperty_MaxASProp, // Intentionally given no explicit value
659
660//---------------------------------------------------------------------
661#if 0
662#pragma mark GUI properties
663#endif
683
684 AAX_eProperty_MaxGUIProp, // Intentionally given no explicit value
686
687//---------------------------------------------------------------------
688#if 0
689#pragma mark Meter properties
690#endif
715
716 AAX_eProperty_MaxMeterProp, // Intentionally given no explicit value
718
719//---------------------------------------------------------------------
720#if 0
721#pragma mark Plug-in management constraints
722#endif
775
776 AAX_eProperty_MaxConstraintProp, // Intentionally given no explicit value
778
779//---------------------------------------------------------------------
780#if 0
781#pragma mark Plug-in features
782#endif
789 AAX_eProperty_FeaturesBase = 305, // No room was given, so this equals AAX_eProperty_SupportsSaveRestore
850
851 AAX_eProperty_MaxFeaturesProp, // Intentionally given no explicit value
853
854//---------------------------------------------------------------------
855#if 0
856#pragma mark Plug-in management constraints (continued)
857#endif
864
881
904
905 AAX_eProperty_MaxConstraintProp_2, // Intentionally given no explicit value
907
908//---------------------------------------------------------------------
909#if 0
910#pragma mark Debug properties
911#endif
925
926 AAX_eProperty_MaxProp, // ALWAYS LEAVE AS LAST PROPERTY VALUE
927 AAX_eProperty_MaxCap = 10000 // Maximum possible property value over the lifetime of AAX
929
931#endif // AAX_PROPERTIES_H
#define AAX_ENUM_SIZE_CHECK(x)
Macro to ensure enum type consistency across binaries.
Definition: AAX_Enums.h:54
Various utility definitions for AAX.
AAX_EProperty
The list of properties that can be added to an AAX_IPropertyMap.
Definition: AAX_Properties.h:82
@ AAX_eProperty_NumberOfInputs
The number of input channels that the plug-in supports.
Definition: AAX_Properties.h:618
@ AAX_eProperty_PlugInID_RTAS
Definition: AAX_Properties.h:143
@ AAX_eProperty_RequiresChunkCallsOnMainThread
Indicates whether the plug-in supports SetChunk and GetChunk calls on threads other than the main thr...
Definition: AAX_Properties.h:832
@ AAX_eProperty_DisableAudioSuiteReverse
The plug-in supports audiosuite reverse. By default, all reverb and delay plug-ins support this featu...
Definition: AAX_Properties.h:655
@ AAX_eProperty_GUIBase
Definition: AAX_Properties.h:669
@ AAX_eProperty_DSP_AudioBufferLength
Audio buffer length for DSP processing callbacks. One of AAX_EAudioBufferLengthDSP.
Definition: AAX_Properties.h:358
@ AAX_eProperty_FeaturesBase
Definition: AAX_Properties.h:789
@ AAX_eProperty_NativeInstanceInitProc
Definition: AAX_Properties.h:290
@ AAX_eProperty_ConstraintBase
Definition: AAX_Properties.h:731
@ AAX_eProperty_StoreXMLPageTablesByEffect
This property specifies whether the plug-in bundle contains an XML file per plug-in type.
Definition: AAX_Properties.h:817
@ AAX_eProperty_TIProcessProc
Definition: AAX_Properties.h:311
@ AAX_eProperty_MaxCap
Definition: AAX_Properties.h:927
@ AAX_eProperty_OutputStemFormat
Output stem format. One of AAX_EStemFormat.
Definition: AAX_Properties.h:351
@ AAX_eProperty_Deprecated_Plugin_List
Definition: AAX_Properties.h:209
@ AAX_eProperty_PlugInID_ExternalProcessor
Four-character osid-style plug-in type identifier for audio effects rendered on external hardware.
Definition: AAX_Properties.h:254
@ AAX_eProperty_Meter_Orientation
Indicates meter orientation as one of AAX_EMeterOrientation.
Definition: AAX_Properties.h:709
@ AAX_eProperty_TI_ForceAllowChipSharing
Allow different plug-in types to share the same DSP even if AAX_eProperty_TI_MaxInstancesPerChip is d...
Definition: AAX_Properties.h:449
@ AAX_eProperty_SupportsSideChainInput
Tells the host that the plug-in supports side chain inputs.
Definition: AAX_Properties.h:639
@ AAX_eProperty_AudioBufferLength
Definition: AAX_Properties.h:361
@ AAX_eProperty_GeneralPropsBase
Definition: AAX_Properties.h:337
@ AAX_eProperty_NeedsOutputDithered
Requests that the host apply dithering to the Effect's output.
Definition: AAX_Properties.h:647
@ AAX_eProperty_ProductID
Four-character osid-style Effect identifier.
Definition: AAX_Properties.h:121
@ AAX_eProperty_TI_SharedCycleCount
Shared cycle count (outer, per clump, loop overhead)
Definition: AAX_Properties.h:422
@ AAX_eProperty_Deprecated_Native_Plugin_List
Specify a list of Native plug-ins that are deprecated by a new plug-in type.
Definition: AAX_Properties.h:237
@ AAX_eProperty_ShowInMenus
Indicates whether or not the plug-in should be shown in insert menus.
Definition: AAX_Properties.h:474
@ AAX_eProperty_MaxConstraintProp_2
Definition: AAX_Properties.h:905
@ AAX_eProperty_NativeProcessProc
Definition: AAX_Properties.h:283
@ AAX_eProperty_Constraint_AlwaysProcess
Indicates that the plug-in's processing should never be disabled by the host (true/false)
Definition: AAX_Properties.h:880
@ AAX_eProperty_OptionalAnalysis
The Effect supports an analysis pass, but does not require it.
Definition: AAX_Properties.h:546
@ AAX_eProperty_TI_MaxInstancesPerChip
Maximum number of instances of this plug-in that can be loaded on a chip. This property is only used ...
Definition: AAX_Properties.h:435
@ AAX_eProperty_Constraint_Topology
Constraint on the topology of the Effect's modules, as one of AAX_EConstraintTopology.
Definition: AAX_Properties.h:742
@ AAX_eProperty_TI_InstanceCycleCount
Instance cycle count (inner, per instance, loop overhead)
Definition: AAX_Properties.h:428
@ AAX_eProperty_MaxMeterProp
Definition: AAX_Properties.h:716
@ AAX_eProperty_CanBypass
The plug-in supports a Master Bypass control.
Definition: AAX_Properties.h:397
@ AAX_eProperty_PlugInID_NoProcessing
Four-character osid-style plug-in type identifier for Effect types that do not process audio.
Definition: AAX_Properties.h:195
@ AAX_eProperty_SupportsSaveRestore
Indicates whether or not the plug-in supports Save/Restore features. (true/false)
Definition: AAX_Properties.h:798
@ AAX_eProperty_Meter_Type
Indicates meter type as one of AAX_EMeterType.
Definition: AAX_Properties.h:704
@ AAX_eProperty_Constraint_NeverUnload
Tells the host that it should never unload the plug-in binary.
Definition: AAX_Properties.h:749
@ AAX_eProperty_PlugInID_TI
Four-character osid-style plug-in type identifier for real-time TI-accelerated audio Effect types.
Definition: AAX_Properties.h:178
@ AAX_eProperty_MaxFeaturesProp
Definition: AAX_Properties.h:851
@ AAX_eProperty_Constraint_NeverCache
Tells the host that it should never cache the plug-in binary. Only use this if required as there is a...
Definition: AAX_Properties.h:763
@ AAX_eProperty_Constraint_Location
Constraint on the algorithm's location, as a mask of AAX_EConstraintLocationMask.
Definition: AAX_Properties.h:736
@ AAX_eProperty_Constraint_DoNotApplyDefaultSettings
Requests that the host does not send default settings chunks to the plug-in after instantiation (true...
Definition: AAX_Properties.h:903
@ AAX_eProperty_Constraint_MultiMonoSupport
Indicates whether or not the plug-in supports multi-mono configurations (true/false)
Definition: AAX_Properties.h:774
@ AAX_eProperty_DisablePreview
The Effect does not support preview.
Definition: AAX_Properties.h:600
@ AAX_eProperty_PlugInID_Native
Four-character osid-style plug-in type identifier for real-time native audio Effects.
Definition: AAX_Properties.h:140
@ AAX_eProperty_MaxConstraintProp
Definition: AAX_Properties.h:776
@ AAX_eProperty_RequiresAnalysis
The Effect requires an analysis pass.
Definition: AAX_Properties.h:535
@ AAX_eProperty_DisableHandles
Prevents the application of rendered region handles by the host.
Definition: AAX_Properties.h:633
@ AAX_eProperty_AlwaysBypass
The plug-in never alters its audio signal, audio output is always equal to audio input.
Definition: AAX_Properties.h:468
@ AAX_eProperty_ContinuousOnly
The Effect only processes on continuous data and does not support 'clip by clip' rendering.
Definition: AAX_Properties.h:582
@ AAX_eProperty_AllowPreviewWithoutAnalysis
The Effect requires analysis, but is also allowed to preview.
Definition: AAX_Properties.h:554
@ AAX_eProperty_ConstraintBase_2
Definition: AAX_Properties.h:863
@ AAX_eProperty_ManufacturerID
Four-character osid-style manufacturer identifier.
Definition: AAX_Properties.h:108
@ AAX_eProperty_ProcessProcPropsBase
Definition: AAX_Properties.h:276
@ AAX_eProperty_EnableHostDebugLogs
Enables host debug logging for this plug-in.
Definition: AAX_Properties.h:923
@ AAX_eProperty_Related_DSP_Plugin_List
Specify a list of DSP plug-ins that are related to a plug-in type.
Definition: AAX_Properties.h:218
@ AAX_eProperty_MultiInputModeOnly
The Effect wants multi-input mode only (no mono mode option)
Definition: AAX_Properties.h:592
@ AAX_eProperty_MeterBase
Definition: AAX_Properties.h:699
@ AAX_eProperty_TIDLLFileName
Definition: AAX_Properties.h:304
@ AAX_eProperty_RequestsAllTrackData
The host should make all of the processed track's data available to the Effect.
Definition: AAX_Properties.h:573
@ AAX_eProperty_Meter_Ballistics
Indicates meter ballistics preference as one of AAX_EMeterBallisticType.
Definition: AAX_Properties.h:714
@ AAX_eProperty_LatencyContribution
Default latency contribution of a given processing callback, in samples.
Definition: AAX_Properties.h:378
@ AAX_eProperty_DebugPropertiesBase
Definition: AAX_Properties.h:915
@ AAX_eProperty_UsesTransportControl
Indicates whether or not the plug-in uses transport control requests. (true/false)
Definition: AAX_Properties.h:849
@ AAX_eProperty_DoesntIncrOutputSample
The Effect may not increment its output sample during some rendering calls.
Definition: AAX_Properties.h:609
@ AAX_eProperty_UsesRandomAccess
The Effect requires random access to audio data.
Definition: AAX_Properties.h:527
@ AAX_eProperty_Deprecated_DSP_Plugin_List
Specify a list of DSP plug-ins that are deprecated by a new plug-in type.
Definition: AAX_Properties.h:231
@ AAX_eProperty_NumberOfOutputs
The number of output channels that the plug-in supports.
Definition: AAX_Properties.h:627
@ AAX_eProperty_MaxASProp
Definition: AAX_Properties.h:657
@ AAX_eProperty_SampleRate
Specifies which sample rates the Effect supports. A mask of AAX_ESampleRateMask.
Definition: AAX_Properties.h:385
@ AAX_eProperty_MaxGUIProp
Definition: AAX_Properties.h:684
@ AAX_eProperty_TIInstanceInitProc
Definition: AAX_Properties.h:318
@ AAX_eProperty_PlugInID_AudioSuite
Four-character osid-style plug-in type identifier for offline native audio Effects.
Definition: AAX_Properties.h:158
@ AAX_eProperty_MinProp
Definition: AAX_Properties.h:84
@ AAX_eProperty_MaxProp
Definition: AAX_Properties.h:926
@ AAX_eProperty_PlugInID_Deprecated
Four-character osid-style plug-in type identifier for a corresponding deprecated type.
Definition: AAX_Properties.h:205
@ AAX_eProperty_PlugInSpecPropsBase
Definition: AAX_Properties.h:95
@ AAX_eProperty_DestinationTrack
Informs the host application to reassign output to a different track.
Definition: AAX_Properties.h:564
@ AAX_eProperty_InputStemFormat
Input stem format. One of AAX_EStemFormat.
Definition: AAX_Properties.h:344
@ AAX_eProperty_Related_Native_Plugin_List
Specify a list of Native plug-ins that are related to a plug-in type.
Definition: AAX_Properties.h:225
@ AAX_eProperty_ExternalProcessorTypeID
Identifier for the type of the external processor hardware.
Definition: AAX_Properties.h:264
@ AAX_eProperty_StoreXMLPageTablesByType
Definition: AAX_Properties.h:820
@ AAX_eProperty_SideChainStemFormat
Side chain stem format. One of AAX_EStemFormat.
Definition: AAX_Properties.h:406
@ AAX_eProperty_AudiosuitePropsBase
Definition: AAX_Properties.h:518
@ AAX_eProperty_NoID
Definition: AAX_Properties.h:83
@ AAX_eProperty_NativeBackgroundProc
Definition: AAX_Properties.h:297
@ AAX_eProperty_UsesTransport
Indicates whether or not the plug-in uses transport requests. (true/false)
Definition: AAX_Properties.h:805
@ AAX_eProperty_UsesClientGUI
Requests a host-generated GUI based on the Effect's parameters.
Definition: AAX_Properties.h:682
@ AAX_eProperty_TIBackgroundProc
Definition: AAX_Properties.h:325
@ AAX_eProperty_ObservesTransportState
Indicates whether the plug-in subscribes to the TransportStateChanged notification to receive transpo...
Definition: AAX_Properties.h:842
@ AAX_eProperty_HybridInputStemFormat
Hybrid Input stem format. One of AAX_EStemFormat.
Definition: AAX_Properties.h:506
@ AAX_eProperty_HybridOutputStemFormat
Hybrid Output stem format. One of AAX_EStemFormat.
Definition: AAX_Properties.h:495