PIActions.h

Go to the documentation of this file.

// ADOBE SYSTEMS INCORPORATED
// (c) Copyright  1993 - 2015 Adobe Systems Incorporated
// All Rights Reserved
//
// NOTICE:  Adobe permits you to use, modify, and distribute this
// file in accordance with the terms of the Adobe license agreement
// accompanying it.  If you have received this file from a source
// other than Adobe, then your use, modification, or distribution
// of it requires the prior written permission of Adobe.
//-------------------------------------------------------------------
#ifndef __PIActions__ // Already defined?
#define __PIActions__

#if PRAGMA_ONCE
#pragma once
#endif

#ifndef MSWindows
#ifdef MSDOS
#define MSWindows MSDOS
#endif
#ifdef WIN32
#define MSWindows WIN32
#endif
#ifndef MSWindows
#define MSWindows 0
#endif
#endif

#ifndef INSIDE_PHOTOSHOP
#define INSIDE_PHOTOSHOP 0
#endif

#ifndef qiOS
#define qiOS 0
#endif

#ifdef Rez

#if !MSWindows && !qiOS
#include <CoreServices/CoreServices.r>
#endif

#else   // Rez

#if !MSWindows && !qiOS && !PS_OS_ANDROID
#include <CoreServices/CoreServices.h>
#endif

#if PS_OS_ANDROID
#include <MacTypes.h>
#endif // PS_OS_ANDROID

#include "PITypes.h"
#include "SPTypes.h"
#include "SPPlugs.h"

#endif // Rez

#define  typeBookmark                  'bkmk'   /// eventual replacement for typeAlias
#define  typeXPlatFileSpec             'xpfs'   /// eventual replacement for typeFSRef

//-------------------------------------------------------------------------------
//  Flags for dictionary parameters.
//-------------------------------------------------------------------------------




#define flagsSingleParameter                    \
    required,           singleItem,     notEnumerated,  reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsListParameter                      \
    required,           listOfItems,    notEnumerated,  reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsEnumeratedParameter                \
    required,           singleItem,     enumerated,     reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsEnumeratedListParameter            \
    required,           listOfItems,    enumerated,     reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsOptionalSingleParameter            \
    optional,           singleItem,     notEnumerated,  reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsOptionalListParameter              \
    optional,           listOfItems,    notEnumerated,  reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsOptionalEnumeratedParameter        \
    optional,           singleItem,     enumerated,     reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

#define flagsOptionalEnumeratedListParameter    \
    optional,           listOfItems,    enumerated,     reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    prepositionParam,   notFeminine,    notMasculine,   singular

// Flags for object properties:

#define flagsSingleProperty                     \
    reserved,           singleItem,     notEnumerated,  readWrite,  \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    noApostrophe,       notFeminine,    notMasculine,   singular

#define flagsListProperty                       \
    reserved,           listOfItems,    notEnumerated,  readWrite,  \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    noApostrophe,       notFeminine,    notMasculine,   singular

#define flagsEnumeratedProperty                 \
    reserved,           singleItem,     enumerated,     readWrite,  \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    noApostrophe,       notFeminine,    notMasculine,   singular

#define flagsEnumeratedListProperty             \
    reserved,           listOfItems,    enumerated,     readWrite,  \
    reserved,           reserved,       reserved,       reserved,   \
    reserved,           reserved,       reserved,       reserved,   \
    noApostrophe,       notFeminine,    notMasculine,   singular

// Flags for direct dictionary parameters:


#define flagsOptionalEnumeratedChangesDirect    \
    directParamOptional,    singleItem, enumerated, changesState,   \
    reserved,               reserved,   reserved,   reserved,       \
    reserved,               reserved,   reserved,   reserved,       \
    reserved,               reserved,   reserved,   reserved

#define flagsEnumeratedChangesDirect    \
    directParamRequired,    singleItem, enumerated, changesState,   \
    reserved,               reserved,   reserved,   reserved,       \
    reserved,               reserved,   reserved,   reserved,       \
    reserved,               reserved,   reserved,   reserved

#define flagsEnumeratedDirect   \
    directParamRequired,    singleItem, enumerated, doesntChangeState,  \
    reserved,               reserved,   reserved,   reserved,           \
    reserved,               reserved,   reserved,   reserved,           \
    reserved,               reserved,   reserved,   reserved

#define flagsChangesDirect  \
    directParamRequired,    singleItem, notEnumerated,  changesState,   \
    reserved,               reserved,   reserved,       reserved,       \
    reserved,               reserved,   reserved,       reserved,       \
    reserved,               reserved,   reserved,       reserved

#define flagsListChangesDirect  \
    directParamRequired,    listOfItems,    notEnumerated,  changesState,   \
    reserved,               reserved,       reserved,       reserved,       \
    reserved,               reserved,       reserved,       reserved,       \
    reserved,               reserved,       reserved,       reserved

//-------------------------------------------------------------------------------
//  Handy short cuts.
//-------------------------------------------------------------------------------


#define NO_REPLY        \
    noReply,            \
    "",                 \
    replyRequired,  singleItem, notEnumerated,  notTightBindingFunction,    \
    reserved,       reserved,   reserved,       reserved,                   \
    reserved,       reserved,   reserved,       reserved,                   \
    verbEvent,      reserved,   reserved,       reserved

#define IMAGE_DIRECT_PARAMETER  \
    typeImageReference,         \
    "",                         \
    flagsOptionalEnumeratedChangesDirect

    // end defgroup
//-------------------------------------------------------------------------------

// NOTE: 1/21/98 (Ace) I'm going to leave these conditional defines in this
// file to keep PITerminology devoid of conditionals:

/* Normalize the AppleScript terminology */

#if MSWindows   // These items come from AppleScript

#define CFDataRef void*

#ifndef AE_DESC_ENUMS
#define AE_DESC_ENUMS


#define  typeBoolean                   'bool'
#define  typeChar                      'TEXT'
#define  typeText                      'TEXT'


/* Preferred numeric Apple event descriptor types */
#define  typeSInt16                    'shor'
#define  typeSInt32                    'long'
#define  typeUInt32                    'magn'
#define  typeSInt64                    'comp'
#define  typeIEEE32BitFloatingPoint    'sing'
#define  typeIEEE64BitFloatingPoint    'doub'
#define  type128BitFloatingPoint       'ldbl'
#define  typeDecimalStruct             'decm'

/* Non-preferred Apple event descriptor types */
#define  typeSMInt                     typeSInt16
#define  typeShortInteger              typeSInt16
#ifndef typeInteger
#define  typeInteger                   typeSInt32
#else
#if (typeInteger != 'long')
    this_is_integer_trouble
#endif
#endif
#define  typeLongInteger               typeSInt32
#define  typeMagnitude                 typeUInt32
#define  typeComp                      typeSInt64
#define  typeSMFloat                   typeIEEE32BitFloatingPoint
#define  typeShortFloat                typeIEEE32BitFloatingPoint
#ifndef typeFloat
#define  typeFloat                     typeIEEE64BitFloatingPoint
#else
#if (typeFloat != 'doub')
    this_is_float_trouble
#endif
#endif
#define  typeLongFloat                 typeIEEE64BitFloatingPoint
#define  typeExtended                  'exte'

