Debian Codegraph @

core/libs/dngwriter/extra/dng_sdk/dng_xmp_sdk.h

raw
1 /*****************************************************************************/
2 // Copyright 2006-2019 Adobe Systems Incorporated
3 // All Rights Reserved.
4 //
5 // NOTICE: Adobe permits you to use, modify, and distribute this file in
6 // accordance with the terms of the Adobe license agreement accompanying it.
7 /*****************************************************************************/
8
9 #ifndef __dng_xmp_sdk__
10 #define __dng_xmp_sdk__
11
12 /*****************************************************************************/
13
14 #include "dng_auto_ptr.h"
15 #include "dng_classes.h"
16 #include "dng_flags.h"
17 #include "dng_types.h"
18
19 /*****************************************************************************/
20
21 #if qDNGUseXMP
22
23 /*****************************************************************************/
24
25 extern const char *XMP_NS_TIFF;
26 extern const char *XMP_NS_EXIF;
27 extern const char *XMP_NS_EXIFEX;
28 extern const char *XMP_NS_PHOTOSHOP;
29 extern const char *XMP_NS_XAP;
30 extern const char *XMP_NS_XAP_RIGHTS;
31 extern const char *XMP_NS_DC;
32 extern const char *XMP_NS_XMP_NOTE;
33 extern const char *XMP_NS_MM;
34
35 extern const char *XMP_NS_CRS;
36 extern const char *XMP_NS_CRSS;
37 extern const char *XMP_NS_CRD;
38 extern const char *XMP_NS_CRLCP;
39
40 extern const char *XMP_NS_LR;
41
42 extern const char *XMP_NS_LCP;
43
44 extern const char *XMP_NS_AUX;
45
46 extern const char *XMP_NS_IPTC;
47 extern const char *XMP_NS_IPTC_EXT;
48
49 extern const char *XMP_NS_CRX;
50
51 extern const char *XMP_NS_DNG;
52
53 extern const char *XMP_NS_PANO;
54
55 extern const char *XMP_NS_GPANO;
56
57 extern const char *XMP_NS_REGIONS;
58
59 extern const char *XMP_NS_HDRGM;
60 extern const char *XMP_NS_HDR_META;
61
62 extern const char *XMP_NS_APPLE_HDRGM;
63 extern const char *XMP_NS_APPLE_PIXELDATA;
64
65 /*****************************************************************************/
66
67 class dng_xmp_private;
68
69 /*****************************************************************************/
70
71 typedef bool (IteratePathsCallback) (const char *ns,
72 const char *path,
73 void *callbackData);
74
75 /*****************************************************************************/
76
77 struct dng_xmp_namespace
78 {
79 const char * fullName;
80 const char * shortName;
81 };
82
83 /*****************************************************************************/
84
85 class dng_xmp_sdk
86 {
87
88 private:
89
90 dng_xmp_private *fPrivate;
91
92 public:
93
94 dng_xmp_sdk ();
95
96 dng_xmp_sdk (const dng_xmp_sdk &sdk);
97
98 virtual ~dng_xmp_sdk ();
99
100 static void InitializeSDK (dng_xmp_namespace * extraNamespaces = NULL,
101 const char *software = NULL);
102
103 static void TerminateSDK ();
104
105 bool HasMeta () const;
106
107 void RequireMeta ()
108 {
109 NeedMeta ();
110 }
111
112 void * GetPrivateMeta ();
113
114 void Parse (dng_host &host,
115 const char *buffer,
116 uint32 count);
117
118 bool Exists (const char *ns,
119 const char *path) const;
120
121 void AppendArrayItem (const char *ns,
122 const char *arrayName,
123 const char *itemValue,
124 bool isBag = true,
125 bool propIsStruct = false);
126
127 int32 CountArrayItems (const char *ns,
128 const char *path) const;
129
130 bool HasNameSpace (const char *ns) const;
131
132 void Remove (const char *ns,
133 const char *path);
134
135 void RemoveProperties (const char *ns);
136
137 bool IsEmptyString (const char *ns,
138 const char *path);
139
140 bool IsEmptyArray (const char *ns,
141 const char *path);
142
143 void ComposeArrayItemPath (const char *ns,
144 const char *arrayName,
145 int32 itemNumber,
146 dng_string &s) const;
147
148 void ComposeStructFieldPath (const char *ns,
149 const char *structName,
150 const char *fieldNS,
151 const char *fieldName,
152 dng_string &s) const;
153
154 bool GetNamespacePrefix (const char *uri,
155 dng_string &s) const;
156
157 bool GetString (const char *ns,
158 const char *path,
159 dng_string &s) const;
160
161 void ValidateStringList (const char *ns,
162 const char *path);
163
164 bool GetStringList (const char *ns,
165 const char *path,
166 dng_string_list &list,
167 dng_abort_sniffer *sniffer = NULL) const;
168
169 bool GetAltLangDefault (const char *ns,
170 const char *path,
171 dng_string &s,
172 bool silent = false) const;
173
174 bool GetLocalString (const char *ns,
175 const char *path,
176 dng_local_string &s) const;
177
178 bool GetStructField (const char *ns,
179 const char *path,
180 const char *fieldNS,
181 const char *fieldName,
182 dng_string &s) const;
183
184 void Set (const char *ns,
185 const char *path,
186 const char *text);
187
188 void SetString (const char *ns,
189 const char *path,
190 const dng_string &s);
191
192 void SetStringList (const char *ns,
193 const char *path,
194 const dng_string_list &list,
195 bool isBag);
196
197 void SetAltLangDefault (const char *ns,
198 const char *path,
199 const dng_string &s);
200
201 void SetLocalString (const char *ns,
202 const char *path,
203 const dng_local_string &s);
204
205 void SetStructField (const char *ns,
206 const char *path,
207 const char *fieldNS,
208 const char *fieldName,
209 const char *text);
210
211 void DeleteStructField (const char *ns,
212 const char *structName,
213 const char *fieldNS,
214 const char *fieldName);
215
216 dng_memory_block * Serialize (dng_memory_allocator &allocator,
217 bool asPacket,
218 uint32 targetBytes,
219 uint32 padBytes,
220 bool forJPEG,
221 bool compact) const;
222
223 void PackageForJPEG (dng_memory_allocator &allocator,
224 AutoPtr<dng_memory_block> &stdBlock,
225 AutoPtr<dng_memory_block> &extBlock,
226 dng_string &extDigest) const;
227
228 void MergeFromJPEG (const dng_xmp_sdk *xmp);
229
230 void ReplaceXMP (dng_xmp_sdk *xmp);
231
232 bool IteratePaths (IteratePathsCallback *callback,
233 void *callbackData = NULL,
234 const char *startNS = NULL,
235 const char *startingPath = NULL,
236 bool justChildren = false);
237
238 void DuplicateSubtree (const dng_xmp_sdk &source,
239 const char *sourceNS,
240 const char *sourceRoot,
241 const char *destNS = NULL,
242 const char *destRoot = NULL);
243
244 #if qDNGXMPDocOps
245
246 void DocOpsOpenXMP (const char *srcMIME);
247
248 void DocOpsPrepareForSave (const char *srcMIME,
249 const char *dstMIME,
250 bool newPath = true);
251
252 void DocOpsUpdateMetadata (const char *srcMIME);
253
254 #endif
255
256 private:
257
258 void ClearMeta ();
259
260 void MakeMeta ();
261
262 void NeedMeta ();
263
264 // Hidden assignment operator.
265
266 dng_xmp_sdk & operator= (const dng_xmp_sdk &sdk);
267
268 };
269
270 /*****************************************************************************/
271
272 #endif // qDNGUseXMP
273
274 /*****************************************************************************/
275
276 #endif // __dng_xmp_sdk__
277
278 /*****************************************************************************/