1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
// =================================================================================================
// ADOBE SYSTEMS INCORPORATED
// Copyright 2010 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.
// =================================================================================================
#ifndef __AIFF_Handler_hpp__
#define __AIFF_Handler_hpp__ 1
#include "public/include/XMP_Environment.h" // ! XMP_Environment.h must be the first included header.
#include "public/include/XMP_Const.h"
#include "XMPFiles/source/FormatSupport/IFF/ChunkController.h"
#include "XMPFiles/source/FormatSupport/IFF/IChunkBehavior.h"
#include "XMPFiles/source/FormatSupport/IFF/IChunkData.h"
#include "source/Endian.h"
#include "XMPFiles/source/FormatSupport/IFF/ChunkPath.h"
#include "XMPFiles/source/FormatSupport/AIFF/AIFFMetadata.h"
#include "source/XIO.hpp"
#include "XMPFiles/source/XMPFiles_Impl.hpp"
using namespace IFF_RIFF;
// =================================================================================================
/// \file AIFF_Handler.hpp
/// \brief File format handler for AIFF.
// =================================================================================================
/**
* Contructor for the handler.
*/
extern XMPFileHandler * AIFF_MetaHandlerCTor ( XMPFiles * parent );
/**
* Checks the format of the file, see common code.
*/
extern bool AIFF_CheckFormat ( XMP_FileFormat format,
XMP_StringPtr filePath,
XMP_IO* fileRef,
XMPFiles * parent );
/** AIFF does not need kXMPFiles_CanRewrite as we can always use UpdateFile to either do
* in-place update or append to the file. */
static const XMP_OptionBits kAIFF_HandlerFlags = (kXMPFiles_CanInjectXMP |
kXMPFiles_CanExpand |
kXMPFiles_PrefersInPlace |
kXMPFiles_CanReconcile |
kXMPFiles_AllowsSafeUpdate
);
/**
* Main class for the the AIFF file handler.
*/
class AIFF_MetaHandler : public XMPFileHandler
{
public:
AIFF_MetaHandler ( XMPFiles* parent );
~AIFF_MetaHandler();
void CacheFileData();
void ProcessXMP();
void UpdateFile ( bool doSafeUpdate );
void WriteTempFile ( XMP_IO* tempRef );
/**
* Checks if the first 4 bytes of the given buffer are either type AIFF or AIFC
* @param buffer a byte buffer that must contain at least 4 bytes and point to the correct byte
* @return Either kType_AIFF, kType_AIFC 0 if no type could be determined
*/
static XMP_Uns32 whatAIFFFormat( XMP_Uns8* buffer );
private:
/**
* Updates/creates/deletes a given legacy chunk depending on the given new legacy value
* If the Chunk exists and the value is not empty, it is updated. If the value is empty the
* Chunk is removed from the tree. If the Chunk does not exist but a value is given, it is created
* and initialized with that value
*
* @param chunk OUT pointer to the legacy chunk
* @param chunkID Id of the Chunk if it needs to be created
* @param legacyId ID of the legacy value
*/
void updateLegacyChunk( IChunkData **chunk, XMP_Uns32 chunkID, XMP_Uns32 legacyId );
/**
* Finds the last non-empty annotation chunk in the given list
* @param annoChunks list of annotation chunks
* @return pointer to the first non-empty chunk or NULL
*/
IChunkData* selectLastNonEmptyAnnoChunk( const std::vector<IChunkData*> &annoChunks );
/** private standard Ctor, not to be used */
AIFF_MetaHandler (): mChunkController(NULL), mChunkBehavior(NULL),
mAiffMeta(), mXMPChunk(NULL),
mNameChunk(NULL), mAuthChunk(NULL),
mCprChunk(NULL), mAnnoChunk(NULL), mFileType(0) {};
// ----- MEMBERS ----- //
/** Controls the parsing and writing of the passed stream. */
ChunkController *mChunkController;
/** Represents the rules how chunks are added, removed or rearranged */
IChunkBehavior *mChunkBehavior;
/** container for Legacy metadata */
AIFFMetadata mAiffMeta;
/** pointer to the XMP chunk */
IChunkData *mXMPChunk;
/** pointer to legacy chunks */
IChunkData *mNameChunk;
IChunkData *mAuthChunk;
IChunkData *mCprChunk;
IChunkData *mAnnoChunk;
/** Type of the file, either AIFF or AIFC */
XMP_Uns32 mFileType;
// ----- CONSTANTS ----- //
/** Chunk path identifier of interest in AIFF/AIFC */
static const ChunkIdentifier kAIFFXMP[2];
static const ChunkIdentifier kAIFCXMP[2];
static const ChunkIdentifier kAIFFName[2];
static const ChunkIdentifier kAIFCName[2];
static const ChunkIdentifier kAIFFAuth[2];
static const ChunkIdentifier kAIFCAuth[2];
static const ChunkIdentifier kAIFFCpr[2];
static const ChunkIdentifier kAIFCCpr[2];
static const ChunkIdentifier kAIFFAnno[2];
static const ChunkIdentifier kAIFCAnno[2];
/** Path to XMP chunk */
ChunkPath mAIFFXMPChunkPath;
/** Path to NAME chunk */
ChunkPath mAIFFNameChunkPath;
/** Path to AUTH chunk */
ChunkPath mAIFFAuthChunkPath;
/** Path to COPYRIGHT chunk */
ChunkPath mAIFFCprChunkPath;
/** Path to ANNOTATION chunk */
ChunkPath mAIFFAnnoChunkPath;
}; // AIFF_MetaHandler
// =================================================================================================
#endif /* __AIFF_Handler_hpp__ */
|