/* More Apple event descriptor types */
#define  typeAEList                    'list'
#define  typeAERecord                  'reco'
#define  typeAppleEvent                'aevt'
#define  typeEventRecord               'evrc'
#define  typeTrue                      'true'
#define  typeFalse                     'fals'
#define  typeAlias                     'alis'   /// \deprecated Please use typeBookmark instead
#define  typeEnumerated                'enum'
#define  typeType                      'type'
#define  typeAppParameters             'appa'
#define  typeProperty                  'prop'
#define  typeFSS                       'fss '
#define  typeFSRef                     'fsrf'   /// \deprecated Please use typeXPlatFileSpec
#define  typeKeyword                   'keyw'
#define  typeSectionH                  'sect'
#define  typeWildCard                  '****'
#define  typeApplSignature             'sign'
#define  typeQDRectangle               'qdrt'
#define  typeFixed                     'fixd'
#define  typeProcessSerialNumber       'psn '
#define  typeApplicationURL            'aprl'
#define  typeNull                      'null'

#endif // AE_DESC_ENUMS

#define roman                   0        
#define english                 0        
#define japanese                11       
#ifndef noReply
#define noReply                 'null'
#endif

#ifndef __APPLEEVENTS__

#define typeObjectSpecifier     'obj '   
#endif /* __APPLEEVENTS __ */

#if !INSIDE_PHOTOSHOP

// The plug-ins need this stuff, but don't use the Universal Headers, so
// we must provide it for them.

#define formName                'name'

#ifndef __AEOBJECTS__
#define formAbsolutePosition    'indx'
#define formPropertyID          'prop'
#define formRelativePosition    'rele'
#endif /* __AEOBJECTS__ */

#endif  // !INSIDE_PHOTOSHOP

#endif /* MSWindows */

#if INSIDE_PHOTOSHOP || !defined(keySelection)
#define keySelection            'fsel'  
#endif

#define typePath                'Pth '  
#if MSWindows
#define typePlatformFilePath    typePath
#else
#define typePlatformFilePath    typeAlias
#endif


//-------------------------------------------------------------------------------

#ifndef Rez

//-------------------------------------------------------------------------------




#define PIHasTerminologyProperty    0x6873746DL /* 'hstm' <PITerminology> Has <aete, 0> resource:
                                                        version number
                                                        classID:        Object or event class
                                                        eventID:        For events (typeNull otherwise)
                                                        terminologyID:  'aete' resource ID (ignored if PITerminologyProperty)
                                                        scopeString:    Unique string present if
                                                                        AppleScript not supported
                                                */

#define PITerminologyProperty       0x74726D6EL /* 'trmn' <aete> Used internally as terminology cache.
                                                    If present it is used instead of an aete resource.
                                                */




typedef int32 PIDialogRecordOptions;

enum
    {
    plugInDialogOptional,       
    plugInDialogRequired,       
    plugInDialogNone            
    };

typedef int32 PIDialogPlayOptions;

enum
    {
    plugInDialogDontDisplay,    
    plugInDialogDisplay,        
    plugInDialogSilent          
    };
//-------------------------------------------------------------------------------
//  Flags returned by GetKey. Low order word corresponds to AppleEvent flags.
//-------------------------------------------------------------------------------




#define actionSimpleParameter       0x00000000L
#define actionEnumeratedParameter   0x00002000L
#define actionListParameter         0x00004000L
#define actionOptionalParameter     0x00008000L

#define actionObjectParameter       0x80000000L
#define actionScopedParameter       0x40000000L
#define actionStringIDParameter     0x20000000L


//-------------------------------------------------------------------------------

typedef Handle PIDescriptorHandle;    
typedef struct PIOpaqueWriteDescriptor* PIWriteDescriptor;  
typedef struct PIOpaqueReadDescriptor*  PIReadDescriptor;   
typedef uint32  DescriptorEventID;   
typedef uint32  DescriptorClassID;   
typedef uint32  DescriptorKeyID;    
typedef uint32  DescriptorTypeID;   
typedef uint32  DescriptorUnitID;   
typedef uint32  DescriptorEnumID;   
typedef uint32  DescriptorEnumTypeID; 
typedef uint32  DescriptorFormID;   
typedef DescriptorKeyID DescriptorKeyIDArray[]; 
#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

#if MSWindows
#pragma pack(push,1)
#endif

typedef struct PITerminology
    {
    int32   version;           
    OSType  classID;           
    OSType  eventID;           
    int16   terminologyID;     
    char    scopeString[1];    
    } PITerminology;

#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif

#if MSWindows
#pragma pack(pop)
#endif

#define PITerminologyMinSize 15

#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

typedef struct PIDescriptorSimpleReference
    {
    DescriptorTypeID    desiredClass;  
    DescriptorKeyID     keyForm;       
    struct _keyData
        {
        Str255              name;     
        int32               index;    
        DescriptorTypeID    type;     
        DescriptorEnumID    value;    
        }               keyData;
    } PIDescriptorSimpleReference;

#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif

//-------------------------------------------------------------------------------

#ifdef __cplusplus
extern "C"
    {
#endif

//-------------------------------------------------------------------------------


typedef MACPASCAL PIWriteDescriptor (*OpenWriteDescriptorProc)(void);

typedef MACPASCAL OSErr (*CloseWriteDescriptorProc)(PIWriteDescriptor, PIDescriptorHandle*);

typedef MACPASCAL OSErr (*PutIntegerProc)(PIWriteDescriptor, DescriptorKeyID, int32);

typedef MACPASCAL OSErr (*PutFloatProc)(PIWriteDescriptor, DescriptorKeyID, const real64*);

typedef MACPASCAL OSErr (*PutUnitFloatProc)(PIWriteDescriptor, DescriptorKeyID, DescriptorUnitID, const real64*);

typedef MACPASCAL OSErr (*PutBooleanProc)(PIWriteDescriptor, DescriptorKeyID, Boolean);

typedef MACPASCAL OSErr (*PutTextProc)(PIWriteDescriptor, DescriptorKeyID, Handle);

typedef MACPASCAL OSErr (*PutAliasProc)(PIWriteDescriptor, DescriptorKeyID, Handle);

typedef MACPASCAL OSErr (*PutEnumeratedProc)(PIWriteDescriptor, DescriptorKeyID key, DescriptorTypeID type, DescriptorEnumID value);

typedef MACPASCAL OSErr (*PutClassProc)(PIWriteDescriptor, DescriptorKeyID, DescriptorTypeID);

typedef MACPASCAL OSErr (*PutSimpleReferenceProc)(PIWriteDescriptor, DescriptorKeyID, const PIDescriptorSimpleReference*);

typedef MACPASCAL OSErr (*PutObjectProc)(PIWriteDescriptor, DescriptorKeyID, DescriptorTypeID, PIDescriptorHandle);

typedef MACPASCAL OSErr (*PutCountProc)(PIWriteDescriptor, DescriptorKeyID, uint32 count);

typedef MACPASCAL OSErr (*PutStringProc)(PIWriteDescriptor, DescriptorKeyID, ConstStr255Param);

// Scoped classes are not for use by plug-ins in Photoshop 4.0:
typedef MACPASCAL OSErr (*PutScopedClassProc)(PIWriteDescriptor, DescriptorKeyID, DescriptorTypeID);
typedef MACPASCAL OSErr (*PutScopedObjectProc)(PIWriteDescriptor, DescriptorKeyID, DescriptorTypeID, PIDescriptorHandle);

//-------------------------------------------------------------------------------


typedef MACPASCAL PIReadDescriptor (*OpenReadDescriptorProc)(PIDescriptorHandle, DescriptorKeyIDArray);

typedef MACPASCAL OSErr (*CloseReadDescriptorProc)(PIReadDescriptor);

typedef MACPASCAL Boolean (*GetKeyProc)(PIReadDescriptor, DescriptorKeyID* key, DescriptorTypeID* type, int32* flags);

typedef MACPASCAL OSErr (*GetIntegerProc)(PIReadDescriptor, int32*);

typedef MACPASCAL OSErr (*GetFloatProc)(PIReadDescriptor, real64*);

typedef MACPASCAL OSErr (*GetUnitFloatProc)(PIReadDescriptor, DescriptorUnitID*, real64*);

typedef MACPASCAL OSErr (*GetBooleanProc)(PIReadDescriptor, Boolean*);

typedef MACPASCAL OSErr (*GetTextProc)(PIReadDescriptor, Handle*);

typedef MACPASCAL OSErr (*GetAliasProc)(PIReadDescriptor, Handle*);

typedef MACPASCAL OSErr (*GetEnumeratedProc)(PIReadDescriptor, DescriptorEnumID*);

typedef MACPASCAL OSErr (*GetClassProc)(PIReadDescriptor, DescriptorTypeID*);

typedef MACPASCAL OSErr (*GetSimpleReferenceProc)(PIReadDescriptor, PIDescriptorSimpleReference*);

typedef MACPASCAL OSErr (*GetObjectProc)(PIReadDescriptor, DescriptorTypeID*, PIDescriptorHandle*);

typedef MACPASCAL OSErr (*GetCountProc)(PIReadDescriptor, uint32*);

typedef MACPASCAL OSErr (*GetStringProc)(PIReadDescriptor, Str255*);

typedef MACPASCAL OSErr (*GetPinnedIntegerProc)(PIReadDescriptor, int32 min, int32 max, int32*);

typedef MACPASCAL OSErr (*GetPinnedFloatProc)(PIReadDescriptor, const real64* min, const real64* max, real64*);

typedef MACPASCAL OSErr (*GetPinnedUnitFloatProc)(PIReadDescriptor, const real64* min, const real64* max, DescriptorUnitID*, real64*);
//-------------------------------------------------------------------------------

#ifdef __cplusplus
    }
