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
|
package jogamp.opengl.util.pngj.chunks;
import jogamp.opengl.util.pngj.PngHelper;
import jogamp.opengl.util.pngj.PngjException;
/**
* We consider "image metadata" every info inside the image except for the most basic image info (IHDR chunk - ImageInfo
* class) and the pixels values.
*
* This includes the palette (if present) and all the ancillary chunks
*
* This class provides a wrapper over the collection of chunks of a image (read or to write) and provides some high
* level methods to access them
*
*/
public class PngMetadata {
private final ChunkList chunkList;
private final boolean readonly;
public PngMetadata(ChunkList chunks, boolean readonly) {
this.chunkList = chunks;
this.readonly = readonly;
}
/**
* Queues the chunk at the writer
*/
public boolean setChunk(PngChunk c, boolean overwriteIfPresent) {
if (readonly)
throw new PngjException("cannot set chunk : readonly metadata");
return chunkList.setChunk(c, overwriteIfPresent);
}
/**
* Returns only one chunk or null if nothing found - does not include queued chunks
*
* If more than one chunk (after filtering by inner id) is found, then an exception is thrown (failifMultiple=true)
* or the last one is returned (failifMultiple=false)
*
* @param id Chunk id
* @param innerid if not null, the chunk is assumed to be PngChunkTextVar or PngChunkSPLT, and filtered by that 'internal id'
* @param failIfMultiple throw exception if more that one
* @return chunk (not cloned)
*/
public PngChunk getChunk1(String id, String innerid, boolean failIfMultiple) {
return chunkList.getChunk1(id, innerid, failIfMultiple);
}
/**
* Same as getChunk1(id, innerid=null, failIfMultiple=true);
*/
public PngChunk getChunk1(String id) {
return chunkList.getChunk1(id);
}
// ///// high level utility methods follow ////////////
// //////////// DPI
/**
* returns -1 if not found or dimension unknown
**/
public double[] getDpi() {
PngChunk c = getChunk1(ChunkHelper.pHYs, null, true);
if (c == null)
return new double[] { -1, -1 };
else
return ((PngChunkPHYS) c).getAsDpi2();
}
public void setDpi(double x) {
setDpi(x, x);
}
public void setDpi(double x, double y) {
PngChunkPHYS c = new PngChunkPHYS(chunkList.imageInfo);
c.setAsDpi2(x, y);
setChunk(c, true);
}
// //////////// TIME
public void setTimeNow(int secsAgo) {
PngChunkTIME c = new PngChunkTIME(chunkList.imageInfo);
c.setNow(secsAgo);
setChunk(c, true);
}
public void setTimeYMDHMS(int yearx, int monx, int dayx, int hourx, int minx, int secx) {
PngChunkTIME c = new PngChunkTIME(chunkList.imageInfo);
c.setYMDHMS(yearx, monx, dayx, hourx, minx, secx);
setChunk(c, true);
}
public String getTimeAsString() {
PngChunk c = getChunk1(ChunkHelper.tIME, null, true);
return c != null ? ((PngChunkTIME) c).getAsString() : "";
}
// //////////// TEXT
public void setText(String k, String val, boolean useLatin1, boolean compress) {
if (compress && !useLatin1)
throw new PngjException("cannot compress non latin text");
PngChunkTextVar c;
if (useLatin1) {
if (compress) {
c = new PngChunkZTXT(chunkList.imageInfo);
} else {
c = new PngChunkTEXT(chunkList.imageInfo);
}
} else {
c = new PngChunkITXT(chunkList.imageInfo);
((PngChunkITXT) c).setLangtag(k); // we use the same orig tag (this is not quite right)
}
c.setKeyVal(k, val);
setChunk(c, true);
}
public void setText(String k, String val) {
setText(k, val, false, val.length() > 400);
}
/** tries all text chunks - returns null if not found */
public String getTxtForKey(String k) {
PngChunk c = getChunk1(ChunkHelper.tEXt, k, true);
if (c == null)
c = getChunk1(ChunkHelper.zTXt, k, true);
if (c == null)
c = getChunk1(ChunkHelper.iTXt, k, true);
return c != null ? ((PngChunkTextVar) c).getVal() : null;
}
}
|
