topical media & game development
lib-of-vs-libs-QTDevWin-CIncludes-Collections.h / h
/*
File: Collections.h
Contains: Collection Manager Interfaces
Version: Technology: System 7.x
Release: QuickTime 6.0.2
Copyright: (c) 1989-2001 by Apple Computer, Inc., all rights reserved
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
ifndef __COLLECTIONS__
define __COLLECTIONS__
ifndef __MACTYPES__
include <MacTypes.h>
endif
ifndef __MIXEDMODE__
include <MixedMode.h>
endif
if PRAGMA_ONCE
#pragma once
endif
ifdef __cplusplus
extern "C" {
endif
if PRAGMA_IMPORT
#pragma import on
endif
if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
endif
**********
/* Constants */
**********
/* Convenience constants for functions which optionally return values */
enum {
kCollectionDontWantTag = 0L,
kCollectionDontWantId = 0L,
kCollectionDontWantSize = 0L,
kCollectionDontWantAttributes = 0L,
kCollectionDontWantIndex = 0L,
kCollectionDontWantData = 0L
};
/* attributes bits */
enum {
kCollectionNoAttributes = 0x00000000, /* no attributes bits set */
kCollectionAllAttributes = (long)0xFFFFFFFF, /* all attributes bits set */
kCollectionUserAttributes = 0x0000FFFF, /* user attributes bits */
kCollectionDefaultAttributes = 0x40000000 /* default attributes - unlocked, persistent */
};
/*
Attribute bits 0 through 15 (entire low word) are reserved for use by the application.
Attribute bits 16 through 31 (entire high word) are reserved for use by the Collection Manager.
Only bits 31 (kCollectionLockBit) and 30 (kCollectionPersistenceBit) currently have meaning.
*/
enum {
kCollectionUser0Bit = 0,
kCollectionUser1Bit = 1,
kCollectionUser2Bit = 2,
kCollectionUser3Bit = 3,
kCollectionUser4Bit = 4,
kCollectionUser5Bit = 5,
kCollectionUser6Bit = 6,
kCollectionUser7Bit = 7,
kCollectionUser8Bit = 8,
kCollectionUser9Bit = 9,
kCollectionUser10Bit = 10,
kCollectionUser11Bit = 11,
kCollectionUser12Bit = 12,
kCollectionUser13Bit = 13,
kCollectionUser14Bit = 14,
kCollectionUser15Bit = 15,
kCollectionReserved0Bit = 16,
kCollectionReserved1Bit = 17,
kCollectionReserved2Bit = 18,
kCollectionReserved3Bit = 19,
kCollectionReserved4Bit = 20,
kCollectionReserved5Bit = 21,
kCollectionReserved6Bit = 22,
kCollectionReserved7Bit = 23,
kCollectionReserved8Bit = 24,
kCollectionReserved9Bit = 25,
kCollectionReserved10Bit = 26,
kCollectionReserved11Bit = 27,
kCollectionReserved12Bit = 28,
kCollectionReserved13Bit = 29,
kCollectionPersistenceBit = 30,
kCollectionLockBit = 31
};
/* attribute masks */
enum {
kCollectionUser0Mask = 1L << kCollectionUser0Bit,
kCollectionUser1Mask = 1L << kCollectionUser1Bit,
kCollectionUser2Mask = 1L << kCollectionUser2Bit,
kCollectionUser3Mask = 1L << kCollectionUser3Bit,
kCollectionUser4Mask = 1L << kCollectionUser4Bit,
kCollectionUser5Mask = 1L << kCollectionUser5Bit,
kCollectionUser6Mask = 1L << kCollectionUser6Bit,
kCollectionUser7Mask = 1L << kCollectionUser7Bit,
kCollectionUser8Mask = 1L << kCollectionUser8Bit,
kCollectionUser9Mask = 1L << kCollectionUser9Bit,
kCollectionUser10Mask = 1L << kCollectionUser10Bit,
kCollectionUser11Mask = 1L << kCollectionUser11Bit,
kCollectionUser12Mask = 1L << kCollectionUser12Bit,
kCollectionUser13Mask = 1L << kCollectionUser13Bit,
kCollectionUser14Mask = 1L << kCollectionUser14Bit,
kCollectionUser15Mask = 1L << kCollectionUser15Bit,
kCollectionReserved0Mask = 1L << kCollectionReserved0Bit,
kCollectionReserved1Mask = 1L << kCollectionReserved1Bit,
kCollectionReserved2Mask = 1L << kCollectionReserved2Bit,
kCollectionReserved3Mask = 1L << kCollectionReserved3Bit,
kCollectionReserved4Mask = 1L << kCollectionReserved4Bit,
kCollectionReserved5Mask = 1L << kCollectionReserved5Bit,
kCollectionReserved6Mask = 1L << kCollectionReserved6Bit,
kCollectionReserved7Mask = 1L << kCollectionReserved7Bit,
kCollectionReserved8Mask = 1L << kCollectionReserved8Bit,
kCollectionReserved9Mask = 1L << kCollectionReserved9Bit,
kCollectionReserved10Mask = 1L << kCollectionReserved10Bit,
kCollectionReserved11Mask = 1L << kCollectionReserved11Bit,
kCollectionReserved12Mask = 1L << kCollectionReserved12Bit,
kCollectionReserved13Mask = 1L << kCollectionReserved13Bit,
kCollectionPersistenceMask = 1L << kCollectionPersistenceBit,
kCollectionLockMask = 1L << kCollectionLockBit
};
********
/* Types */
********
/* abstract data type for a collection */
typedef struct OpaqueCollection* Collection;
/* collection member 4 byte tag */
typedef FourCharCode CollectionTag;
typedef CALLBACK_API( OSErr , CollectionFlattenProcPtr )(SInt32 size, void *data, void *refCon);
typedef CALLBACK_API( OSErr , CollectionExceptionProcPtr )(Collection c, OSErr status);
typedef STACK_UPP_TYPE(CollectionFlattenProcPtr) CollectionFlattenUPP;
typedef STACK_UPP_TYPE(CollectionExceptionProcPtr) CollectionExceptionUPP;
if OPAQUE_UPP_TYPES
EXTERN_API(CollectionFlattenUPP)
NewCollectionFlattenUPP (CollectionFlattenProcPtr userRoutine);
EXTERN_API(CollectionExceptionUPP)
NewCollectionExceptionUPP (CollectionExceptionProcPtr userRoutine);
EXTERN_API(void)
DisposeCollectionFlattenUPP (CollectionFlattenUPP userUPP);
EXTERN_API(void)
DisposeCollectionExceptionUPP (CollectionExceptionUPP userUPP);
EXTERN_API(OSErr)
InvokeCollectionFlattenUPP (SInt32 size,
void * data,
void * refCon,
CollectionFlattenUPP userUPP);
EXTERN_API(OSErr)
InvokeCollectionExceptionUPP (Collection c,
OSErr status,
CollectionExceptionUPP userUPP);
else
enum { uppCollectionFlattenProcInfo = 0x00000FE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes) */
enum { uppCollectionExceptionProcInfo = 0x000002E0 }; /* pascal 2_bytes Func(4_bytes, 2_bytes) */
#define NewCollectionFlattenUPP(userRoutine) (CollectionFlattenUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionFlattenProcInfo, GetCurrentArchitecture())
#define NewCollectionExceptionUPP(userRoutine) (CollectionExceptionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionExceptionProcInfo, GetCurrentArchitecture())
#define DisposeCollectionFlattenUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define DisposeCollectionExceptionUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define InvokeCollectionFlattenUPP(size, data, refCon, userUPP) (OSErr)CALL_THREE_PARAMETER_UPP((userUPP), uppCollectionFlattenProcInfo, (size), (data), (refCon))
#define InvokeCollectionExceptionUPP(c, status, userUPP) (OSErr)CALL_TWO_PARAMETER_UPP((userUPP), uppCollectionExceptionProcInfo, (c), (status))
endif
/* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
define NewCollectionFlattenProc(userRoutine) NewCollectionFlattenUPP(userRoutine)
define NewCollectionExceptionProc(userRoutine) NewCollectionExceptionUPP(userRoutine)
define CallCollectionFlattenProc(userRoutine, size, data, refCon) InvokeCollectionFlattenUPP(size, data, refCon, userRoutine)
define CallCollectionExceptionProc(userRoutine, c, status) InvokeCollectionExceptionUPP(c, status, userRoutine)
******************************************
*********** Public interfaces ************
******************************************
EXTERN_API( Collection )
NewCollection (void) TWOWORDINLINE(0x7000, 0xABF6);
EXTERN_API( void )
DisposeCollection (Collection c) TWOWORDINLINE(0x7001, 0xABF6);
EXTERN_API( Collection )
CloneCollection (Collection c) TWOWORDINLINE(0x7002, 0xABF6);
EXTERN_API( SInt32 )
CountCollectionOwners (Collection c) TWOWORDINLINE(0x7003, 0xABF6);
EXTERN_API( Collection )
CopyCollection (Collection srcCollection,
Collection dstCollection) TWOWORDINLINE(0x7004, 0xABF6);
EXTERN_API( SInt32 )
GetCollectionDefaultAttributes (Collection c) TWOWORDINLINE(0x7005, 0xABF6);
EXTERN_API( void )
SetCollectionDefaultAttributes (Collection c,
SInt32 whichAttributes,
SInt32 newAttributes) TWOWORDINLINE(0x7006, 0xABF6);
EXTERN_API( SInt32 )
CountCollectionItems (Collection c) TWOWORDINLINE(0x7007, 0xABF6);
EXTERN_API( OSErr )
AddCollectionItem (Collection c,
CollectionTag tag,
SInt32 id,
SInt32 itemSize,
const void * itemData) TWOWORDINLINE(0x7008, 0xABF6);
EXTERN_API( OSErr )
GetCollectionItem (Collection c,
CollectionTag tag,
SInt32 id,
SInt32 * itemSize,
void * itemData) TWOWORDINLINE(0x7009, 0xABF6);
EXTERN_API( OSErr )
RemoveCollectionItem (Collection c,
CollectionTag tag,
SInt32 id) TWOWORDINLINE(0x700A, 0xABF6);
EXTERN_API( OSErr )
SetCollectionItemInfo (Collection c,
CollectionTag tag,
SInt32 id,
SInt32 whichAttributes,
SInt32 newAttributes) TWOWORDINLINE(0x700B, 0xABF6);
EXTERN_API( OSErr )
GetCollectionItemInfo (Collection c,
CollectionTag tag,
SInt32 id,
SInt32 * index,
SInt32 * itemSize,
SInt32 * attributes) TWOWORDINLINE(0x700C, 0xABF6);
EXTERN_API( OSErr )
ReplaceIndexedCollectionItem (Collection c,
SInt32 index,
SInt32 itemSize,
const void * itemData) TWOWORDINLINE(0x700D, 0xABF6);
EXTERN_API( OSErr )
GetIndexedCollectionItem (Collection c,
SInt32 index,
SInt32 * itemSize,
void * itemData) TWOWORDINLINE(0x700E, 0xABF6);
EXTERN_API( OSErr )
RemoveIndexedCollectionItem (Collection c,
SInt32 index) TWOWORDINLINE(0x700F, 0xABF6);
EXTERN_API( OSErr )
SetIndexedCollectionItemInfo (Collection c,
SInt32 index,
SInt32 whichAttributes,
SInt32 newAttributes) TWOWORDINLINE(0x7010, 0xABF6);
EXTERN_API( OSErr )
GetIndexedCollectionItemInfo (Collection c,
SInt32 index,
CollectionTag * tag,
SInt32 * id,
SInt32 * itemSize,
SInt32 * attributes) TWOWORDINLINE(0x7011, 0xABF6);
EXTERN_API( Boolean )
CollectionTagExists (Collection c,
CollectionTag tag) TWOWORDINLINE(0x7012, 0xABF6);
EXTERN_API( SInt32 )
CountCollectionTags (Collection c) TWOWORDINLINE(0x7013, 0xABF6);
EXTERN_API( OSErr )
GetIndexedCollectionTag (Collection c,
SInt32 tagIndex,
CollectionTag * tag) TWOWORDINLINE(0x7014, 0xABF6);
EXTERN_API( SInt32 )
CountTaggedCollectionItems (Collection c,
CollectionTag tag) TWOWORDINLINE(0x7015, 0xABF6);
EXTERN_API( OSErr )
GetTaggedCollectionItem (Collection c,
CollectionTag tag,
SInt32 whichItem,
SInt32 * itemSize,
void * itemData) TWOWORDINLINE(0x7016, 0xABF6);
EXTERN_API( OSErr )
GetTaggedCollectionItemInfo (Collection c,
CollectionTag tag,
SInt32 whichItem,
SInt32 * id,
SInt32 * index,
SInt32 * itemSize,
SInt32 * attributes) TWOWORDINLINE(0x7017, 0xABF6);
EXTERN_API( void )
PurgeCollection (Collection c,
SInt32 whichAttributes,
SInt32 matchingAttributes) TWOWORDINLINE(0x7018, 0xABF6);
EXTERN_API( void )
PurgeCollectionTag (Collection c,
CollectionTag tag) TWOWORDINLINE(0x7019, 0xABF6);
EXTERN_API( void )
EmptyCollection (Collection c) TWOWORDINLINE(0x701A, 0xABF6);
EXTERN_API( OSErr )
FlattenCollection (Collection c,
CollectionFlattenUPP flattenProc,
void * refCon) TWOWORDINLINE(0x701B, 0xABF6);
EXTERN_API( OSErr )
FlattenPartialCollection (Collection c,
CollectionFlattenUPP flattenProc,
void * refCon,
SInt32 whichAttributes,
SInt32 matchingAttributes) TWOWORDINLINE(0x701C, 0xABF6);
EXTERN_API( OSErr )
UnflattenCollection (Collection c,
CollectionFlattenUPP flattenProc,
void * refCon) TWOWORDINLINE(0x701D, 0xABF6);
EXTERN_API( CollectionExceptionUPP )
GetCollectionExceptionProc (Collection c) TWOWORDINLINE(0x701E, 0xABF6);
EXTERN_API( void )
SetCollectionExceptionProc (Collection c,
CollectionExceptionUPP exceptionProc) TWOWORDINLINE(0x701F, 0xABF6);
EXTERN_API( Collection )
GetNewCollection (SInt16 collectionID) TWOWORDINLINE(0x7020, 0xABF6);
*******************************************************************
************ Utility routines for handle-based access *************
*******************************************************************
EXTERN_API( OSErr )
AddCollectionItemHdl (Collection aCollection,
CollectionTag tag,
SInt32 id,
Handle itemData) TWOWORDINLINE(0x7021, 0xABF6);
EXTERN_API( OSErr )
GetCollectionItemHdl (Collection aCollection,
CollectionTag tag,
SInt32 id,
Handle itemData) TWOWORDINLINE(0x7022, 0xABF6);
EXTERN_API( OSErr )
ReplaceIndexedCollectionItemHdl (Collection aCollection,
SInt32 index,
Handle itemData) TWOWORDINLINE(0x7023, 0xABF6);
EXTERN_API( OSErr )
GetIndexedCollectionItemHdl (Collection aCollection,
SInt32 index,
Handle itemData) TWOWORDINLINE(0x7024, 0xABF6);
EXTERN_API( OSErr )
FlattenCollectionToHdl (Collection aCollection,
Handle flattened) TWOWORDINLINE(0x7025, 0xABF6);
EXTERN_API( OSErr )
UnflattenCollectionFromHdl (Collection aCollection,
Handle flattened) TWOWORDINLINE(0x7026, 0xABF6);
if OLDROUTINENAMES
enum {
dontWantTag = kCollectionDontWantTag,
dontWantId = kCollectionDontWantId,
dontWantSize = kCollectionDontWantSize,
dontWantAttributes = kCollectionDontWantAttributes,
dontWantIndex = kCollectionDontWantIndex,
dontWantData = kCollectionDontWantData
};
enum {
noCollectionAttributes = kCollectionNoAttributes,
allCollectionAttributes = kCollectionAllAttributes,
userCollectionAttributes = kCollectionUserAttributes,
defaultCollectionAttributes = kCollectionDefaultAttributes
};
enum {
collectionUser0Bit = kCollectionUser0Bit,
collectionUser1Bit = kCollectionUser1Bit,
collectionUser2Bit = kCollectionUser2Bit,
collectionUser3Bit = kCollectionUser3Bit,
collectionUser4Bit = kCollectionUser4Bit,
collectionUser5Bit = kCollectionUser5Bit,
collectionUser6Bit = kCollectionUser6Bit,
collectionUser7Bit = kCollectionUser7Bit,
collectionUser8Bit = kCollectionUser8Bit,
collectionUser9Bit = kCollectionUser9Bit,
collectionUser10Bit = kCollectionUser10Bit,
collectionUser11Bit = kCollectionUser11Bit,
collectionUser12Bit = kCollectionUser12Bit,
collectionUser13Bit = kCollectionUser13Bit,
collectionUser14Bit = kCollectionUser14Bit,
collectionUser15Bit = kCollectionUser15Bit,
collectionReserved0Bit = kCollectionReserved0Bit,
collectionReserved1Bit = kCollectionReserved1Bit,
collectionReserved2Bit = kCollectionReserved2Bit,
collectionReserved3Bit = kCollectionReserved3Bit,
collectionReserved4Bit = kCollectionReserved4Bit,
collectionReserved5Bit = kCollectionReserved5Bit,
collectionReserved6Bit = kCollectionReserved6Bit,
collectionReserved7Bit = kCollectionReserved7Bit,
collectionReserved8Bit = kCollectionReserved8Bit,
collectionReserved9Bit = kCollectionReserved9Bit,
collectionReserved10Bit = kCollectionReserved10Bit,
collectionReserved11Bit = kCollectionReserved11Bit,
collectionReserved12Bit = kCollectionReserved12Bit,
collectionReserved13Bit = kCollectionReserved13Bit,
collectionPersistenceBit = kCollectionPersistenceBit,
collectionLockBit = kCollectionLockBit
};
enum {
collectionUser0Mask = kCollectionUser0Mask,
collectionUser1Mask = kCollectionUser1Mask,
collectionUser2Mask = kCollectionUser2Mask,
collectionUser3Mask = kCollectionUser3Mask,
collectionUser4Mask = kCollectionUser4Mask,
collectionUser5Mask = kCollectionUser5Mask,
collectionUser6Mask = kCollectionUser6Mask,
collectionUser7Mask = kCollectionUser7Mask,
collectionUser8Mask = kCollectionUser8Mask,
collectionUser9Mask = kCollectionUser9Mask,
collectionUser10Mask = kCollectionUser10Mask,
collectionUser11Mask = kCollectionUser11Mask,
collectionUser12Mask = kCollectionUser12Mask,
collectionUser13Mask = kCollectionUser13Mask,
collectionUser14Mask = kCollectionUser14Mask,
collectionUser15Mask = kCollectionUser15Mask,
collectionReserved0Mask = kCollectionReserved0Mask,
collectionReserved1Mask = kCollectionReserved1Mask,
collectionReserved2Mask = kCollectionReserved2Mask,
collectionReserved3Mask = kCollectionReserved3Mask,
collectionReserved4Mask = kCollectionReserved4Mask,
collectionReserved5Mask = kCollectionReserved5Mask,
collectionReserved6Mask = kCollectionReserved6Mask,
collectionReserved7Mask = kCollectionReserved7Mask,
collectionReserved8Mask = kCollectionReserved8Mask,
collectionReserved9Mask = kCollectionReserved9Mask,
collectionReserved10Mask = kCollectionReserved10Mask,
collectionReserved11Mask = kCollectionReserved11Mask,
collectionReserved12Mask = kCollectionReserved12Mask,
collectionReserved13Mask = kCollectionReserved13Mask,
collectionPersistenceMask = kCollectionPersistenceMask,
collectionLockMask = kCollectionLockMask
};
endif /* OLDROUTINENAMES */
if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
endif
ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
endif
ifdef __cplusplus
}
endif
endif /* __COLLECTIONS__ */
(C) Æliens
04/09/2009
You may not copy or print any of this material without explicit permission of the author or the publisher.
In case of other copyright issues, contact the author.