#endif

//-------------------------------------------------------------------------------
//  WriteDescriptorProcs structure.
//-------------------------------------------------------------------------------

// Version:
#define kCurrentWriteDescriptorProcsVersion 0

#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

typedef struct WriteDescriptorProcs
    {
    int16 writeDescriptorProcsVersion;    
    int16 numWriteDescriptorProcs;        
    OpenWriteDescriptorProc     openWriteDescriptorProc;  
    CloseWriteDescriptorProc    closeWriteDescriptorProc; 
    PutIntegerProc              putIntegerProc;    
    PutFloatProc                putFloatProc;      
    PutUnitFloatProc            putUnitFloatProc;  
    PutBooleanProc              putBooleanProc;    
    PutTextProc                 putTextProc;       
    PutAliasProc                putAliasProc;      
    PutEnumeratedProc           putEnumeratedProc;  
    PutClassProc                putClassProc;       
    PutSimpleReferenceProc      putSimpleReferenceProc;  
    PutObjectProc               putObjectProc;      
    PutCountProc                putCountProc;       
    PutStringProc               putStringProc;      
    PutScopedClassProc          putScopedClassProc;  
    PutScopedObjectProc         putScopedObjectProc; 
    } WriteDescriptorProcs;

#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif

// Count:
#define kCurrentWriteDescriptorProcsCount \
    ((sizeof(WriteDescriptorProcs) - offsetof(WriteDescriptorProcs, openWriteDescriptorProc)) / sizeof(void*))

//-------------------------------------------------------------------------------
//  ReadDescriptorProcs structure.
//-------------------------------------------------------------------------------

// Version:
#define kCurrentReadDescriptorProcsVersion 0

#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

typedef struct ReadDescriptorProcs
    {
    int16 readDescriptorProcsVersion;    
    int16 numReadDescriptorProcs;        
    OpenReadDescriptorProc      openReadDescriptorProc;    
    CloseReadDescriptorProc     closeReadDescriptorProc;   
    GetKeyProc                  getKeyProc;         
    GetIntegerProc              getIntegerProc;     
    GetFloatProc                getFloatProc;       
    GetUnitFloatProc            getUnitFloatProc;   
    GetBooleanProc              getBooleanProc;     
    GetTextProc                 getTextProc;        
    GetAliasProc                getAliasProc;       
    GetEnumeratedProc           getEnumeratedProc;  
    GetClassProc                getClassProc;       
    GetSimpleReferenceProc      getSimpleReferenceProc;  
    GetObjectProc               getObjectProc;      
    GetCountProc                getCountProc;       
    GetStringProc               getStringProc;      
    GetPinnedIntegerProc        getPinnedIntegerProc;   
    GetPinnedFloatProc          getPinnedFloatProc;     
    GetPinnedUnitFloatProc      getPinnedUnitFloatProc; 
    } ReadDescriptorProcs;

#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif

// Count:
#define kCurrentReadDescriptorProcsCount \
    ((sizeof(ReadDescriptorProcs) - offsetof(ReadDescriptorProcs, openReadDescriptorProc)) / sizeof(void*))

//-------------------------------------------------------------------------------
//  PIDescriptorParameters structure.
//-------------------------------------------------------------------------------

// Version of the Descriptor Parameters structure.
#define kCurrentDescriptorParametersVersion 0

#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

typedef struct PIDescriptorParameters
    {
    int16                   descriptorParametersVersion;  
    int16                   playInfo;                     
    int16                   recordInfo;                   
    PIDescriptorHandle      descriptor;                   
    WriteDescriptorProcs*   writeDescriptorProcs;         
    ReadDescriptorProcs*    readDescriptorProcs;          
    } PIDescriptorParameters;

#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif
 // end ingroup DescriptorSuite

//-------------------------------------------------------------------------------
//  Window notify suite.
//-------------------------------------------------------------------------------

#if !MSWindows


#define kPSWindowNotifySuite    "482963f4-3ea1-11d1-8da3-00c04fd5f7ee"

#define kPSWindowNotifySuiteVersion 1

#ifdef __cplusplus
extern "C"
    {
#endif

    struct EventRecord;

    typedef void (*PIWindowNotifier)(const struct EventRecord* event, void* data);

#ifdef __cplusplus
    }
#endif

typedef struct PSWindowNotifyProcs
    {
    SPAPI OSErr (*AddNotify)(void* window, PIWindowNotifier notifier, void* data);

    SPAPI OSErr (*RemoveNotify)(void* window);

} PSWindowNotifyProcs;

#endif

//-------------------------------------------------------------------------------

typedef struct _ADsc*   PIActionDescriptor;

typedef struct _ALst*   PIActionList;

typedef struct _ARef*   PIActionReference;

// other define for this is in ASZStringSuite.h;  placed here for SuspendHistory
#ifndef ASZString_defined
#define ASZString_defined
struct ASZByteRun;
typedef struct ASZByteRun *ASZString;
#endif

//-------------------------------------------------------------------------------
//  ActionControl suite.  Available only in Automation plug-ins.
//-------------------------------------------------------------------------------


#define kPSActionControlSuite           "bc1e4d70-f953-11d0-8d9f-00c04fd5f7ee"

