XMP_Const.h

Go to the documentation of this file.

#ifndef __XMP_Const_h__
#define __XMP_Const_h__ 1

// =================================================================================================
// Copyright 2002-2008 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.
// =================================================================================================

#include "XMP_Environment.h"

   #include <stddef.h>

#if XMP_MacBuild    // ! No stdint.h on Windows and some UNIXes.
    #include <stdint.h>
#endif

#if __cplusplus
extern "C" {
#endif

// =================================================================================================
// =================================================================================================

// =================================================================================================
// Basic types and constants
// =========================

// The XMP_... types are used on the off chance that the ..._t types present a problem. In that
// case only the declarations of the XMP_... types needs to change, not all of the uses. These
// types are used where fixed sizes are required in order to have a known ABI for a DLL build.

#if XMP_MacBuild

    typedef int8_t   XMP_Int8;
    typedef int16_t  XMP_Int16;
    typedef int32_t  XMP_Int32;
    typedef int64_t  XMP_Int64;

    typedef uint8_t  XMP_Uns8;
    typedef uint16_t XMP_Uns16;
    typedef uint32_t XMP_Uns32;
    typedef uint64_t XMP_Uns64;

#else

    typedef signed char XMP_Int8;
    typedef signed short XMP_Int16;
    typedef signed long XMP_Int32;
    typedef signed long long XMP_Int64;

    typedef unsigned char XMP_Uns8;
    typedef unsigned short XMP_Uns16;
    typedef unsigned long XMP_Uns32;
    typedef unsigned long long XMP_Uns64;

#endif

typedef XMP_Uns8 XMP_Bool;

typedef struct __XMPMeta__ *        XMPMetaRef;

typedef struct __XMPIterator__ *    XMPIteratorRef;

typedef struct __XMPDocOps__ *    XMPDocOpsRef;

typedef struct __XMPFiles__ *       XMPFilesRef;

// =================================================================================================






typedef const char * XMP_StringPtr;  // Points to a null terminated UTF-8 string.
typedef XMP_Uns32    XMP_StringLen;
typedef XMP_Int32    XMP_Index;      // Signed, sometimes -1 is handy.
typedef XMP_Uns32    XMP_OptionBits; // Used as 32 individual bits.



#define kXMP_TrueStr  "True"  // Serialized XMP spellings, not for the type bool.
#define kXMP_FalseStr "False"

enum {
    kXMPTS_Yes = 1,
    kXMPTS_No = 0,
    kXMPTS_Maybe = -1
};
typedef XMP_Int8 XMP_TriState;


// =================================================================================================


struct XMP_DateTime {

    XMP_Int32 year;

    XMP_Int32 month;

    XMP_Int32 day;

    XMP_Int32 hour;

    XMP_Int32 minute;

    XMP_Int32 second;

    XMP_Int32 tzSign;

    XMP_Int32 tzHour;

    XMP_Int32 tzMinute;

    XMP_Int32 nanoSecond;

};

enum {
    kXMP_TimeWestOfUTC = -1,
    kXMP_TimeIsUTC     =  0,
    kXMP_TimeEastOfUTC = +1
};

// =================================================================================================
// Standard namespace URI constants
// ================================


#define kXMP_NS_XMP        "http://ns.adobe.com/xap/1.0/"

#define kXMP_NS_XMP_Rights "http://ns.adobe.com/xap/1.0/rights/"
#define kXMP_NS_XMP_MM     "http://ns.adobe.com/xap/1.0/mm/"
#define kXMP_NS_XMP_BJ     "http://ns.adobe.com/xap/1.0/bj/"

#define kXMP_NS_PDF        "http://ns.adobe.com/pdf/1.3/"
#define kXMP_NS_Photoshop  "http://ns.adobe.com/photoshop/1.0/"
#define kXMP_NS_PSAlbum    "http://ns.adobe.com/album/1.0/"
#define kXMP_NS_EXIF       "http://ns.adobe.com/exif/1.0/"
#define kXMP_NS_EXIF_Aux   "http://ns.adobe.com/exif/1.0/aux/"
#define kXMP_NS_TIFF       "http://ns.adobe.com/tiff/1.0/"
#define kXMP_NS_PNG        "http://ns.adobe.com/png/1.0/"
#define kXMP_NS_SWF        "http://ns.adobe.com/swf/1.0/"
#define kXMP_NS_JPEG       "http://ns.adobe.com/jpeg/1.0/"
#define kXMP_NS_JP2K       "http://ns.adobe.com/jp2k/1.0/"
#define kXMP_NS_CameraRaw  "http://ns.adobe.com/camera-raw-settings/1.0/"
#define kXMP_NS_DM         "http://ns.adobe.com/xmp/1.0/DynamicMedia/"
#define kXMP_NS_ASF        "http://ns.adobe.com/asf/1.0/"
#define kXMP_NS_WAV        "http://ns.adobe.com/xmp/wav/1.0/"

#define kXMP_NS_XMP_Note   "http://ns.adobe.com/xmp/note/"

#define kXMP_NS_AdobeStockPhoto "http://ns.adobe.com/StockPhoto/1.0/"
#define kXMP_NS_CreatorAtom "http://ns.adobe.com/creatorAtom/1.0/"


#define kXMP_NS_XMP_IdentifierQual "http://ns.adobe.com/xmp/Identifier/qual/1.0/"
#define kXMP_NS_XMP_Dimensions     "http://ns.adobe.com/xap/1.0/sType/Dimensions#"
#define kXMP_NS_XMP_Text           "http://ns.adobe.com/xap/1.0/t/"
#define kXMP_NS_XMP_PagedFile      "http://ns.adobe.com/xap/1.0/t/pg/"
#define kXMP_NS_XMP_Graphics       "http://ns.adobe.com/xap/1.0/g/"
#define kXMP_NS_XMP_Image          "http://ns.adobe.com/xap/1.0/g/img/"
#define kXMP_NS_XMP_Font           "http://ns.adobe.com/xap/1.0/sType/Font#"
#define kXMP_NS_XMP_ResourceEvent  "http://ns.adobe.com/xap/1.0/sType/ResourceEvent#"
#define kXMP_NS_XMP_ResourceRef    "http://ns.adobe.com/xap/1.0/sType/ResourceRef#"
#define kXMP_NS_XMP_ST_Version     "http://ns.adobe.com/xap/1.0/sType/Version#"
#define kXMP_NS_XMP_ST_Job         "http://ns.adobe.com/xap/1.0/sType/Job#"
#define kXMP_NS_XMP_ManifestItem   "http://ns.adobe.com/xap/1.0/sType/ManifestItem#"

// Deprecated XML namespace constants
#define kXMP_NS_XMP_T     "http://ns.adobe.com/xap/1.0/t/"
#define kXMP_NS_XMP_T_PG  "http://ns.adobe.com/xap/1.0/t/pg/"
#define kXMP_NS_XMP_G_IMG "http://ns.adobe.com/xap/1.0/g/img/"


#define kXMP_NS_DC              "http://purl.org/dc/elements/1.1/"

#define kXMP_NS_IPTCCore       "http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/"

#define kXMP_NS_DICOM          "http://ns.adobe.com/DICOM/"

#define kXMP_NS_PDFA_Schema    "http://www.aiim.org/pdfa/ns/schema#"
#define kXMP_NS_PDFA_Property  "http://www.aiim.org/pdfa/ns/property#"
#define kXMP_NS_PDFA_Type      "http://www.aiim.org/pdfa/ns/type#"
#define kXMP_NS_PDFA_Field     "http://www.aiim.org/pdfa/ns/field#"
#define kXMP_NS_PDFA_ID        "http://www.aiim.org/pdfa/ns/id/"
#define kXMP_NS_PDFA_Extension "http://www.aiim.org/pdfa/ns/extension/"

#define kXMP_NS_PDFX           "http://ns.adobe.com/pdfx/1.3/"
#define kXMP_NS_PDFX_ID        "http://www.npes.org/pdfx/ns/id/"

#define kXMP_NS_RDF            "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
#define kXMP_NS_XML            "http://www.w3.org/XML/1998/namespace"

// =================================================================================================
// Enums and macros used for option bits
// =====================================


#define kXMP_ArrayLastItem      ((XMP_Index)(-1L))
#define kXMP_UseNullTermination ((XMP_StringLen)(~0UL))
#define kXMP_NoOptions          ((XMP_OptionBits)0UL)


#define XMP_SetOption(var,opt)      var |= (opt)
#define XMP_ClearOption(var,opt)    var &= ~(opt)
#define XMP_TestOption(var,opt)     (((var) & (opt)) != 0)
#define XMP_OptionIsSet(var,opt)    (((var) & (opt)) != 0)
#define XMP_OptionIsClear(var,opt)  (((var) & (opt)) == 0)


#define XMP_PropIsSimple(opt)       (((opt) & kXMP_PropCompositeMask) == 0)
#define XMP_PropIsStruct(opt)       (((opt) & kXMP_PropValueIsStruct) != 0)
#define XMP_PropIsArray(opt)        (((opt) & kXMP_PropValueIsArray) != 0)

#define XMP_ArrayIsUnordered(opt)   (((opt) & kXMP_PropArrayIsOrdered) == 0)
#define XMP_ArrayIsOrdered(opt)     (((opt) & kXMP_PropArrayIsOrdered) != 0)
#define XMP_ArrayIsAlternate(opt)   (((opt) & kXMP_PropArrayIsAlternate) != 0)
#define XMP_ArrayIsAltText(opt)     (((opt) & kXMP_PropArrayIsAltText) != 0)

#define XMP_PropHasQualifiers(opt)  (((opt) & kXMP_PropHasQualifiers) != 0)
#define XMP_PropIsQualifier(opt)    (((opt) & kXMP_PropIsQualifier) != 0)
#define XMP_PropHasLang(opt)        (((opt) & kXMP_PropHasLang) != 0)

#define XMP_NodeIsSchema(opt)       (((opt) & kXMP_SchemaNode) != 0)
#define XMP_PropIsAlias(opt)        (((opt) & kXMP_PropIsAlias) != 0)

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

enum {

    kXMP_PropValueIsURI       = 0x00000002UL,

    // ------------------------------------------------------
    // Options relating to qualifiers attached to a property.

    kXMP_PropHasQualifiers    = 0x00000010UL,

    kXMP_PropIsQualifier      = 0x00000020UL,

    kXMP_PropHasLang          = 0x00000040UL,

    kXMP_PropHasType          = 0x00000080UL,

    // --------------------------------------------
    // Options relating to the data structure form.

    kXMP_PropValueIsStruct    = 0x00000100UL,

    kXMP_PropValueIsArray     = 0x00000200UL,

    kXMP_PropArrayIsUnordered = kXMP_PropValueIsArray,

    kXMP_PropArrayIsOrdered   = 0x00000400UL,

    kXMP_PropArrayIsAlternate = 0x00000800UL,

    // ------------------------------------
    // Additional struct and array options.

    kXMP_PropArrayIsAltText   = 0x00001000UL,

    // kXMP_InsertBeforeItem  = 0x00004000UL,  ! Used by SetXyz functions.
    // kXMP_InsertAfterItem   = 0x00008000UL,  ! Used by SetXyz functions.

    // ----------------------------
    // Other miscellaneous options.

    kXMP_PropIsAlias          = 0x00010000UL,

    kXMP_PropHasAliases       = 0x00020000UL,

    kXMP_PropIsInternal       = 0x00040000UL,

    kXMP_PropIsStable         = 0x00100000UL,

    kXMP_PropIsDerived        = 0x00200000UL,

    // kXMPUtil_AllowCommas   = 0x10000000UL,  ! Used by TXMPUtils::CatenateArrayItems and ::SeparateArrayItems.
    // kXMP_DeleteExisting    = 0x20000000UL,  ! Used by TXMPMeta::SetXyz functions to delete any pre-existing property.
    // kXMP_SchemaNode        = 0x80000000UL,  ! Returned by iterators - #define to avoid warnings

    // ------------------------------
    // Masks that are multiple flags.

    kXMP_PropArrayFormMask    = kXMP_PropValueIsArray | kXMP_PropArrayIsOrdered | kXMP_PropArrayIsAlternate | kXMP_PropArrayIsAltText,

    kXMP_PropCompositeMask    = kXMP_PropValueIsStruct | kXMP_PropArrayFormMask,

    kXMP_ImplReservedMask     = 0x70000000L

};

#define kXMP_SchemaNode ((XMP_OptionBits)0x80000000UL)

enum {

    kXMP_InsertBeforeItem      = 0x00004000UL,

    kXMP_InsertAfterItem       = 0x00008000UL,

    kXMP_DeleteExisting        = 0x20000000UL,

    kXMP_PropValueOptionsMask  = kXMP_PropValueIsURI,

    kXMP_PropArrayLocationMask = kXMP_InsertBeforeItem | kXMP_InsertAfterItem

};

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

enum {

    kXMP_RequireXMPMeta   = 0x0001UL,

    kXMP_ParseMoreBuffers = 0x0002UL,

    kXMP_StrictAliasing   = 0x0004UL

};

enum {

    // *** Option to remove empty struct/array, or leaf with empty value?

    kXMP_OmitPacketWrapper   = 0x0010UL,

    kXMP_ReadOnlyPacket      = 0x0020UL,

    kXMP_UseCompactFormat    = 0x0040UL,

    kXMP_IncludeThumbnailPad = 0x0100UL,

    kXMP_ExactPacketLength   = 0x0200UL,

    kXMP_WriteAliasComments  = 0x0400UL,

    kXMP_OmitAllFormatting   = 0x0800UL,
    
    kXMP_OmitXMPMetaElement  = 0x1000UL,

    _XMP_LittleEndian_Bit    = 0x0001UL,  // ! Don't use directly, see the combined values below!
    _XMP_UTF16_Bit           = 0x0002UL,
    _XMP_UTF32_Bit           = 0x0004UL,

    kXMP_EncodingMask        = 0x0007UL,

    kXMP_EncodeUTF8          = 0UL,

    kXMP_EncodeUTF16Big      = _XMP_UTF16_Bit,

    kXMP_EncodeUTF16Little   = _XMP_UTF16_Bit | _XMP_LittleEndian_Bit,

    kXMP_EncodeUTF32Big      = _XMP_UTF32_Bit,

    kXMP_EncodeUTF32Little   = _XMP_UTF32_Bit | _XMP_LittleEndian_Bit

};

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

enum {

    kXMP_IterClassMask      = 0x00FFUL,

    kXMP_IterProperties     = 0x0000UL,

    kXMP_IterAliases        = 0x0001UL,

    kXMP_IterNamespaces     = 0x0002UL,

    kXMP_IterJustChildren   = 0x0100UL,

    kXMP_IterJustLeafNodes  = 0x0200UL,

    kXMP_IterJustLeafName   = 0x0400UL,

    kXMP_IterIncludeAliases = 0x0800UL,

    kXMP_IterOmitQualifiers = 0x1000UL

};

enum {

    kXMP_IterSkipSubtree    = 0x0001UL,

    kXMP_IterSkipSiblings   = 0x0002UL

};

// -------------------------------------------------------------------------------------------------
enum {

    kXMPUtil_AllowCommas      = 0x10000000UL

};

enum {

    kXMPUtil_DoAllProperties   = 0x0001UL,

    kXMPUtil_ReplaceOldValues  = 0x0002UL,

    kXMPUtil_DeleteEmptyValues = 0x0004UL,

    kXMPUtil_IncludeAliases    = 0x0800UL

};

// =================================================================================================
// Types and Constants for XMPFiles
// ================================

enum {
    
    // ! Hex used to avoid gcc warnings. Leave the constants so the text reads big endian. There
    // ! seems to be no decent way on UNIX to determine the target endianness at compile time.
    // ! Forcing it on the client isn't acceptable.

    // --------------------
    // Public file formats.

    kXMP_PDFFile             = 0x50444620UL,
    kXMP_PostScriptFile      = 0x50532020UL,
    kXMP_EPSFile             = 0x45505320UL,

    kXMP_JPEGFile            = 0x4A504547UL,
    kXMP_JPEG2KFile          = 0x4A505820UL,
    kXMP_TIFFFile            = 0x54494646UL,
    kXMP_GIFFile             = 0x47494620UL,
    kXMP_PNGFile             = 0x504E4720UL,

    kXMP_SWFFile             = 0x53574620UL,
    kXMP_FLAFile             = 0x464C4120UL,
    kXMP_FLVFile             = 0x464C5620UL,

    kXMP_MOVFile             = 0x4D4F5620UL,
    kXMP_AVIFile             = 0x41564920UL,
    kXMP_CINFile             = 0x43494E20UL,
    kXMP_WAVFile             = 0x57415620UL,
    kXMP_MP3File             = 0x4D503320UL,
    kXMP_SESFile             = 0x53455320UL,
    kXMP_CELFile             = 0x43454C20UL,
    kXMP_MPEGFile            = 0x4D504547UL,
    kXMP_MPEG2File           = 0x4D503220UL,
    kXMP_MPEG4File           = 0x4D503420UL,
    kXMP_WMAVFile            = 0x574D4156UL,
    kXMP_AIFFFile            = 0x41494646UL,
    kXMP_P2File              = 0x50322020UL,
    kXMP_XDCAM_FAMFile       = 0x58444346UL,
    kXMP_XDCAM_SAMFile       = 0x58444353UL,
    kXMP_XDCAM_EXFile        = 0x58444358UL,
    kXMP_AVCHDFile           = 0x41564844UL,
    kXMP_SonyHDVFile         = 0x53484456UL,

    kXMP_HTMLFile            = 0x48544D4CUL,
    kXMP_XMLFile             = 0x584D4C20UL,
    kXMP_TextFile            = 0x74657874UL,

    // -------------------------------
    // Adobe application file formats.

    kXMP_PhotoshopFile       = 0x50534420UL,
    kXMP_IllustratorFile     = 0x41492020UL,
    kXMP_InDesignFile        = 0x494E4444UL,
    kXMP_AEProjectFile       = 0x41455020UL,
    kXMP_AEProjTemplateFile  = 0x41455420UL,
    kXMP_AEFilterPresetFile  = 0x46465820UL,
    kXMP_EncoreProjectFile   = 0x4E434F52UL,
    kXMP_PremiereProjectFile = 0x5052504AUL,
    kXMP_PremiereTitleFile   = 0x5052544CUL,
    kXMP_UCFFile             = 0x55434620UL,

    // -------
    // Others.

    kXMP_UnknownFile         = 0x20202020UL

};

typedef XMP_Uns32 XMP_FileFormat;

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

enum {
    kXMP_CharLittleEndianMask = 1,
    kXMP_Char16BitMask        = 2,
    kXMP_Char32BitMask        = 4
};

enum {
    kXMP_Char8Bit        = 0,
    kXMP_Char16BitBig    = kXMP_Char16BitMask,
    kXMP_Char16BitLittle = kXMP_Char16BitMask | kXMP_CharLittleEndianMask,
    kXMP_Char32BitBig    = kXMP_Char32BitMask,
    kXMP_Char32BitLittle = kXMP_Char32BitMask | kXMP_CharLittleEndianMask,
    kXMP_CharUnknown     = 1
};


#define XMP_CharFormIs16Bit(f)         ( ((int)(f) & kXMP_Char16BitMask) != 0 )
#define XMP_CharFormIs32Bit(f)         ( ((int)(f) & kXMP_Char32BitMask) != 0 )
#define XMP_CharFormIsBigEndian(f)     ( ((int)(f) & kXMP_CharLittleEndianMask) == 0 )
#define XMP_CharFormIsLittleEndian(f)  ( ((int)(f) & kXMP_CharLittleEndianMask) != 0 )
#define XMP_GetCharSize(f)             ( ((int)(f)&6) == 0 ? 1 : (int)(f)&6 )
#define XMP_CharToSerializeForm(cf)    ( (XMP_OptionBits)(cf) )
#define XMP_CharFromSerializeForm(sf)  ( (XMP_Uns8)(sf) )

#define kXMPFiles_UnknownOffset ((XMP_Int64)-1)

#define kXMPFiles_UnknownLength ((XMP_Int32)-1)

struct XMP_PacketInfo {

    XMP_Int64 offset;
    XMP_Int32 length;
    XMP_Int32 padSize;   // Zero if unknown.

    XMP_Uns8  charForm;
    XMP_Bool  writeable;
    XMP_Bool  hasWrapper;

    XMP_Uns8  pad;

    XMP_PacketInfo() : offset(kXMPFiles_UnknownOffset), length(kXMPFiles_UnknownLength),
                       padSize(0), charForm(0), writeable(0), hasWrapper(0), pad(0) {};

};

enum {
    kXMP_PacketInfoVersion = 3
};

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

enum {
    kXMP_UnknownTNail = 0,
    kXMP_JPEGTNail    = 1,
    kXMP_TIFFTNail    = 2,
    kXMP_PShopTNail   = 3
};

struct XMP_ThumbnailInfo {

    XMP_FileFormat   fileFormat;
    XMP_Uns32        fullWidth, fullHeight;
    XMP_Uns32        tnailWidth, tnailHeight;

    XMP_Uns16        fullOrientation, tnailOrientation;
    const XMP_Uns8 * tnailImage;
    XMP_Uns32        tnailSize;
    XMP_Uns8         tnailFormat;

    XMP_Uns8         pad1, pad2, pad3;

    XMP_ThumbnailInfo() : fileFormat(kXMP_UnknownFile), fullWidth(0), fullHeight(0),
                          tnailWidth(0), tnailHeight(0), fullOrientation(0), tnailOrientation(0),
                          tnailImage(0), tnailSize(0), tnailFormat(kXMP_UnknownTNail) {};

};

enum {
    kXMP_ThumbnailInfoVersion = 1
};

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

enum {
    kXMPFiles_NoQuickTimeInit = 0x0001
};

enum {

    kXMPFiles_CanInjectXMP        = 0x00000001,

    kXMPFiles_CanExpand           = 0x00000002,

    kXMPFiles_CanRewrite          = 0x00000004,

    kXMPFiles_PrefersInPlace      = 0x00000008,

    kXMPFiles_CanReconcile        = 0x00000010,

    kXMPFiles_AllowsOnlyXMP       = 0x00000020,

    kXMPFiles_ReturnsRawPacket    = 0x00000040,

    kXMPFiles_ReturnsTNail        = 0x00000080,

    kXMPFiles_HandlerOwnsFile     = 0x00000100,

    kXMPFiles_AllowsSafeUpdate    = 0x00000200,

    kXMPFiles_NeedsReadOnlyPacket = 0x00000400,

    kXMPFiles_UsesSidecarXMP      = 0x00000800,

    kXMPFiles_FolderBasedFormat   = 0x00001000

};

enum {

    kXMPFiles_OpenForRead           = 0x00000001,

    kXMPFiles_OpenForUpdate         = 0x00000002,

    kXMPFiles_OpenOnlyXMP           = 0x00000004,

    kXMPFiles_OpenCacheTNail        = 0x00000008,

    kXMPFiles_OpenStrictly          = 0x00000010,

    kXMPFiles_OpenUseSmartHandler   = 0x00000020,

    kXMPFiles_OpenUsePacketScanning = 0x00000040,

    kXMPFiles_OpenLimitedScanning   = 0x00000080,
    
    kXMPFiles_OpenRepairFile        = 0x00000100,

    kXMPFiles_OpenInBackground      = 0x10000000

};

// A note about kXMPFiles_OpenInBackground. The XMPFiles handler for .mov files currently uses
// QuickTime. On Macintosh, calls to Enter/ExitMovies versus Enter/ExitMoviesOnThread must be made.
// This option is used to signal background use so that the .mov handler can behave appropriately.

enum {
    kXMPFiles_UpdateSafely = 0x0001
};

// =================================================================================================
// Exception codes
// ===============


class XMP_Error {
public:

    XMP_Error ( XMP_Int32 _id, XMP_StringPtr _errMsg ) : id(_id), errMsg(_errMsg) {};

    inline XMP_Int32     GetID() const     { return id; };

    inline XMP_StringPtr GetErrMsg() const { return errMsg; };

private:
    XMP_Int32     id;
    XMP_StringPtr errMsg;
};

enum {

    // --------------------
    // Generic error codes.
   
    kXMPErr_Unknown          =   0,
    kXMPErr_TBD              =   1,
    kXMPErr_Unavailable      =   2,
    kXMPErr_BadObject        =   3,
    kXMPErr_BadParam         =   4,
    kXMPErr_BadValue         =   5,
    kXMPErr_AssertFailure    =   6,
    kXMPErr_EnforceFailure   =   7,
    kXMPErr_Unimplemented    =   8,
    kXMPErr_InternalFailure  =   9,
    kXMPErr_Deprecated       =  10,
    kXMPErr_ExternalFailure  =  11,
    kXMPErr_UserAbort        =  12,
    kXMPErr_StdException     =  13,
    kXMPErr_UnknownException =  14,
    kXMPErr_NoMemory         =  15,

    // ------------------------------------
    // More specific parameter error codes.

    kXMPErr_BadSchema        = 101,
    kXMPErr_BadXPath         = 102,
    kXMPErr_BadOptions       = 103,
    kXMPErr_BadIndex         = 104,
    kXMPErr_BadIterPosition  = 105,
    kXMPErr_BadParse         = 106,
    kXMPErr_BadSerialize     = 107,
    kXMPErr_BadFileFormat    = 108,
    kXMPErr_NoFileHandler    = 109,
    kXMPErr_TooLargeForJPEG  = 110,

    // -----------------------------------------------
    // File format and internal structure error codes.

    kXMPErr_BadXML           = 201,
    kXMPErr_BadRDF           = 202,
    kXMPErr_BadXMP           = 203,
    kXMPErr_EmptyIterator    = 204,
    kXMPErr_BadUnicode       = 205,
    kXMPErr_BadTIFF          = 206,
    kXMPErr_BadJPEG          = 207,
    kXMPErr_BadPSD           = 208,
    kXMPErr_BadPSIR          = 209,
    kXMPErr_BadIPTC          = 210,
    kXMPErr_BadMPEG          = 211

};


// =================================================================================================
// Client callbacks
// ================

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


typedef XMP_Int32 XMP_Status;

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

typedef XMP_Status (* XMP_TextOutputProc) ( void *        refCon,
                                            XMP_StringPtr buffer,
                                            XMP_StringLen bufferSize );

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

typedef bool (* XMP_AbortProc) ( void * arg );  // Used by .


// =================================================================================================
// Stuff with no better place to be
// ================================

typedef struct XMP_VersionInfo {
    XMP_Uns8      major;
    XMP_Uns8      minor;
    XMP_Uns8      micro;
    XMP_Bool      isDebug;
    XMP_Uns32     build;
    XMP_Uns32     flags;
    XMP_StringPtr message;
} XMP_VersionInfo;

// =================================================================================================

#if __cplusplus
} // extern "C"
#endif

#endif  // __XMP_Const_h__

---