1HEADmaster

1 files changed, 1036 insertions, 0 deletions

diff --git a/common/quicktime_win32/Collections.h b/common/quicktime_win32/Collections.h
new file mode 100644
index 0000000..70d5111
--- /dev/null
+++ b/common/quicktime_win32/Collections.h
@@ -0,0 +1,1036 @@
+/*
+     File:       Collections.h
+ 
+     Contains:   Collection Manager Interfaces
+ 
+     Version:    QuickTime 7.3
+ 
+     Copyright:  (c) 2007 (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
+
+/*************/
+/* 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;
+/*
+ *  NewCollectionFlattenUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( CollectionFlattenUPP )
+NewCollectionFlattenUPP(CollectionFlattenProcPtr userRoutine);
+#if !OPAQUE_UPP_TYPES
+  enum { uppCollectionFlattenProcInfo = 0x00000FE0 };  /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes) */
+  #ifdef __cplusplus
+    inline DEFINE_API_C(CollectionFlattenUPP) NewCollectionFlattenUPP(CollectionFlattenProcPtr userRoutine) { return (CollectionFlattenUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionFlattenProcInfo, GetCurrentArchitecture()); }
+  #else
+    #define NewCollectionFlattenUPP(userRoutine) (CollectionFlattenUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionFlattenProcInfo, GetCurrentArchitecture())
+  #endif
+#endif
+
+/*
+ *  NewCollectionExceptionUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( CollectionExceptionUPP )
+NewCollectionExceptionUPP(CollectionExceptionProcPtr userRoutine);
+#if !OPAQUE_UPP_TYPES
+  enum { uppCollectionExceptionProcInfo = 0x000002E0 };  /* pascal 2_bytes Func(4_bytes, 2_bytes) */
+  #ifdef __cplusplus
+    inline DEFINE_API_C(CollectionExceptionUPP) NewCollectionExceptionUPP(CollectionExceptionProcPtr userRoutine) { return (CollectionExceptionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionExceptionProcInfo, GetCurrentArchitecture()); }
+  #else
+    #define NewCollectionExceptionUPP(userRoutine) (CollectionExceptionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCollectionExceptionProcInfo, GetCurrentArchitecture())
+  #endif
+#endif
+
+/*
+ *  DisposeCollectionFlattenUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( void )
+DisposeCollectionFlattenUPP(CollectionFlattenUPP userUPP);
+#if !OPAQUE_UPP_TYPES
+  #ifdef __cplusplus
+      inline DEFINE_API_C(void) DisposeCollectionFlattenUPP(CollectionFlattenUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
+  #else
+      #define DisposeCollectionFlattenUPP(userUPP) DisposeRoutineDescriptor(userUPP)
+  #endif
+#endif
+
+/*
+ *  DisposeCollectionExceptionUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( void )
+DisposeCollectionExceptionUPP(CollectionExceptionUPP userUPP);
+#if !OPAQUE_UPP_TYPES
+  #ifdef __cplusplus
+      inline DEFINE_API_C(void) DisposeCollectionExceptionUPP(CollectionExceptionUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
+  #else
+      #define DisposeCollectionExceptionUPP(userUPP) DisposeRoutineDescriptor(userUPP)
+  #endif
+#endif
+
+/*
+ *  InvokeCollectionFlattenUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( OSErr )
+InvokeCollectionFlattenUPP(
+  SInt32                size,
+  void *                data,
+  void *                refCon,
+  CollectionFlattenUPP  userUPP);
+#if !OPAQUE_UPP_TYPES
+  #ifdef __cplusplus
+      inline DEFINE_API_C(OSErr) InvokeCollectionFlattenUPP(SInt32 size, void * data, void * refCon, CollectionFlattenUPP userUPP) { return (OSErr)CALL_THREE_PARAMETER_UPP(userUPP, uppCollectionFlattenProcInfo, size, data, refCon); }
+  #else
+    #define InvokeCollectionFlattenUPP(size, data, refCon, userUPP) (OSErr)CALL_THREE_PARAMETER_UPP((userUPP), uppCollectionFlattenProcInfo, (size), (data), (refCon))
+  #endif
+#endif
+
+/*
+ *  InvokeCollectionExceptionUPP()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   available as macro/inline
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API_C( OSErr )
+InvokeCollectionExceptionUPP(
+  Collection              c,
+  OSErr                   status,
+  CollectionExceptionUPP  userUPP);
+#if !OPAQUE_UPP_TYPES
+  #ifdef __cplusplus
+      inline DEFINE_API_C(OSErr) InvokeCollectionExceptionUPP(Collection c, OSErr status, CollectionExceptionUPP userUPP) { return (OSErr)CALL_TWO_PARAMETER_UPP(userUPP, uppCollectionExceptionProcInfo, c, status); }
+  #else
+    #define InvokeCollectionExceptionUPP(c, status, userUPP) (OSErr)CALL_TWO_PARAMETER_UPP((userUPP), uppCollectionExceptionProcInfo, (c), (status))
+  #endif
+#endif
+
+#if CALL_NOT_IN_CARBON || OLDROUTINENAMES
+    /* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
+    #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)
+#endif /* CALL_NOT_IN_CARBON */
+
+/*********************************************/
+/************* Public interfaces *************/
+/*********************************************/
+/*
+ *  NewCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( Collection )
+NewCollection(void)                                           TWOWORDINLINE(0x7000, 0xABF6);
+
+
+
+/*
+ *  DisposeCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+DisposeCollection(Collection c)                               TWOWORDINLINE(0x7001, 0xABF6);
+
+
+
+/*
+ *  CloneCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( Collection )
+CloneCollection(Collection c)                                 TWOWORDINLINE(0x7002, 0xABF6);
+
+
+
+/*
+ *  CountCollectionOwners()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( SInt32 )
+CountCollectionOwners(Collection c)                           TWOWORDINLINE(0x7003, 0xABF6);
+
+
+
+/*
+ *  RetainCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   not available
+ *    CarbonLib:        in CarbonLib 1.1 and later
+ *    Mac OS X:         in version 10.1 and later
+ */
+EXTERN_API( OSStatus )
+RetainCollection(Collection c);
+
+
+
+/*
+ *  ReleaseCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   not available
+ *    CarbonLib:        in CarbonLib 1.1 and later
+ *    Mac OS X:         in version 10.1 and later
+ */
+EXTERN_API( OSStatus )
+ReleaseCollection(Collection c);
+
+
+
+/*
+ *  GetCollectionRetainCount()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   not available
+ *    CarbonLib:        in CarbonLib 1.1 and later
+ *    Mac OS X:         in version 10.1 and later
+ */
+EXTERN_API( ItemCount )
+GetCollectionRetainCount(Collection c);
+
+
+
+/*
+ *  CopyCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( Collection )
+CopyCollection(
+  Collection   srcCollection,
+  Collection   dstCollection)                                 TWOWORDINLINE(0x7004, 0xABF6);
+
+
+
+/*
+ *  GetCollectionDefaultAttributes()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( SInt32 )
+GetCollectionDefaultAttributes(Collection c)                  TWOWORDINLINE(0x7005, 0xABF6);
+
+
+
+/*
+ *  SetCollectionDefaultAttributes()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+SetCollectionDefaultAttributes(
+  Collection   c,
+  SInt32       whichAttributes,
+  SInt32       newAttributes)                                 TWOWORDINLINE(0x7006, 0xABF6);
+
+
+
+/*
+ *  CountCollectionItems()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( SInt32 )
+CountCollectionItems(Collection c)                            TWOWORDINLINE(0x7007, 0xABF6);
+
+
+
+/*
+ *  AddCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+AddCollectionItem(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          id,
+  SInt32          itemSize,
+  const void *    itemData)                                   TWOWORDINLINE(0x7008, 0xABF6);
+
+
+
+/*
+ *  GetCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetCollectionItem(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          id,
+  SInt32 *        itemSize,
+  void *          itemData)                                   TWOWORDINLINE(0x7009, 0xABF6);
+
+
+
+/*
+ *  RemoveCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+RemoveCollectionItem(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          id)                                         TWOWORDINLINE(0x700A, 0xABF6);
+
+
+
+/*
+ *  SetCollectionItemInfo()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+SetCollectionItemInfo(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          id,
+  SInt32          whichAttributes,
+  SInt32          newAttributes)                              TWOWORDINLINE(0x700B, 0xABF6);
+
+
+
+/*
+ *  GetCollectionItemInfo()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetCollectionItemInfo(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          id,
+  SInt32 *        index,
+  SInt32 *        itemSize,
+  SInt32 *        attributes)                                 TWOWORDINLINE(0x700C, 0xABF6);
+
+
+
+/*
+ *  ReplaceIndexedCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+ReplaceIndexedCollectionItem(
+  Collection    c,
+  SInt32        index,
+  SInt32        itemSize,
+  const void *  itemData)                                     TWOWORDINLINE(0x700D, 0xABF6);
+
+
+
+/*
+ *  GetIndexedCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetIndexedCollectionItem(
+  Collection   c,
+  SInt32       index,
+  SInt32 *     itemSize,
+  void *       itemData)                                      TWOWORDINLINE(0x700E, 0xABF6);
+
+
+
+/*
+ *  RemoveIndexedCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+RemoveIndexedCollectionItem(
+  Collection   c,
+  SInt32       index)                                         TWOWORDINLINE(0x700F, 0xABF6);
+
+
+
+/*
+ *  SetIndexedCollectionItemInfo()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+SetIndexedCollectionItemInfo(
+  Collection   c,
+  SInt32       index,
+  SInt32       whichAttributes,
+  SInt32       newAttributes)                                 TWOWORDINLINE(0x7010, 0xABF6);
+
+
+
+/*
+ *  GetIndexedCollectionItemInfo()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetIndexedCollectionItemInfo(
+  Collection       c,
+  SInt32           index,
+  CollectionTag *  tag,
+  SInt32 *         id,
+  SInt32 *         itemSize,
+  SInt32 *         attributes)                                TWOWORDINLINE(0x7011, 0xABF6);
+
+
+
+/*
+ *  CollectionTagExists()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( Boolean )
+CollectionTagExists(
+  Collection      c,
+  CollectionTag   tag)                                        TWOWORDINLINE(0x7012, 0xABF6);
+
+
+
+/*
+ *  CountCollectionTags()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( SInt32 )
+CountCollectionTags(Collection c)                             TWOWORDINLINE(0x7013, 0xABF6);
+
+
+
+/*
+ *  GetIndexedCollectionTag()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetIndexedCollectionTag(
+  Collection       c,
+  SInt32           tagIndex,
+  CollectionTag *  tag)                                       TWOWORDINLINE(0x7014, 0xABF6);
+
+
+
+/*
+ *  CountTaggedCollectionItems()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( SInt32 )
+CountTaggedCollectionItems(
+  Collection      c,
+  CollectionTag   tag)                                        TWOWORDINLINE(0x7015, 0xABF6);
+
+
+
+/*
+ *  GetTaggedCollectionItem()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetTaggedCollectionItem(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          whichItem,
+  SInt32 *        itemSize,
+  void *          itemData)                                   TWOWORDINLINE(0x7016, 0xABF6);
+
+
+
+/*
+ *  GetTaggedCollectionItemInfo()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetTaggedCollectionItemInfo(
+  Collection      c,
+  CollectionTag   tag,
+  SInt32          whichItem,
+  SInt32 *        id,
+  SInt32 *        index,
+  SInt32 *        itemSize,
+  SInt32 *        attributes)                                 TWOWORDINLINE(0x7017, 0xABF6);
+
+
+
+/*
+ *  PurgeCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+PurgeCollection(
+  Collection   c,
+  SInt32       whichAttributes,
+  SInt32       matchingAttributes)                            TWOWORDINLINE(0x7018, 0xABF6);
+
+
+
+/*
+ *  PurgeCollectionTag()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+PurgeCollectionTag(
+  Collection      c,
+  CollectionTag   tag)                                        TWOWORDINLINE(0x7019, 0xABF6);
+
+
+
+/*
+ *  EmptyCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+EmptyCollection(Collection c)                                 TWOWORDINLINE(0x701A, 0xABF6);
+
+
+/*
+ *  FlattenCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+FlattenCollection(
+  Collection             c,
+  CollectionFlattenUPP   flattenProc,
+  void *                 refCon)                              TWOWORDINLINE(0x701B, 0xABF6);
+
+
+
+/*
+ *  FlattenPartialCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+FlattenPartialCollection(
+  Collection             c,
+  CollectionFlattenUPP   flattenProc,
+  void *                 refCon,
+  SInt32                 whichAttributes,
+  SInt32                 matchingAttributes)                  TWOWORDINLINE(0x701C, 0xABF6);
+
+
+
+/*
+ *  UnflattenCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+UnflattenCollection(
+  Collection             c,
+  CollectionFlattenUPP   flattenProc,
+  void *                 refCon)                              TWOWORDINLINE(0x701D, 0xABF6);
+
+
+
+/*
+ *  GetCollectionExceptionProc()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( CollectionExceptionUPP )
+GetCollectionExceptionProc(Collection c)                      TWOWORDINLINE(0x701E, 0xABF6);
+
+
+
+/*
+ *  SetCollectionExceptionProc()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( void )
+SetCollectionExceptionProc(
+  Collection               c,
+  CollectionExceptionUPP   exceptionProc)                     TWOWORDINLINE(0x701F, 0xABF6);
+
+
+
+/*
+ *  GetNewCollection()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( Collection )
+GetNewCollection(SInt16 collectionID)                         TWOWORDINLINE(0x7020, 0xABF6);
+
+
+
+/**********************************************************************/
+/************** Utility routines for handle-based access **************/
+/**********************************************************************/
+/*
+ *  AddCollectionItemHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+AddCollectionItemHdl(
+  Collection      aCollection,
+  CollectionTag   tag,
+  SInt32          id,
+  Handle          itemData)                                   TWOWORDINLINE(0x7021, 0xABF6);
+
+
+
+/*
+ *  GetCollectionItemHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetCollectionItemHdl(
+  Collection      aCollection,
+  CollectionTag   tag,
+  SInt32          id,
+  Handle          itemData)                                   TWOWORDINLINE(0x7022, 0xABF6);
+
+
+
+/*
+ *  ReplaceIndexedCollectionItemHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+ReplaceIndexedCollectionItemHdl(
+  Collection   aCollection,
+  SInt32       index,
+  Handle       itemData)                                      TWOWORDINLINE(0x7023, 0xABF6);
+
+
+
+/*
+ *  GetIndexedCollectionItemHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+GetIndexedCollectionItemHdl(
+  Collection   aCollection,
+  SInt32       index,
+  Handle       itemData)                                      TWOWORDINLINE(0x7024, 0xABF6);
+
+
+
+/*
+ *  FlattenCollectionToHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+EXTERN_API( OSErr )
+FlattenCollectionToHdl(
+  Collection   aCollection,
+  Handle       flattened)                                     TWOWORDINLINE(0x7025, 0xABF6);
+
+
+
+/*
+ *  UnflattenCollectionFromHdl()
+ *  
+ *  Availability:
+ *    Non-Carbon CFM:   in CollectionsLib 1.0 and later
+ *    CarbonLib:        in CarbonLib 1.0 and later
+ *    Mac OS X:         in version 10.0 and later
+ */
+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 */
+
+
+
+#ifdef PRAGMA_IMPORT_OFF
+#pragma import off
+#elif PRAGMA_IMPORT
+#pragma import reset
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __COLLECTIONS__ */
+