#define kPSActionControlSuiteVersion        6   // Current version
#define kPSActionControlSuiteVersion5       5   // CC 2015 release, Version 16.0
#define kPSActionControlSuiteVersion4       4   // CC 2015 release, Version 16.0
#define kPSActionControlSuiteVersion3       3   // CS5 release, Version 12.0
#define kPSActionControlSuiteVersion2       2   // Original suite

#ifdef __cplusplus
extern "C"
    {
#endif

    typedef void (*PIEventNotifier)(DescriptorEventID eventID, PIActionDescriptor descriptor, PIDialogRecordOptions options, void* data);

    typedef void (*PICommandNotifier)(uint32 commandID, OSErr result, DescriptorEventID eventID, PIActionDescriptor descriptor, PIDialogRecordOptions options, void* data);

    typedef SPErr (*PISuspendProc)(void *data);

#ifdef __cplusplus
    }
#endif

typedef struct PSActionControlProcs
    {

    SPAPI OSErr (*Play)(PIActionDescriptor* result, DescriptorEventID event, PIActionDescriptor descriptor, PIDialogPlayOptions options);

    SPAPI OSErr (*Get)(PIActionDescriptor* result, PIActionReference reference);

    SPAPI OSErr (*StringIDToTypeID)(const char* stringID, DescriptorTypeID* typeID);

    SPAPI OSErr (*TypeIDToStringID)(DescriptorTypeID typeID, char* stringID, uint32 stringLength);

    SPAPI OSErr (*AddNotify)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data);

    SPAPI OSErr (*RemoveNotify)(SPPluginRef ref, DescriptorEventID event);

    SPAPI OSErr (*SuspendHistory)(PIActionReference reference, PISuspendProc proc, void* procData, ASZString operationName);

    SPAPI OSErr (*MakeStringAlias)(const char*  newStringID, const char* existingStringID);

    SPAPI OSErr (*AddNotifyLevel1)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data);

    SPAPI OSErr (*PostCommand)(SPPluginRef ref, DescriptorEventID event, PIActionDescriptor descriptor, PIDialogPlayOptions options, PICommandNotifier notifier, void* data, uint32* commandID);

    SPAPI OSErr (*CancelCommand)(SPPluginRef ref, uint32 commandID);

    SPAPI OSErr (*ConvertAliasHandleToBookmark)(Handle aliasHandle, CFDataRef* bookmark);

    SPAPI OSErr (*ConvertBookmarkToAliasHandle)(CFDataRef bookmark, Handle* aliasHandle);

    SPAPI OSErr (*AddUniversalNotifier)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data, uint32 options);

    SPAPI OSErr (*RemoveUniversalNotifier)(SPPluginRef ref, DescriptorEventID event);

    } PSActionControlProcs;
/* @} */

typedef struct PSActionControlProcs4
{
    SPAPI OSErr (*Play)(PIActionDescriptor* result, DescriptorEventID event, PIActionDescriptor descriptor, PIDialogPlayOptions options);
    SPAPI OSErr (*Get)(PIActionDescriptor* result, PIActionReference reference);
    SPAPI OSErr (*StringIDToTypeID)(const char* stringID, DescriptorTypeID* typeID);
    SPAPI OSErr (*TypeIDToStringID)(DescriptorTypeID typeID, char* stringID, uint32 stringLength);
    SPAPI OSErr (*AddNotify)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data);
    SPAPI OSErr (*RemoveNotify)(SPPluginRef ref, DescriptorEventID event);
    SPAPI OSErr (*SuspendHistory)(PIActionReference reference, PISuspendProc proc, void* procData, ASZString operationName);
    SPAPI OSErr (*MakeStringAlias)(const char*  newStringID, const char* existingStringID);
    SPAPI OSErr (*AddNotifyLevel1)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data);
} PSActionControlProcs4;
/* @} */

typedef struct PSActionControlProcsOld
{
    SPAPI OSErr (*Play)(PIActionDescriptor* result, DescriptorEventID event, PIActionDescriptor descriptor, PIDialogPlayOptions options);
    SPAPI OSErr (*Get)(PIActionDescriptor* result, PIActionReference reference);
    SPAPI OSErr (*StringIDToTypeID)(const char* stringID, DescriptorTypeID* typeID);
    SPAPI OSErr (*TypeIDToStringID)(DescriptorTypeID typeID, char* stringID, uint32 stringLength);
    SPAPI OSErr (*AddNotify)(SPPluginRef ref, DescriptorEventID event, PIEventNotifier notifier, void* data);
    SPAPI OSErr (*RemoveNotify)(SPPluginRef ref, DescriptorEventID event);
    SPAPI OSErr (*SuspendHistory)(PIActionReference reference, PISuspendProc proc, void* procData, ASZString operationName);
    SPAPI OSErr (*MakeStringAlias)(const char*  newStringID, const char* existingStringID);
} PSActionControlProcsOld;
/* @} */

//-------------------------------------------------------------------------------
//  Basic Action control suite.  Available to non-Automation plug-ins.
//-------------------------------------------------------------------------------


#define kPSBasicActionControlSuite          "3eb7c480-8797-11d1-8da7-00c04fd5f7ee"

#define kPSBasicActionControlSuiteVersion       3

#define kPSBasicActionControlSuiteVersion2      2

#define kPSBasicActionControlSuitePrevVersion   1

typedef struct PSBasicActionControlProcs
    {

    SPAPI OSErr (*Get)(PIActionDescriptor* result, PIActionReference reference);

    SPAPI OSErr (*StringIDToTypeID)(const char* stringID,   DescriptorTypeID* typeID);

    SPAPI OSErr (*TypeIDToStringID)(DescriptorTypeID typeID, char* stringID, uint32 stringLength);

    SPAPI OSErr (*MakeStringAlias)(const char* newStringID, const char* existingStringID);

    SPAPI OSErr (*ConvertAliasHandleToBookmark)(Handle aliasHandle, CFDataRef* bookmark);

    SPAPI OSErr (*ConvertBookmarkToAliasHandle)(CFDataRef bookmark, Handle* aliasHandle);

    } PSBasicActionControlProcs;

typedef struct PSBasicActionControlProcsOld
{
    SPAPI OSErr (*Get)(PIActionDescriptor* result, PIActionReference reference);
    SPAPI OSErr (*StringIDToTypeID)(const char* stringID,   DescriptorTypeID* typeID);
    SPAPI OSErr (*TypeIDToStringID)(DescriptorTypeID typeID, char* stringID, uint32 stringLength);
    SPAPI OSErr (*MakeStringAlias)(const char* newStringID, const char* existingStringID);
} PSBasicActionControlProcsOld;

//-------------------------------------------------------------------------------
//  DescriptorRegistry suite.  Use to pass descriptors between plug-ins or
//  save parameters between invocations.
//-------------------------------------------------------------------------------


#define kPSDescriptorRegistrySuite          "61e608b0-40fd-11d1-8da3-00c04fd5f7ee"

#define kPSDescriptorRegistrySuiteVersion   1

typedef struct PSDescriptorRegistryProcs
    {

    SPAPI OSErr (*Register)(const char* key, PIActionDescriptor descriptor, Boolean isPersistent);

    SPAPI OSErr (*Erase)(const char* key);

    SPAPI OSErr (*Get)(const char* key, PIActionDescriptor* descriptor);

    } PSDescriptorRegistryProcs;

/* @} */

//-------------------------------------------------------------------------------
//  ActionDescriptor suite.  Use for putting keys and objects into descriptors,
//  getting them out of descriptors, and other descriptor management.
//-------------------------------------------------------------------------------

