]>
Commit | Line | Data |
---|---|---|
8414a40c VZ |
1 | <HTML> |
2 | <HEAD> | |
3 | <TITLE> | |
4 | Changes in TIFF v3.6.0 | |
5 | </TITLE> | |
6 | </HEAD> | |
7 | ||
8 | <BODY BGCOLOR=white> | |
9 | <FONT FACE="Helvetica, Arial, Sans"> | |
10 | <FONT FACE="Helvetica, Arial, Sans"> | |
11 | ||
12 | <BASEFONT SIZE=4> | |
13 | <B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> | |
14 | <BASEFONT SIZE=3> | |
15 | ||
16 | <UL> | |
17 | <HR SIZE=4 WIDTH=65% ALIGN=left> | |
18 | <B>Current Version</B>: v3.6.0<BR> | |
19 | <B>Previous Version</B>: <A HREF=v3.5.7.html>v3.5.7</a><BR> | |
20 | <B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> | |
21 | ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> | |
22 | <B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> | |
23 | http://www.remotesensing.org/libtiff</a> | |
24 | <HR SIZE=4 WIDTH=65% ALIGN=left> | |
25 | </UL> | |
26 | ||
27 | <P> | |
28 | This document describes the changes made to the software between the | |
29 | <I>previous</I> and <I>current</I> versions (see above). | |
30 | If you don't find something listed here, then it was not done in this | |
31 | timeframe, or it was not considered important enough to be mentioned. | |
32 | The following information is located here: | |
33 | <UL> | |
34 | <LI><A HREF="#hightlights">Major Changes</A> | |
35 | <LI><A HREF="#configure">Changes in the software configuration</A> | |
36 | <LI><A HREF="#libtiff">Changes in libtiff</A> | |
37 | <LI><A HREF="#tools">Changes in the tools</A> | |
38 | <LI><A HREF="#contrib">Changes in the contrib area</A> | |
39 | <LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> | |
40 | </UL> | |
41 | <p> | |
42 | <P><HR WIDTH=65% ALIGN=left> | |
43 | ||
44 | <!---------------------------------------------------------------------------> | |
45 | ||
46 | <A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> | |
47 | ||
48 | <ul> | |
49 | <li> New utility <a href=./man/raw2tiff.1.html>raw2tiff</a> | |
50 | for converting raw rasters into TIFF files. | |
51 | <li> Lots of new <a href=./man/tiff2ps.1.html>tiff2ps</a> options. | |
52 | <li> Lots of new <a href=./man/fax2tiff.1.html>fax2tiff</a> options. | |
53 | <li> Lots of bug fixes for LZW, JPEG and OJPEG compression. | |
54 | </ul> | |
55 | ||
56 | <h3>Custom Tag Support</h3> | |
57 | ||
58 | The approach to extending libtiff with custom tags has changed radically. | |
59 | Previously, all internally supported TIFF tags had a place in the | |
60 | private TIFFDirectory structure within libtiff to hold the values (if read), | |
61 | and a "field number" (ie. FIELD_SUBFILETYPE) used to identify that tag. | |
62 | However, every time a new tag was added to the core, the size of the | |
63 | TIFFDirectory structure would changing, breaking any dynamically linked | |
64 | software that used the private data structures.<p> | |
65 | ||
66 | Also, any tag not recognised | |
67 | by libtiff would not be read and accessable to applications without some | |
68 | fairly complicated work on the applications part to pre-register the tags | |
69 | as exemplified by the support for "Geo"TIFF tags by libgeotiff layered on | |
70 | libtiff. <p> | |
71 | ||
72 | Amoung other things this approach required the extension code | |
73 | to access the private libtiff structures ... which made the higher level | |
74 | non-libtiff code be locked into a specific version of libtiff at compile time. | |
75 | This caused no end of bug reports!<p> | |
76 | ||
77 | The new approach is for libtiff to read all tags from TIFF files. Those that | |
78 | aren't recognised as "core tags" (those having an associated FIELD_ value, | |
79 | and place for storage in the TIFFDirectory structure) are now read into a | |
80 | dynamic list of extra tags (td_customValues in TIFFDirectory). When a new | |
81 | tag code is encountered for the first time in a given TIFF file, a new | |
82 | anonymous tag definition is created for the tag in the tag definition list. | |
83 | The type, and some other metadata is worked out from the instance encountered. | |
84 | These fields are known as "custom tags". <p> | |
85 | ||
86 | Custom tags can be set and fetched normally using TIFFSetField() and | |
87 | TIFFGetField(), and appear pretty much like normal tags to application code. | |
88 | However, they have no impact on internal libtiff processing (such as | |
89 | compression). Some utilities, such as tiffcp will now copy these custom | |
90 | tags to the new output files. <p> | |
91 | ||
92 | As well as the internal work with custom tags, new C API entry points | |
93 | were added so that extension libraries, such as libgeotiff, could | |
94 | define new tags more easily without accessing internal data structures. | |
95 | Because tag handling of extension tags is done via the "custom fields" | |
96 | mechanism as well, the definition provided externally mostly serves to provide | |
97 | a meaningful name for the tag. | |
98 | ||
99 | The addition of "custom tags" and the altered approach to extending libtiff | |
100 | with externally defined tags is the primary reason for the shift to the | |
101 | 3.6.x version number from 3.5.x.<p> | |
102 | ||
103 | <P><HR WIDTH=65% ALIGN=left> | |
104 | <!---------------------------------------------------------------------------> | |
105 | ||
106 | <A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> | |
107 | ||
108 | <UL> | |
109 | <li> configure, config.site: Fix for large files (>2GiB) support. New | |
110 | option in the config.site: LARGEFILE="yes". Should be enougth for the large | |
111 | files I/O. | |
112 | ||
113 | <li> configure: Set -DPIXARLOG_SUPPORT option along with -DZIP_SUPPORT. | |
114 | ||
115 | <li> html/Makefile.in: Updated to use groffhtml for generating html pages | |
116 | from man pages. | |
117 | ||
118 | <li> configure, libtiff/Makefile.in: Added SCO OpenServer 5.0.6 support | |
119 | from John H. DuBois III. | |
120 | ||
121 | <li> libtiff/{Makefile.vc, libtiff.def}: Missed declarations added. | |
122 | ||
123 | <li> libtiff/Makefile.in, tools/Makefile.in: Shared library will not be | |
124 | stripped when installing, utility binaries will do be stripped. As per bug 93. | |
125 | ||
126 | <li> man/Makefile.in: Patch DESTDIR handling as per bug 95. | |
127 | ||
128 | <li> configure: OpenBSD changes for Sparc64 and DSO version as per bug 96. | |
129 | ||
130 | <li> config.site/configure: added support for OJPEG=yes option to enable | |
131 | OJPEG support from config.site. | |
132 | ||
133 | <li> config.guess, config.sub: Updated from ftp.gnu.org/pub/config. | |
134 | ||
135 | <li> configure: Modify CheckForBigEndian so it can work in a cross | |
136 | compiled situation. | |
137 | ||
138 | <li> configure, libtiff/Makefile.in: Changes for building on MacOS 10.1 | |
139 | as per bug 94. | |
140 | ||
141 | <li> html/Makefile.in: added missing images per bug 92. | |
142 | ||
143 | <li> port/Makefile.in: fixed clean target per bug 92. | |
144 | </UL> | |
145 | ||
146 | <P><HR WIDTH=65% ALIGN=left> | |
147 | ||
148 | <!---------------------------------------------------------------------------> | |
149 | ||
150 | <A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> | |
151 | ||
152 | <UL> | |
153 | ||
154 | <li> libtiff/tif_getimage.c: New function <A | |
155 | HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImageOriented()</A> | |
156 | implemented to retrieve raster array with user-specified origin position. | |
157 | ||
158 | <li> libtiff/tif_fax3.c: Fix wrong line numbering. | |
159 | ||
160 | <li> libtiff/tif_dirread.c: Check field counter against number of fields. | |
161 | ||
162 | <li> Store a list of opened IFD to prevent directory looping. | |
163 | ||
164 | <li> libtiff/tif_jpeg.c: modified segment_height calculation to always | |
165 | be a full height tile for tiled images. Also changed error to just | |
166 | be a warning. | |
167 | ||
168 | <li> libtiff/tif_lzw.c: fixed so that decoder state isn't allocated till | |
169 | LZWSetupDecode(). Needed to read LZW files in "r+" mode. | |
170 | ||
171 | <li> libtiff/tif_dir.c: fixed up the tif_postdecode settings responsible | |
172 | for byte swapping complex image data. | |
173 | ||
174 | <li> libtiff/tif_open.c: Removed error if opening a compressed file | |
175 | in update mode bug (198). | |
176 | ||
177 | <li> libtiff/tif_write.c: TIFFWriteCheck() now fails if the image is | |
178 | a pre-existing compressed image. That is, image writing to pre-existing | |
179 | compressed images is not allowed. | |
180 | ||
181 | <li> html/man/*.html: Web pages regenerated from man pages. | |
182 | ||
183 | <li> libtiff/tif_jpeg.c: Hack to ensure that "boolean" is defined properly | |
184 | on Windows so as to avoid the structure size mismatch error from libjpeg | |
185 | (bug 188). | |
186 | ||
187 | <li> libtiff/tiff.h: #ifdef USING_VISUALAGE around previous Visual Age | |
188 | AIX porting hack as it screwed up gcc. (bug 39) | |
189 | ||
190 | <li> libtiff/tiff.h: added COMPRESSION_JP2000 (34712) for LEAD tools | |
191 | custom compression. | |
192 | ||
193 | <li> libtiff/tif_dirread.c: Another fix for the fetching SBYTE arrays | |
194 | by the TIFFFetchByteArray() function. (bug 52) | |
195 | ||
196 | <li> libtiff/tif_dirread.c: Expand v[2] to v[4] in TIFFFetchShortPair() | |
197 | as per bug 196. | |
198 | ||
199 | <li> libtiff/tif_lzw.c: Additional consistency checking added in | |
200 | LZWDecode() and LZWDecodeCompat() fixing bugs 190 and 100. | |
201 | ||
202 | <li> libtiff/tif_lzw.c: Added check for valid code lengths in LZWDecode() | |
203 | and LZWDecodeCompat(). Fixes bug 115. | |
204 | ||
205 | <li> tif_getimage.c: Ensure that TIFFRGBAImageBegin() returns the | |
206 | return code from the underlying pick function as per bug 177. | |
207 | ||
208 | <li> libtiff/{tif_jpeg.c,tif_strip.c,tif_print.c}: Hacked tif_jpeg.c to | |
209 | fetch TIFFTAG_YCBCRSUBSAMPLING from the jpeg data stream if it isn't | |
210 | present in the tiff tags as per bug 168. | |
211 | ||
212 | <li> libtiff/tif_jpeg.c: Fixed problem with setting of nrows in | |
213 | JPEGDecode() as per bug 129. | |
214 | ||
215 | <li> libtiff/tif_read.c, libtiff/tif_write.c: TIFFReadScanline() and | |
216 | TIFFWriteScanline() now set tif_row explicitly in case the codec has | |
217 | fooled with the value as per bug 129. | |
218 | ||
219 | <li> libtiff/tif_ojpeg.c: Major upgrade from Scott. Details in bug 156. | |
220 | ||
221 | <li> libtiff/tif_open.c: Pointers to custom procedures | |
222 | in TIFFClientOpen() are checked to be not NULL-pointers. | |
223 | ||
224 | <li> libtiff/tif_lzw.c: Assertions in LZWDecode and LZWDecodeCompat | |
225 | replaced by warnings. Now libtiff should read corrupted LZW-compressed | |
226 | files by skipping bad strips as per bug 100. | |
227 | ||
228 | <li> libtiff/: tif_dirwrite.c, tif_write.c, tiffio.h: | |
229 | <a href=./man/TIFFWriteDirectory.3t.html>TIFFCheckpointDirectory()</a> | |
230 | routine added as per bug 124. The | |
231 | <a href=./man/TIFFWriteDirectory.3t.html>TIFFWriteDirectory</a> | |
232 | man page discusses this new function as well as the related | |
233 | <a href=./man/TIFFWriteDirectory.3t.html>TIFFRewriteDirectory()</a>. | |
234 | ||
235 | <li> libtiff/: tif_codec.c, tif_compress.c, tiffiop.h, tif_getimage.c: | |
236 | Introduced | |
237 | additional members tif->tif_decodestatus and tif->tif_encodestatus | |
238 | for correct handling of unconfigured codecs (we should not try to read | |
239 | data or to define data size without correct codecs). See bug 119. | |
240 | ||
241 | <li> tif_dirread.c: avoid div-by-zero if rowbytes is zero in chop func as | |
242 | per bug 111. | |
243 | ||
244 | <li> libtiff/: tiff.h, tif_dir.c, tif_dir.h, tif_dirinfo.c, tif_dirread.c, | |
245 | tif_dirwrite.c: Dwight Kelly added get/put code for new tag XMLPACKET as | |
246 | defined in Adobe XMP Technote. Added missing INKSET tag value from TIFF 6.0 | |
247 | spec INKSET_MULTIINK (=2). Added missing tags from Adobe TIFF technotes: | |
248 | CLIPPATH, XCLIPPATHUNITS, YCLIPPATHUNITS, OPIIMAGEID, OPIPROXY and | |
249 | INDEXED. Added PHOTOMETRIC tag value from TIFF technote 4 ICCLAB (=9). | |
250 | ||
251 | <li> libtiff/tif_getimage.c: Additional check for supported codecs added in | |
252 | TIFFRGBAImageOK, TIFFReadRGBAImage, TIFFReadRGBAStrip and TIFFReadRGBATile now | |
253 | use TIFFRGBAImageOK before reading a per bug 110. | |
254 | ||
255 | <li> libtiff/: tif_dir.c, tif_dir.h, tif_dirinfo.c, tif_dirread.c, | |
256 | tif_dirwrite.c: Added routine | |
257 | <a href=./man/TIFFDataWidth.3t.html>TIFFDataWidth</a> for determining | |
258 | TIFFDataType sizes instead of working with tiffDataWidth array | |
259 | directly as per bug 109. | |
260 | ||
261 | <li>libtiff/: tif_dirinfo.c, tif_dirwrite.c: Added possibility to | |
262 | read broken TIFFs with LONG type used for TIFFTAG_COMPRESSION, | |
263 | TIFFTAG_BITSPERSAMPLE, TIFFTAG_PHOTOMETRIC as per bug 99. | |
264 | ||
265 | <li> libtiff/{tiff.h,tif_fax3.c}: Add support for __arch64__ as per bug 94. | |
266 | ||
267 | <li> libtiff/tif_read.c: Fixed TIFFReadEncodedStrip() to fail if the | |
268 | decodestrip function returns anything not greater than zero as per bug 97. | |
269 | ||
270 | <li> libtiff/tif_jpeg.c: fixed computation of segment_width for | |
271 | tiles files to avoid error about it not matching the | |
272 | cinfo.d.image_width values ("JPEGPreDecode: Improper JPEG strip/tile | |
273 | size.") for ITIFF files. Apparently the problem was incorporated since | |
274 | 3.5.5, presumably during the OJPEG/JPEG work recently. | |
275 | ||
276 | <li> libtiff/tif_getimage.c: If DEFAULT_EXTRASAMPLE_AS_ALPHA is 1 | |
277 | (defined in tiffconf.h - 1 by default) then the RGBA interface | |
278 | will assume that a fourth extra sample is ASSOCALPHA if the | |
279 | EXTRASAMPLE value isn't set for it. This changes the behaviour of | |
280 | the library, but makes it work better with RGBA files produced by | |
281 | lots of applications that don't mark the alpha values properly. | |
282 | As per bugs 93 and 65. | |
283 | ||
284 | <li> libtiff/tif_jpeg.c: allow jpeg data stream sampling values to | |
285 | override those from tiff directory. This makes this work with | |
286 | ImageGear generated files. | |
287 | ||
288 | </UL> | |
289 | ||
290 | <P><HR WIDTH=65% ALIGN=left> | |
291 | ||
292 | <!--------------------------------------------------------------------------> | |
293 | ||
294 | <A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> | |
295 | ||
296 | <UL> | |
297 | ||
298 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Added page size setting | |
299 | when creating PS Level 2. | |
300 | ||
301 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Fixed PS comment emitted when | |
302 | FlateDecode is being used. | |
303 | ||
304 | <li> <a href=./man/tiffsplit.1.html>tiffsplit</a>: increased the maximum | |
305 | number of pages that can be split. | |
306 | ||
307 | <li> <a href=./man/raw2tiff.1.html>raw2tiff</a>: Added option `-p' to | |
308 | explicitly select color space of input image data. | |
309 | ||
310 | <li> <a href=./man/tiffmedian.1.html>tiffmedian</a>: Suppiort for large | |
311 | (> 2GB) images. | |
312 | ||
313 | <li> <a href=./man/ppm2tiff.1.html>ppm2tiff</a>: Fixed possible endless loop. | |
314 | ||
315 | <li> <a href=./man/tiff2rgba.1.html>tiff2rgba</a>: Switched to use | |
316 | <A HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImageOriented()</A> | |
317 | instead of <A HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImage()</A>. | |
318 | ||
319 | <li> <a href=./man/tiffcmp.1.html>tiffcmp</a>: Fixed problem with unused data | |
320 | comparing (bug 349). `-z' option now can be used to set the number of reported | |
321 | different bytes. | |
322 | ||
323 | <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Added possibility to specify | |
324 | value -1 to -r option to get the entire image as one strip (bug 343). | |
325 | ||
326 | <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Set the correct RowsPerStrip | |
327 | and PageNumber values (bug 343). | |
328 | ||
329 | <li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Page numbering fixed (bug | |
330 | 341). | |
331 | ||
332 | <li> <a href=./man/ppm2tiff.1.html>ppm2tiff</a>: PPM header parser improved: | |
333 | now able to skip comments. | |
334 | ||
335 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Force deadzone printing when | |
336 | EPS output specified (bug 325). | |
337 | ||
338 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Add ability to generate | |
339 | PS Level 3. It basically allows one to use the /flateDecode filter for ZIP | |
340 | compressed TIFF images. Patch supplied by Tom Kacvinsky (bug 328). | |
341 | ||
342 | <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Fixed problem with colorspace | |
343 | conversion for JPEG encoded images (bugs 23 and 275) | |
344 | ||
345 | <li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Applied patch from | |
346 | Julien Gaulmin. More switches for fax2tiff tool for better control | |
347 | of input and output (bugs 272 and 293). | |
348 | ||
349 | <li> <a href=./man/raw2tiff.1.html>raw2tiff</a>: | |
350 | New utility for turning raw raster images into TIFF files | |
351 | written by Andrey Kiselev. | |
352 | ||
353 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: | |
354 | Sebastian Eken provided patches (bug 200) to add new these new | |
355 | switches: | |
356 | <ul> | |
357 | <li> <b>-b #</b>: for a bottom margin of # inches | |
358 | <li> <b>-c</b>: center image | |
359 | <li> <b>-l #</b>: for a left margin of # inches | |
360 | <li> <b>-r</b>: rotate the image by 180 degrees | |
361 | </ul> | |
362 | ||
363 | Also, new features merged with code for shrinking/overlapping. | |
364 | ||
365 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Don't emit BeginData/EndData | |
366 | DSC comments since we are unable to properly include the amount to skip | |
367 | as per bug 80. | |
368 | ||
369 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Added workaround for some | |
370 | software that may crash when last strip of image contains fewer number | |
371 | of scanlines than specified by the `/Height' variable as per bug 164. | |
372 | ||
373 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Patch from John Williams to add new | |
374 | functionality for tiff2ps utility splitting long images in several pages as | |
375 | per bug 142. New switches: | |
376 | <ul> | |
377 | <li> <b>-H #</b>: split image if height is more than # inches | |
378 | <li> <b>-L #</b>: overLap split images by # inches | |
379 | </ul> | |
380 | ||
381 | <li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: New commandline | |
382 | switches to override resolution units obtained from the input file per bug 131: | |
383 | <ul> | |
384 | <li> <b>-x</b>: override resolution units as centimeters | |
385 | <li> <b>-y</b>: override resolution units as inches | |
386 | </ul> | |
387 | ||
388 | <li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Updated to reflect | |
389 | latest changes in libtiff per bug 125. | |
390 | ||
391 | <li> tiff2ps: Division by zero fixed as per bug 88. | |
392 | ||
393 | <li> <a href=./man/tiffcp.1.html>tiffcp<a>: | |
394 | Added support for 'Orientation' tag. | |
395 | ||
396 | <li> <a href=./man/tiffdump.1.html>tiffdump</a>: | |
397 | include TIFFTAG_JPEGTABLES in tag list. | |
398 | ||
399 | <li> tiffset: fix bug in error reporting. | |
400 | ||
401 | </UL> | |
402 | ||
403 | <P><HR WIDTH=65% ALIGN=left> | |
404 | ||
405 | <!---------------------------------------------------------------------------> | |
406 | ||
407 | <A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> | |
408 | <UL> | |
409 | ||
410 | <li> Fixed distribution to include contrib/addtiffo/tif_ovrcache.{c,h}. | |
411 | <li> libtiff/contrib/win95: renamed to contrib/win_dib. Added new | |
412 | Tiffile.cpp example of converting TIFF files into a DIB on Win32 as per | |
413 | bug 143. | |
414 | ||
415 | </UL> | |
416 | ||
417 | <!---------------------------------------------------------------------------> | |
418 | ||
419 | <A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION | |
420 | KIT:</B></A> | |
421 | <UL> | |
422 | ||
423 | <li> LZW compression kit synchronized with actual libtiff version. | |
424 | ||
425 | </UL> | |
426 | ||
427 | <A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> | |
428 | ||
429 | <HR> | |
430 | ||
431 | Last updated $Date: 2003/10/04 11:38:17 $. | |
432 | ||
433 | </BODY> | |
434 | </HTML> |