#define kPSActionDescriptorSuite            "df135115-c769-11d0-8079-00c04fd7ec47"

#define kPSActionDescriptorSuiteVersion     5

// #define kPSActionDescriptorSuiteVersion4 4
#define kPSActionDescriptorSuiteVersion3    3

#define kPSActionDescriptorSuiteVersion2    2

typedef struct PSActionDescriptorProcs
    {
    SPAPI OSErr (*Make)(PIActionDescriptor* descriptor);

    SPAPI OSErr (*Free)(PIActionDescriptor descriptor);

    SPAPI OSErr (*GetType)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorTypeID* type);

    SPAPI OSErr (*GetKey)(PIActionDescriptor descriptor, uint32 index, DescriptorKeyID* key);

    SPAPI OSErr (*HasKey)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* hasKey);

    SPAPI OSErr (*GetCount)(PIActionDescriptor descriptor, uint32* count);

    SPAPI OSErr (*IsEqual)(PIActionDescriptor descriptor, PIActionDescriptor other, Boolean* isEqual);

    SPAPI OSErr (*Erase)(PIActionDescriptor descriptor, DescriptorKeyID );

    SPAPI OSErr (*Clear)(PIActionDescriptor descriptor);

    SPAPI OSErr (*PutInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 value);

    SPAPI OSErr (*PutFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64 value);

    SPAPI OSErr (*PutUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID unit, real64 value);

    SPAPI OSErr (*PutString)(PIActionDescriptor descriptor, DescriptorKeyID key,  const char* cstrValue);

    SPAPI OSErr (*PutBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean value);

    SPAPI OSErr (*PutList)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionList value);

    SPAPI OSErr (*PutObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);

    SPAPI OSErr (*PutGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);

    SPAPI OSErr (*PutEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID type, DescriptorEnumID value);

    SPAPI OSErr (*PutReference)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionReference value);

    SPAPI OSErr (*PutClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);

    SPAPI OSErr (*PutGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);

    SPAPI OSErr (*PutAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle value);

    SPAPI OSErr (*GetInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);

    SPAPI OSErr (*GetFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64* value);

    SPAPI OSErr (*GetUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID* unit, real64* value);

    SPAPI OSErr (*GetStringLength)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32* stringLength);

    SPAPI OSErr (*GetString)(PIActionDescriptor descriptor, DescriptorKeyID key, char* cstrValue, uint32 maxLength);

    SPAPI OSErr (*GetBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* value);

    SPAPI OSErr (*GetList)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionList* value);

    SPAPI OSErr (*GetObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);

    SPAPI OSErr (*GetGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);

    SPAPI OSErr (*GetEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID* type, DescriptorEnumID* value);

    SPAPI OSErr (*GetReference)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionReference* value);

    SPAPI OSErr (*GetClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);

    SPAPI OSErr (*GetGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);

    SPAPI OSErr (*GetAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle* value);

    SPAPI OSErr (*HasKeys)(PIActionDescriptor descriptor, DescriptorKeyIDArray requiredKeys, Boolean* hasKeys);

    SPAPI OSErr (*PutIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count,  int32* );

    SPAPI OSErr (*GetIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count, int32* value);

    SPAPI OSErr (*AsHandle)(PIActionDescriptor descriptor, PIDescriptorHandle* value);

    SPAPI OSErr (*HandleToDescriptor)(PIDescriptorHandle value, PIActionDescriptor* descriptor);

    SPAPI OSErr (*PutZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString zstring);

    SPAPI OSErr (*GetZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString* zstring);

    SPAPI OSErr (*PutData)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 length, void* value);

    SPAPI OSErr (*GetDataLength)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);

    SPAPI OSErr (*GetData)(PIActionDescriptor descriptor, DescriptorKeyID key, void* value);

    SPAPI OSErr (*PutInteger64)(PIActionDescriptor descriptor, DescriptorKeyID key, int64 value);

    SPAPI OSErr (*GetInteger64)(PIActionDescriptor descriptor, DescriptorKeyID key, int64* value);

    SPAPI OSErr (*MakeWithClass)(DescriptorClassID value, PIActionDescriptor* descriptor);

    SPAPI OSErr (*GetDescriptorClass)(PIActionDescriptor descriptor, DescriptorClassID* value);

    SPAPI OSErr (*Copy)(PIActionDescriptor descriptor, PIActionDescriptor* copy);

    SPAPI OSErr (*PutBookmark)(PIActionDescriptor descriptor, DescriptorKeyID key, CFDataRef value);

    SPAPI OSErr (*GetBookmark)(PIActionDescriptor descriptor, DescriptorKeyID key, CFDataRef* value);

    } PSActionDescriptorProcs;
/* @} */

typedef struct PSActionDescriptorProcs3
{
    SPAPI OSErr (*Make)(PIActionDescriptor* descriptor);
    SPAPI OSErr (*Free)(PIActionDescriptor descriptor);
    SPAPI OSErr (*GetType)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorTypeID* type);
    SPAPI OSErr (*GetKey)(PIActionDescriptor descriptor, uint32 index, DescriptorKeyID* key);
    SPAPI OSErr (*HasKey)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* hasKey);
    SPAPI OSErr (*GetCount)(PIActionDescriptor descriptor, uint32* count);
    SPAPI OSErr (*IsEqual)(PIActionDescriptor descriptor, PIActionDescriptor other, Boolean* isEqual);
    SPAPI OSErr (*Erase)(PIActionDescriptor descriptor, DescriptorKeyID );
    SPAPI OSErr (*Clear)(PIActionDescriptor descriptor);
    SPAPI OSErr (*PutInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 value);
    SPAPI OSErr (*PutFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64 value);
    SPAPI OSErr (*PutUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID unit, real64 value);
    SPAPI OSErr (*PutString)(PIActionDescriptor descriptor, DescriptorKeyID key,  const char* cstrValue);
    SPAPI OSErr (*PutBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean value);
    SPAPI OSErr (*PutList)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionList value);
    SPAPI OSErr (*PutObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);
    SPAPI OSErr (*PutGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);
    SPAPI OSErr (*PutEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID type, DescriptorEnumID value);
    SPAPI OSErr (*PutReference)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionReference value);
    SPAPI OSErr (*PutClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);
    SPAPI OSErr (*PutGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);
    SPAPI OSErr (*PutAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle value);
    SPAPI OSErr (*GetInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);
    SPAPI OSErr (*GetFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64* value);
    SPAPI OSErr (*GetUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID* unit, real64* value);
    SPAPI OSErr (*GetStringLength)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32* stringLength);
    SPAPI OSErr (*GetString)(PIActionDescriptor descriptor, DescriptorKeyID key, char* cstrValue, uint32 maxLength);
    SPAPI OSErr (*GetBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* value);
    SPAPI OSErr (*GetList)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionList* value);
    SPAPI OSErr (*GetObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID* type, DescriptorEnumID* value);
    SPAPI OSErr (*GetReference)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionReference* value);
    SPAPI OSErr (*GetClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);
    SPAPI OSErr (*GetGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);
    SPAPI OSErr (*GetAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle* value);
    SPAPI OSErr (*HasKeys)(PIActionDescriptor descriptor, DescriptorKeyIDArray requiredKeys, Boolean* hasKeys);
    SPAPI OSErr (*PutIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count,  int32* );
    SPAPI OSErr (*GetIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count, int32* value);
    SPAPI OSErr (*AsHandle)(PIActionDescriptor descriptor, PIDescriptorHandle* value);
    SPAPI OSErr (*HandleToDescriptor)(PIDescriptorHandle value, PIActionDescriptor* descriptor);
    SPAPI OSErr (*PutZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString zstring);
    SPAPI OSErr (*GetZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString* zstring);
    SPAPI OSErr (*PutData)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 length, void* value);
    SPAPI OSErr (*GetDataLength)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);
    SPAPI OSErr (*GetData)(PIActionDescriptor descriptor, DescriptorKeyID key, void* value);
    SPAPI OSErr (*PutInteger64)(PIActionDescriptor descriptor, DescriptorKeyID key, int64 value);
    SPAPI OSErr (*GetInteger64)(PIActionDescriptor descriptor, DescriptorKeyID key, int64* value);
} PSActionDescriptorProcs3;
/* @} */

typedef struct PSActionDescriptorProcs2
{
    SPAPI OSErr (*Make)(PIActionDescriptor* descriptor);
    SPAPI OSErr (*Free)(PIActionDescriptor descriptor);
    SPAPI OSErr (*GetType)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorTypeID* type);
    SPAPI OSErr (*GetKey)(PIActionDescriptor descriptor, uint32 index, DescriptorKeyID* key);
    SPAPI OSErr (*HasKey)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* hasKey);
    SPAPI OSErr (*GetCount)(PIActionDescriptor descriptor, uint32* count);
    SPAPI OSErr (*IsEqual)(PIActionDescriptor descriptor, PIActionDescriptor other, Boolean* isEqual);
    SPAPI OSErr (*Erase)(PIActionDescriptor descriptor, DescriptorKeyID );
    SPAPI OSErr (*Clear)(PIActionDescriptor descriptor);
    SPAPI OSErr (*PutInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 value);
    SPAPI OSErr (*PutFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64 value);
    SPAPI OSErr (*PutUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID unit, real64 value);
    SPAPI OSErr (*PutString)(PIActionDescriptor descriptor, DescriptorKeyID key,  const char* cstrValue);
    SPAPI OSErr (*PutBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean value);
    SPAPI OSErr (*PutList)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionList value);
    SPAPI OSErr (*PutObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);
    SPAPI OSErr (*PutGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID type,  PIActionDescriptor value);
    SPAPI OSErr (*PutEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID type, DescriptorEnumID value);
    SPAPI OSErr (*PutReference)(PIActionDescriptor descriptor, DescriptorKeyID key,  PIActionReference value);
    SPAPI OSErr (*PutClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);
    SPAPI OSErr (*PutGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID value);
    SPAPI OSErr (*PutAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle value);
    SPAPI OSErr (*GetInteger)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);
    SPAPI OSErr (*GetFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, real64* value);
    SPAPI OSErr (*GetUnitFloat)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorUnitID* unit, real64* value);
    SPAPI OSErr (*GetStringLength)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32* stringLength);
    SPAPI OSErr (*GetString)(PIActionDescriptor descriptor, DescriptorKeyID key, char* cstrValue, uint32 maxLength);
    SPAPI OSErr (*GetBoolean)(PIActionDescriptor descriptor, DescriptorKeyID key, Boolean* value);
    SPAPI OSErr (*GetList)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionList* value);
    SPAPI OSErr (*GetObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetGlobalObject)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetEnumerated)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorEnumTypeID* type, DescriptorEnumID* value);
    SPAPI OSErr (*GetReference)(PIActionDescriptor descriptor, DescriptorKeyID key, PIActionReference* value);
    SPAPI OSErr (*GetClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);
    SPAPI OSErr (*GetGlobalClass)(PIActionDescriptor descriptor, DescriptorKeyID key, DescriptorClassID* value);
    SPAPI OSErr (*GetAlias)(PIActionDescriptor descriptor, DescriptorKeyID key, Handle* value);
    SPAPI OSErr (*HasKeys)(PIActionDescriptor descriptor, DescriptorKeyIDArray requiredKeys, Boolean* hasKeys);
    SPAPI OSErr (*PutIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count,  int32* );
    SPAPI OSErr (*GetIntegers)(PIActionDescriptor descriptor, DescriptorKeyID key, uint32 count, int32* value);
    SPAPI OSErr (*AsHandle)(PIActionDescriptor descriptor, PIDescriptorHandle* value);
    SPAPI OSErr (*HandleToDescriptor)(PIDescriptorHandle value, PIActionDescriptor* descriptor);
    SPAPI OSErr (*PutZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString zstring);
    SPAPI OSErr (*GetZString)(PIActionDescriptor descriptor, DescriptorKeyID key, ASZString* zstring);
    SPAPI OSErr (*PutData)(PIActionDescriptor descriptor, DescriptorKeyID key, int32 length, void* value);
    SPAPI OSErr (*GetDataLength)(PIActionDescriptor descriptor, DescriptorKeyID key, int32* value);
    SPAPI OSErr (*GetData)(PIActionDescriptor descriptor, DescriptorKeyID key, void* value);
} PSActionDescriptorProcs2;
/* @} */

//-------------------------------------------------------------------------------
//  ActionList suite.  Use to manage lists of keys.
//-------------------------------------------------------------------------------

#define kPSActionListSuite          "df135116-c769-11d0-8079-00c04fd7ec47"

#define kPSActionListSuiteVersion       3

#define kPSActionListSuiteVersion2      2

#define kPSActionListSuiteVersion1      1

typedef struct PSActionListProcs
    {

    SPAPI OSErr (*Make)(PIActionList* actionList);

    SPAPI OSErr (*Free)(PIActionList actionList);

    SPAPI OSErr (*GetType)(PIActionList list, uint32 index, DescriptorTypeID* value);

    SPAPI OSErr (*GetCount)(PIActionList list, uint32* value);

    SPAPI OSErr (*PutInteger)(PIActionList list, int32 value);

    SPAPI OSErr (*PutFloat)(PIActionList list, real64 value);

    SPAPI OSErr (*PutUnitFloat)(PIActionList list, DescriptorUnitID unit, real64 value);

    SPAPI OSErr (*PutString)(PIActionList list, const char* cstr);

    SPAPI OSErr (*PutBoolean)(PIActionList list, Boolean value);

    SPAPI OSErr (*PutList)(PIActionList list, PIActionList value);

    SPAPI OSErr (*PutObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);

    SPAPI OSErr (*PutGlobalObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);

    SPAPI OSErr (*PutEnumerated)(PIActionList list, DescriptorEnumTypeID type, DescriptorEnumID value);

    SPAPI OSErr (*PutReference)(PIActionList list, PIActionReference value);

    SPAPI OSErr (*PutClass)(PIActionList list, DescriptorClassID value);

    SPAPI OSErr (*PutGlobalClass)(PIActionList list, DescriptorClassID value);

    SPAPI OSErr (*PutAlias)(PIActionList list, Handle value);

    SPAPI OSErr (*GetInteger)(PIActionList list, uint32 index, int32* value);

    SPAPI OSErr (*GetFloat)(PIActionList list, uint32 index, real64* value);

    SPAPI OSErr (*GetUnitFloat)(PIActionList list, uint32 index, DescriptorUnitID* unit, real64* value);

    SPAPI OSErr (*GetStringLength)(PIActionList list, uint32 index, uint32* stringLength);

    SPAPI OSErr (*GetString)(PIActionList list, uint32 index, char* cstr, uint32 maxLength);

    SPAPI OSErr (*GetBoolean)(PIActionList list, uint32 index, Boolean* value);

    SPAPI OSErr (*GetList)(PIActionList list, uint32 index, PIActionList* actionList);

    SPAPI OSErr (*GetObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);

    SPAPI OSErr (*GetGlobalObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);

    SPAPI OSErr (*GetEnumerated)(PIActionList list, uint32 index, DescriptorEnumTypeID* type, DescriptorEnumID* value);

    SPAPI OSErr (*GetReference)(PIActionList list, uint32 index, PIActionReference* value);

    SPAPI OSErr (*GetClass)(PIActionList list, uint32 index, DescriptorClassID* value);

    SPAPI OSErr (*GetGlobalClass)(PIActionList list, uint32 index, DescriptorClassID* value);

    SPAPI OSErr (*GetAlias)(PIActionList list, uint32 index, Handle* aliasHandle);

    SPAPI OSErr (*PutIntegers)(PIActionList list, uint32 count, int32* );

    SPAPI OSErr (*GetIntegers)(PIActionList list, uint32 count, int32* value);

    SPAPI OSErr (*PutData)(PIActionList list, int32 length, void* data);

    SPAPI OSErr (*GetDataLength)(PIActionList list, uint32 index, int32* length);

    SPAPI OSErr (*GetData)(PIActionList list, uint32 index, void* value);

    SPAPI OSErr (*PutZString)(PIActionList list, ASZString zstring);

    SPAPI OSErr (*GetZString)(PIActionList list, uint32 index, ASZString* zstring);

    SPAPI OSErr (*PutInteger64)(PIActionList list, int64 value);

    SPAPI OSErr (*GetInteger64)(PIActionList list, uint32 index, int64 *value);

    SPAPI OSErr (*PutBookmark)(PIActionList list, CFDataRef value);

    SPAPI OSErr (*GetBookmark)(PIActionList list, uint32 index, CFDataRef* bookmark);

    } PSActionListProcs;
/* @} */

typedef struct PSActionListProcs2
{
    SPAPI OSErr (*Make)(PIActionList* actionList);
    SPAPI OSErr (*Free)(PIActionList actionList);
    SPAPI OSErr (*GetType)(PIActionList list, uint32 index, DescriptorTypeID* value);
    SPAPI OSErr (*GetCount)(PIActionList list, uint32* value);
    SPAPI OSErr (*PutInteger)(PIActionList list, int32 value);
    SPAPI OSErr (*PutFloat)(PIActionList list, real64 value);
    SPAPI OSErr (*PutUnitFloat)(PIActionList list, DescriptorUnitID unit, real64 value);
    SPAPI OSErr (*PutString)(PIActionList list, const char* cstr);
    SPAPI OSErr (*PutBoolean)(PIActionList list, Boolean value);
    SPAPI OSErr (*PutList)(PIActionList list, PIActionList value);
    SPAPI OSErr (*PutObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);
    SPAPI OSErr (*PutGlobalObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);
    SPAPI OSErr (*PutEnumerated)(PIActionList list, DescriptorEnumTypeID type, DescriptorEnumID value);
    SPAPI OSErr (*PutReference)(PIActionList list, PIActionReference value);
    SPAPI OSErr (*PutClass)(PIActionList list, DescriptorClassID value);
    SPAPI OSErr (*PutGlobalClass)(PIActionList list, DescriptorClassID value);
    SPAPI OSErr (*PutAlias)(PIActionList list, Handle value);
    SPAPI OSErr (*GetInteger)(PIActionList list, uint32 index, int32* value);
    SPAPI OSErr (*GetFloat)(PIActionList list, uint32 index, real64* value);
    SPAPI OSErr (*GetUnitFloat)(PIActionList list, uint32 index, DescriptorUnitID* unit, real64* value);
    SPAPI OSErr (*GetStringLength)(PIActionList list, uint32 index, uint32* stringLength);
    SPAPI OSErr (*GetString)(PIActionList list, uint32 index, char* cstr, uint32 maxLength);
    SPAPI OSErr (*GetBoolean)(PIActionList list, uint32 index, Boolean* value);
    SPAPI OSErr (*GetList)(PIActionList list, uint32 index, PIActionList* actionList);
    SPAPI OSErr (*GetObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetGlobalObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetEnumerated)(PIActionList list, uint32 index, DescriptorEnumTypeID* type, DescriptorEnumID* value);
    SPAPI OSErr (*GetReference)(PIActionList list, uint32 index, PIActionReference* value);
    SPAPI OSErr (*GetClass)(PIActionList list, uint32 index, DescriptorClassID* value);
    SPAPI OSErr (*GetGlobalClass)(PIActionList list, uint32 index, DescriptorClassID* value);
    SPAPI OSErr (*GetAlias)(PIActionList list, uint32 index, Handle* aliasHandle);
    SPAPI OSErr (*PutIntegers)(PIActionList list, uint32 count, int32* );
    SPAPI OSErr (*GetIntegers)(PIActionList list, uint32 count, int32* value);
    SPAPI OSErr (*PutData)(PIActionList list, int32 length, void* data);
    SPAPI OSErr (*GetDataLength)(PIActionList list, uint32 index, int32* length);
    SPAPI OSErr (*GetData)(PIActionList list, uint32 index, void* value);
    SPAPI OSErr (*PutZString)(PIActionList list, ASZString zstring);
    SPAPI OSErr (*GetZString)(PIActionList list, uint32 index, ASZString* zstring);
    SPAPI OSErr (*PutInteger64)(PIActionList list, int64 value);
    SPAPI OSErr (*GetInteger64)(PIActionList list, uint32 index, int64 *value);
} PSActionListProcs2;
/* @} */

typedef struct PSActionListProcs1
{
    SPAPI OSErr (*Make)(PIActionList* actionList);
    SPAPI OSErr (*Free)(PIActionList actionList);
    SPAPI OSErr (*GetType)(PIActionList list, uint32 index, DescriptorTypeID* value);
    SPAPI OSErr (*GetCount)(PIActionList list, uint32* value);
    SPAPI OSErr (*PutInteger)(PIActionList list, int32 value);
    SPAPI OSErr (*PutFloat)(PIActionList list, real64 value);
    SPAPI OSErr (*PutUnitFloat)(PIActionList list, DescriptorUnitID unit, real64 value);
    SPAPI OSErr (*PutString)(PIActionList list, const char* cstr);
    SPAPI OSErr (*PutBoolean)(PIActionList list, Boolean value);
    SPAPI OSErr (*PutList)(PIActionList list, PIActionList value);
    SPAPI OSErr (*PutObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);
    SPAPI OSErr (*PutGlobalObject)(PIActionList list, DescriptorClassID type, PIActionDescriptor value);
    SPAPI OSErr (*PutEnumerated)(PIActionList list, DescriptorEnumTypeID type, DescriptorEnumID value);
    SPAPI OSErr (*PutReference)(PIActionList list, PIActionReference value);
    SPAPI OSErr (*PutClass)(PIActionList list, DescriptorClassID value);
    SPAPI OSErr (*PutGlobalClass)(PIActionList list, DescriptorClassID value);
    SPAPI OSErr (*PutAlias)(PIActionList list, Handle value);
    SPAPI OSErr (*GetInteger)(PIActionList list, uint32 index, int32* value);
    SPAPI OSErr (*GetFloat)(PIActionList list, uint32 index, real64* value);
    SPAPI OSErr (*GetUnitFloat)(PIActionList list, uint32 index, DescriptorUnitID* unit, real64* value);
    SPAPI OSErr (*GetStringLength)(PIActionList list, uint32 index, uint32* stringLength);
    SPAPI OSErr (*GetString)(PIActionList list, uint32 index, char* cstr, uint32 maxLength);
    SPAPI OSErr (*GetBoolean)(PIActionList list, uint32 index, Boolean* value);
    SPAPI OSErr (*GetList)(PIActionList list, uint32 index, PIActionList* actionList);
    SPAPI OSErr (*GetObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetGlobalObject)(PIActionList list, uint32 index, DescriptorClassID* type, PIActionDescriptor* value);
    SPAPI OSErr (*GetEnumerated)(PIActionList list, uint32 index, DescriptorEnumTypeID* type, DescriptorEnumID* value);
    SPAPI OSErr (*GetReference)(PIActionList list, uint32 index, PIActionReference* value);
    SPAPI OSErr (*GetClass)(PIActionList list, uint32 index, DescriptorClassID* value);
    SPAPI OSErr (*GetGlobalClass)(PIActionList list, uint32 index, DescriptorClassID* value);
    SPAPI OSErr (*GetAlias)(PIActionList list, uint32 index, Handle* aliasHandle);
    SPAPI OSErr (*PutIntegers)(PIActionList list, uint32 count, int32* );
    SPAPI OSErr (*GetIntegers)(PIActionList list, uint32 count, int32* value);
    SPAPI OSErr (*PutData)(PIActionList list, int32 length, void* data);
    SPAPI OSErr (*GetDataLength)(PIActionList list, uint32 index, int32* length);
    SPAPI OSErr (*GetData)(PIActionList list, uint32 index, void* value);
    SPAPI OSErr (*PutZString)(PIActionList list, ASZString zstring);
    SPAPI OSErr (*GetZString)(PIActionList list, uint32 index, ASZString* zstring);
} PSActionListProcs1;
/* @} */

//-------------------------------------------------------------------------------
//  ActionReference suite.  Use to build references to objects to be able to
//  get/set properties and target events.
//-------------------------------------------------------------------------------


#define kPSActionReferenceSuite         "df135117-c769-11d0-8079-00c04fd7ec47"

#define kPSActionReferenceSuiteVersion  3
#define kPSActionReferenceSuitePrevVersion  2

typedef struct PSActionReferenceProcs
    {

    SPAPI OSErr (*Make)(PIActionReference* reference);

    SPAPI OSErr (*Free)(PIActionReference ref);

    SPAPI OSErr (*GetForm)(PIActionReference ref, DescriptorFormID* value);

    SPAPI OSErr (*GetDesiredClass)(PIActionReference ref, DescriptorClassID* value);

    SPAPI OSErr (*PutName)(PIActionReference ref, DescriptorClassID desiredClass, const char* cstrValue);

    SPAPI OSErr (*PutIndex)(PIActionReference ref, DescriptorClassID desiredClass, uint32 value);

    SPAPI OSErr (*PutIdentifier)(PIActionReference ref, DescriptorClassID desiredClass, uint32 value);

    SPAPI OSErr (*PutOffset)(PIActionReference ref, DescriptorClassID desiredClass, int32 value);

    SPAPI OSErr (*PutEnumerated)(PIActionReference ref, DescriptorClassID desiredClass, DescriptorEnumTypeID type, DescriptorEnumID value);

    SPAPI OSErr (*PutProperty)(PIActionReference ref, DescriptorClassID desiredClass, DescriptorKeyID value);

    SPAPI OSErr (*PutClass)(PIActionReference ref, DescriptorClassID desiredClass);

    SPAPI OSErr (*GetNameLength)(PIActionReference ref, uint32* stringLength);

    SPAPI OSErr (*GetName)(PIActionReference ref, char* name, uint32 maxLength);

    SPAPI OSErr (*GetIndex)(PIActionReference ref, uint32* value);

    SPAPI OSErr (*GetIdentifier)(PIActionReference ref, uint32* value);

    SPAPI OSErr (*GetOffset)(PIActionReference ref, int32* value);

    SPAPI OSErr (*GetEnumerated)(PIActionReference ref, DescriptorEnumTypeID* type, DescriptorEnumID* enumValue);

    SPAPI OSErr (*GetProperty)(PIActionReference ref, DescriptorKeyID* value);

    SPAPI OSErr (*GetContainer)(PIActionReference ref, PIActionReference* value);

    SPAPI OSErr (*PutNameZString)(PIActionReference ref, DescriptorClassID desiredClass, ASZString zstring);

    SPAPI OSErr (*GetNameZString)(PIActionReference ref, ASZString* zstring);

    } PSActionReferenceProcs;
typedef struct PSActionReferenceProcsOld
{
    SPAPI OSErr (*Make)(PIActionReference* reference);
    SPAPI OSErr (*Free)(PIActionReference ref);
    SPAPI OSErr (*GetForm)(PIActionReference ref, DescriptorFormID* value);
    SPAPI OSErr (*GetDesiredClass)(PIActionReference ref, DescriptorClassID* value);
    SPAPI OSErr (*PutName)(PIActionReference ref, DescriptorClassID desiredClass, const char* cstrValue);
    SPAPI OSErr (*PutIndex)(PIActionReference ref, DescriptorClassID desiredClass, uint32 value);
    SPAPI OSErr (*PutIdentifier)(PIActionReference ref, DescriptorClassID desiredClass, uint32 value);
    SPAPI OSErr (*PutOffset)(PIActionReference ref, DescriptorClassID desiredClass, int32 value);
    SPAPI OSErr (*PutEnumerated)(PIActionReference ref, DescriptorClassID desiredClass, DescriptorEnumTypeID type, DescriptorEnumID value);
    SPAPI OSErr (*PutProperty)(PIActionReference ref, DescriptorClassID desiredClass, DescriptorKeyID value);
    SPAPI OSErr (*PutClass)(PIActionReference ref, DescriptorClassID desiredClass);
    SPAPI OSErr (*GetNameLength)(PIActionReference ref, uint32* stringLength);
    SPAPI OSErr (*GetName)(PIActionReference ref, char* name, uint32 maxLength);
    SPAPI OSErr (*GetIndex)(PIActionReference ref, uint32* value);
    SPAPI OSErr (*GetIdentifier)(PIActionReference ref, uint32* value);
    SPAPI OSErr (*GetOffset)(PIActionReference ref, int32* value);
    SPAPI OSErr (*GetEnumerated)(PIActionReference ref, DescriptorEnumTypeID* type, DescriptorEnumID* enumValue);
    SPAPI OSErr (*GetProperty)(PIActionReference ref, DescriptorKeyID* value);
    SPAPI OSErr (*GetContainer)(PIActionReference ref, PIActionReference* value);
} PSActionReferenceProcsOld;
//-------------------------------------------------------------------------------
//  PIActionParameters structure.
//-------------------------------------------------------------------------------
#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#endif

#if MSWindows
#pragma pack(push,1)
#endif

typedef struct PIActionParameters
    {

    PIDialogPlayOptions     playInfo;   
    PIDialogRecordOptions   recordInfo; 
    PIActionDescriptor      descriptor; 
    } PIActionParameters;


#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#endif

#if MSWindows
#pragma pack(pop)
#endif

//-------------------------------------------------------------------------------

#endif // Rez

//-------------------------------------------------------------------------------

#endif // __PIActions_h__