265adfe60d865af8d6844b4a99d1ce681d818ec5
[imager.git] / Changes
1 Imager release history.  Older releases can be found in Changes.old
2
3  - PNG: treat a version mismatch between headers and library as a
4    probe failure.
5    https://rt.cpan.org/Ticket/Display.html?id=86659
6
7  - W32: add a missing head1 AUTHORS to the old Win32.pm
8    https://rt.cpan.org/Ticket/Display.html?id=86658
9
10 Imager 0.96_01 - 1 Jun 2013
11 ==============
12
13  - TIFF: handle SampleFormat = 2 by translating the signed integer
14    values to unsigned by flipping their sign bits.
15
16    Handle SampleFormat = 3 where possible.
17
18    SampleFormat is ignored for paletted images.
19
20    Mixed SampleFormat are handled incorrectly, since libtiff returns
21    only the first SampleFormat value, and an image with both an alpha
22    channel and SampleFormat = 2 for color channels probably has a
23    different SampleFormat for the alpha channel.
24
25    https://rt.cpan.org/Ticket/Display.html?id=74540
26
27  - XS clean up:
28      https://rt.cpan.org/Ticket/Display.html?id=69243
29
30    - Imager::Color's rgba() method now returns its values as integers
31      instead of floating point. (IV instead of NV).
32
33    - The XS for i_map() and i_matrix_transform() now use the AV *
34      typemap instead of rolling their own.
35
36    - The XS for DSO_call() now uses the HV * typemap instead of
37      rolling it's own.
38
39    - The XS for i_poly_aa(), i_poly_aa_cfill(), i_transform() and
40      i_gradgen() now use a new T_AVARRAY typemap that greatly
41      simplifies the XS code.
42
43    - many other minor XS changes
44
45    - some XS code formatting
46
47  - TT (Freetype 1.x) and FT2 (Freetype 2.x) non-antialiased rendering
48    now renders in alpha-combining mode, to match antialiased output.
49    https://rt.cpan.org/Ticket/Display.html?id=73359
50
51  - add sample code and cookbook notes for drawing a blurred drop-shadow.
52
53  - add support for libpng 1.6, which changed the defaults for
54    reporting some types of error.
55    https://rt.cpan.org/Ticket/Display.html?id=85746
56
57  - FT2: use gsamp/psamp() to transfer pixels from the work image to
58    the output image instead of gpix/ppix.
59    https://rt.cpan.org/Ticket/Display.html?id=83478
60
61  - eliminate various GCC warnings, mostly initialized but otherwise
62    unused variables.
63
64 Imager 0.96 - 19 May 2013
65 ===========
66
67  - rearrange Imager's test files.
68    https://rt.cpan.org/Ticket/Display.html?id=84596
69
70  - Imager::Probe::_gcc_lib_paths now forces C locale.
71    A sufficiently recent gcc prints localized keys for the search
72    paths, which avoids that localization.
73    https://rt.cpan.org/Ticket/Display.html?id=84963
74
75  - fix a pod error detected by Pod::Simple 3.27 and laterm and skip
76    pod tests unless AUTOMATED_TESTING or IMAGER_AUTHOR_TESTING is set
77    and true.
78    https://rt.cpan.org/Ticket/Display.html?id=85262
79    reported by Andreas König
80
81  - add a test for unclosed POD in C source, and fix the errors it
82    found.
83    https://rt.cpan.org/Ticket/Display.html?id=74875
84
85  - fix some spelling errors detected by the newer aspell in Debian
86    Wheezy.
87
88  - remove a trailing ' from lib/Imager/Font/Test.pm's POD
89    thanks to gregor herrmann <gregoa@debian.org>
90    https://rt.cpan.org/Ticket/Display.html?id=85413
91
92  - add a test for standard =head1 commands and fix the errors found
93
94 Imager 0.95 - 19 Apr 2013
95 ===========
96
97  - handle the SVf_UTF8 flag correctly on magic strings passed to
98    Imager::IO's write() and raw_write() methods.
99    This may misbehave in perl 5.6.x since the UTF8 flag may not be
100    visible in the main SV after SvGETMAGIC().
101    https://rt.cpan.org/Ticket/Display.html?id=83438
102
103  - document that bounding_box() ignores the transformation matrix
104    supplied to tranform() for fonts.
105    https://rt.cpan.org/Ticket/Display.html?id=84106
106
107 Imager 0.94_02 - 5 Apr 2013
108 ==============
109
110  - enable debug logging for the standard font tests
111
112  - skip the overloaded UTF-8 text output checks on 5.6.x and earlier,
113    due to a bug in that version of perl.
114
115  - don't test for read() failing on a write-only handle in 5.8.x and
116    earlier, this was fixed in change 862083f7e4 in perl.
117
118  - report the version of Inline found during testing (an attempt to
119    diagnose some intermittent failures.)
120
121 Imager 0.94_01 - 2 Mar 2013
122 ==============
123
124  - NOTE: possibly backward incompatible:
125    support reading from/writing to perl filehandes that aren't raw
126    files.
127
128    This allows Imager's I/O to honour handles with layers such as
129    gzip, scalar file handles or tied file handles.
130
131    This is backward incompatible in that previous Imager would simply
132    use fileno() to retrieve the fd for the file and call write(2) etc
133    on it directly.
134    https://rt.cpan.org/Ticket/Display.html?id=78843
135
136  - moved most of README to lib/Imager/Install.pod which should make it
137    more accessible to the "web" generation, also significantly updated
138    and re-worked it.
139
140  - updated README's for the separately distributed modules to refer to
141    Imager::Install, and that they need -dev versions of packages
142    https://rt.cpan.org/Ticket/Display.html?id=81265
143
144  - the JPEG test code now reports the compile-time library version
145
146  - avoid a possible compiler optimization issue on CentOS 5.9 i386 by
147    rearranging (and mildly optimizing) some code.
148    https://rt.cpan.org/Ticket/Display.html?id=83212
149
150  - fix a POD error in Imager::Fill (detected on new Pod-Simple)
151    https://rt.cpan.org/Ticket/Display.html?id=83434
152
153  - fix a broken link to Graphics::Magick
154    https://rt.cpan.org/Ticket/Display.html?id=82743
155
156  - drawing text to a channel with FT2 would draw with random coverage
157    due to an uninitialized alpha channel.
158
159  - marked the function pointer underlying the mm_log() API with the
160    correct gcc magic and fixed the resulting warnings.
161
162  - fixed some other compiler warnings
163
164  - Imager::Font::W32 now properly reports text drawing errors
165    https://rt.cpan.org/Ticket/Display.html?id=70098
166
167  - handle the SVf_UTF8 flag correctly on magic (eg. overloaded)
168    strings passed as text to draw(), bounding_box(), has_chars(),
169    glyph_names() (where supported) in each of the font drivers.
170    This may misbehave in perl 5.6.x since the UTF8 flag may not be
171    visible in the main SV after SvGETMAGIC().
172    https://rt.cpan.org/Ticket/Display.html?id=83438 (partial)
173
174 Imager 0.94 - 15 Dec 2012
175 =========================
176
177 Variations on some of these changes were included in development
178 releases.
179
180  - improved thread safety
181    - the internal error stack and log file handle are now in a per-thread
182      context object
183    - JPEG now captures IPTC information in a thread-safe way
184    - avoid globals where possible for warning capture in libtiff
185    - use a mutex to avoid re-entering thread-unsafe giflib
186    - use a mutex to avoid re-entering thread-unsafe tifflib
187    - use a mutex to avoid re-entering thread-unsafe T1Lib
188    - use a library handle per thread for freetype 2.
189    - use an engine handle per thread for freetype 1.x.
190    - originally these changes broke ABI compatibility, this has been
191      restored.
192
193  - clarify the return value of getpixel();
194    https://rt.cpan.org/Ticket/Display.html?id=81198
195
196  - fixed a race condition in parallel testing for T1
197
198  - fixed a bug in handling yoff for untransformed image-based fills
199
200  - documentation improvements for Imager::Fill
201
202  - FT2: report the library version while testing.
203
204 Imager 0.93 - 15 Oct 2012
205 ===========
206
207 Bug fixes:
208
209  - previously a transparency enabled GIF write (the default) would
210    always use a GIF89a header even if none of the images were
211    transparent.
212
213  - previously the probe step for freetype-config would fail on cygwin
214
215  - catch an invalid matrix parameter to convert() instead of crashing
216    https://rt.cpan.org/Ticket/Display.html?id=79922
217
218  - remove the 16-bit/sample limitation from the documentation for
219    setsamples(), it hasn't applied for many releases.
220    https://rt.cpan.org/Ticket/Display.html?id=79989
221
222  - don't copy setsamples() data parameter, it may be a large scalar
223    https://rt.cpan.org/Ticket/Display.html?id=79990
224
225  - clean up .dSYM directories generated performing probes on OS X
226    Mountain Lion.
227
228  - pass the --verbose command-line option through to Imager::Probe in
229    sub-module's Makefile.PLs
230    https://rt.cpan.org/Ticket/Display.html?id=75878
231
232 Enhancements:
233
234  - support for giflib 5.0. (5.0.1 and later)
235    https://rt.cpan.org/Ticket/Display.html?id=79029
236    The giflib API Imager uses doesn't have a mechanism to set the
237    header version in 5.0.0.
238
239  - update the GIF library probe code to check for the new giflib 5.0.1
240    EGifSetGifVersion() function, and to check for the giflib 4.2.0
241    uninitialized gif89 bug.
242    https://rt.cpan.org/Ticket/Display.html?id=79679
243    http://sourceforge.net/tracker/?func=detail&aid=3574283&group_id=102202&atid=631304
244
245  - avoid static variables when capturing IPTC data from JPEG files
246
247  - match Imager::Font;:T1's error message translations to those from
248    later versions of T1Lib.
249
250  - for libtiff versions that support extended warning handlers (3.8.0
251    or later), use them to avoid some global variables.
252
253  - note Image::ExifTool for better metadata support.
254    https://rt.cpan.org/Ticket/Display.html?id=79251
255
256 Imager 0.92 - 14 Aug 2012
257 ===========
258
259  - giflib 4.2 eliminates the GIF_LIB_VERSION macro, handle that
260    correctly for both probing and runtime.
261    https://rt.cpan.org/Ticket/Display.html?id=77672
262
263  - allow building JPEG/imexif.c on C89 compilers.
264
265  - allow building GIF/imgif.c on C89 compilers.
266
267 Imager 0.91 - 4 Jun 2012
268 ===========
269
270 Bug fixes:
271
272  - The size of rotated images is no longer rounded up so aggressively.
273    Added rounding to the linear interpolation done for rotate() and
274    matrix_transform() for 1 and 3 channel 8-bit images.
275    Adjusted the two tranlate matrices used to build the final rotation
276    matrix to use the distance between the outlier pixels rather than
277    the pixel dimensions (ie. dimension-1).
278    With all of this the output of rotate(degrees => 270) on an 8-bit
279    image exactly matches the output of rotate(right => 270).
280    https://rt.cpan.org/Ticket/Display.html?id=77063
281
282 Other changes:
283
284  - eliminate the old IIM_new(), IIM_DESTROY() names from Imager's
285    internals, those names only matter for the XS interface.
286
287  - improve error reporting when PERL_INITIALIZE_IMAGER_CALLBACKS finds
288    the API level compiled into a loadable module such as
289    Imager::File::GIF doesn't match that of Imager.  Previously it
290    could be difficult to determine exactly which module was failing to
291    load.
292    https://rt.cpan.org/Ticket/Display.html?id=77173
293
294  - added Imager->check_file_limits() as an interface to the
295    i_int_check_image_file_limits() API.
296
297  - Imager->set_file_limits(reset => 1) now resets the limits to the
298    defaults rather than setting them all to unlimited.
299
300  - wrote a brief security note as Imager::Security
301    https://rt.cpan.org/Ticket/Display.html?id=68910
302
303 Imager 0.90 - 30 Apr 2012
304 ===========
305
306 Bug fixes:
307
308  - Imager::Test::is_imaged() attempted to process an "epsilon"
309    parameter but the prototype didn't allow for the extra parameter.
310    Corrected the prototype.
311
312  - when downconverting samples (eg. from floating point to 8 bit)
313    Imager now rounds the sample value rather than attempting to
314    allocate input values over output values equally.  The old
315    behaviour had the probably surprising effect of converting a
316    floating point 2.1/255.0 into an 8-bit 3 rather than the expected
317    2.
318    This may result in slightly different 8 or 16-bit output images.
319
320  - BI_BITFIELD BMP images were handled incorrectly, both in
321    incorrectly calculating the space required for the masks and in
322    processing the image data itself.
323    https://rt.cpan.org/Ticket/Display.html?id=76736
324
325  - some odd width BMP BI_RLE4 images use run lengths that run one off
326    the edge of the image.  Imager now allows this, discarding the
327    extra column.
328
329  - odd length RLE4 runs in BMP images were decoded incorrectly.
330
331  - pkg-config could sometimes return a library that was in a directory
332    EU::MM / $Config{libpth} doesn't know about, but the compiler did.
333    If no -L is included in the pkg-config library information check if
334    EU::MM can find the library, and if not, search our configured
335    directories and insert that into the library flags.
336    https://rt.cpan.org/Ticket/Display.html?id=75869
337
338  - Imager::Probe can now probe for libraries with dependent libraries,
339    common for static linking, eg. libpng requires libz.
340    https://rt.cpan.org/Ticket/Display.html?id=74043
341
342  - libpng 1.5 specific probes were looking for libpng 1.4 filenames.
343
344  - added alternative probe configurations that try to link libz, to
345    handle a statically linked libpng.
346    https://rt.cpan.org/Ticket/Display.html?id=74043
347
348  - if a probe includes testcode, Imager::Probe now checks that code as
349    part of the process of checking each configuration rather than as a
350    post test of the found configuration.  This allows alternate
351    configurations to be checked if a matching but non-working
352    configuration is found.
353    https://rt.cpan.org/Ticket/Display.html?id=74043
354
355 Other changes:
356
357  - when reading or writing images via callbacks, the default callbacks
358    now push an error message indicating that a required callback was
359    called but not supplied.
360    https://rt.cpan.org/Ticket/Display.html?id=76782
361
362  - clarify which callbacks are required for reading and writing TIFF
363    images.
364
365  - improve logging for creation of callback I/O layers.
366
367  - a little more documentation for Imager::Probe.
368
369  - the i_get_file_background() and i_get_file_backgroundf() APIs now
370    return int to indicate whether the i_background tag was found.
371
372  - PNG rework
373    - improve error reporting
374    - add png_interlace, png_bits tags
375    - read paletted images as paletted images, including transparency
376    - read 1 bit greyscale images as a type suitable for other file
377      handlers to write as bilevel
378    - read 16 bit/sample PNG as 16-bit/sample Imager images
379    - write "bilevel" paletted images as 1 bit grayscale images
380    - write paletted images as paletted images
381    - write 16-bit (or higher)/sample images as 16-bit/sample PNG
382      images
383    - improved metadata support
384    https://rt.cpan.org/Ticket/Display.html?id=29268
385
386 Imager 0.89 - 18 Mar 2012
387 ===========
388
389 Bug fixes:
390
391  - getpixel(..., type => "float") and the API i_gpixf() have been
392    broken on paletted images since they were implemented.
393    https://rt.cpan.org/Ticket/Display.html?id=75258
394
395 Other changes:
396
397  - links in the METHOD INDEX now point at the method documentation
398    rather than the heading you can find them under.
399    https://rt.cpan.org/Ticket/Display.html?id=71495
400
401  - Imager (and the bundled dynamic modules) no longer fallback to
402    using DynaLoader if loading via XSLoader fails.
403    For the bundled modules this could hide useful error messages.
404    https://rt.cpan.org/Ticket/Display.html?id=75560
405
406  - IM_DEBUG_MALLOC mymalloc() no longer sn?printfs() a string to a
407    buffer in the array of allocations, but just stores the filename
408    pointer and line number.
409    https://rt.cpan.org/Ticket/Display.html?id=70388
410
411 Imager 0.88 - 22 Feb 2012
412 ===========
413
414  - describe how to build libgif etc on OS X in such a way as to be
415    compatible with a fat binary perl (such as the system perl), in
416    README.
417    https://rt.cpan.org/Ticket/Display.html?id=73371
418
419  - update the change notes for 0.77_01 to indicate that libungif
420    support was removed.
421
422  - add some other imaging modules to SEE ALSO
423    https://rt.cpan.org/Ticket/Display.html?id=73906
424
425  - note that the generator of the apparently non-DFSG-free postscript
426    in MMOne.pfb is a Debian package.
427
428  - setsamples() is now a true complement to getsamples() - it can
429    write 8-bit or floating point samples from a scalar or array
430    reference.  This adds i_psamp() and i_psampf() to the C level API.
431
432  - the XS interfaces to i_gsamp(), i_gsampf() and i_gsamp_bits() have
433    changed to make better use of the typemap, but these aren't part of
434    the perl level API anyway.  There were no changes to the C level
435    interfaces to these functions.
436
437  - getpixel() and setpixel() now accept a mix of scalar and array
438    references for the x and y parameters, and unequal array lengths is
439    no longer an error.
440    https://rt.cpan.org/Ticket/Display.html?id=73697
441
442 Bug fixes:
443
444  - correctly calculate the size of a rotated image
445    https://rt.cpan.org/Ticket/Display.html?id=69261
446
447  - fix incorrect rounding of color values for matrix_transform() and
448    rotate().
449    https://rt.cpan.org/Ticket/Display.html?id=69261
450
451  - Win32 text output is now done in normal combine mode, the alpha
452    component of the color is now significant.
453    https://rt.cpan.org/Ticket/Display.html?id=70014
454
455  - remove long unused gif case from read()
456    https://rt.cpan.org/Ticket/Display.html?id=69244 (partial)
457
458  - the getsamples() target parameter was being treated as a hashref
459    when it's meant to be an array reference.
460    https://rt.cpan.org/Ticket/Display.html?id=74882
461
462  - getpixel() and setpixel() now returns an empty list when invalid
463    parameters are supplied.
464    Invalid values for type now result in an error for getpixel().
465    https://rt.cpan.org/Ticket/Display.html?id=73697
466
467 Imager 0.87 - 03 Jan 2012
468 ===========
469
470  - document the return value of the filter() method.
471    https://rt.cpan.org/Ticket/Display.html?id=72369
472
473  - document i_gsamp_bits() and i_psamp_bits().
474    https://rt.cpan.org/Ticket/Display.html?id=68815
475
476  - properly increment the Imager::Matrix2d $VERSION.
477
478  - actually include the Imager::Test tests in the dist
479
480  - correctly read and write 256x256 pixel ICO files
481    https://rt.cpan.org/Ticket/Display.html?id=69599
482
483  - make the error message from read() or read_multi() when they can't
484    identify the file type match reality.
485    https://rt.cpan.org/Ticket/Display.html?id=72475
486
487  - read() now uses $FORMATGUESS if it can't determine the file type
488    based on the file header, to match read_multi().
489
490  - re-work and add tests for def_guess_type().  def_guess_type() no
491    longer returns any random file extension as the file type.
492
493  - add gray4, gray16 and gray as presets for make_colors.
494    https://rt.cpan.org/Ticket/Display.html?id=67911
495
496  - add make_palette() method that produces a palette from one or more
497    images.
498
499  - fix the Imager dependency for the separately distributed font
500    drivers.
501    https://rt.cpan.org/Ticket/Display.html?id=72643
502
503  - fix i_render_color() to properly draw in "normal" mode - ie. when
504    writing to a 1 or 3 channel image the second or fourth channel of
505    the source color was being ignored, it is now significant.
506    https://rt.cpan.org/Ticket/Display.html?id=71564
507
508 Imager 0.86 - 31 Oct 2011
509 ===========
510
511  - improve error reporting for W32 tests
512
513 Imager 0.85_02 - 24 Oct 2011
514 ==============
515
516 Bug fixes:
517
518  - eliminate unused i_gif_opts type (clean-up)
519    https://rt.cpan.org/Ticket/Display.html?id=69245
520
521  - fix combine=0 fill color anti-aliasing on the double/sample path
522    https://rt.cpan.org/Ticket/Display.html?id=71309
523
524  - make default text color non-transparent
525    https://rt.cpan.org/Ticket/Display.html?id=71469
526
527  - apply the last of the Debian unforwarded spelling fixes
528    https://rt.cpan.org/Ticket/Display.html?id=70656
529
530  - the log() method used its message parameter as a C level format
531    string.
532    https://rt.cpan.org/Ticket/Display.html?id=71653
533
534  - provide our own STRLEN typemap entry for older perls.
535    https://rt.cpan.org/Ticket/Display.html?id=71641
536
537  - add extra ppport.h configuration to support older perls.
538
539  - depend on Scalar::Util, since we use it and older perls don't have
540    it.
541
542  - add overloaded eq to Imager::Matrix2d, since older perls don't seem
543    to synthesize it from overloaded "".
544
545   - use T1_StrError() for error messages on modern libt1
546     https://rt.cpan.org/Ticket/Display.html?id=69879
547
548  - actually load the font rather than just adding it to the catalog on
549    creation.
550
551  - Imager::Font->new now produces better error messages for the T1
552    engine.
553
554  - the font has_chars() method now returns perl's true and false
555    values in list context rather than integers, which should be more
556    efficient.
557    https://rt.cpan.org/Ticket/Display.html?id=69158
558
559  - the btm data structure used by the flood_fill code is now
560    initialized more efficiently.
561    https://rt.cpan.org/Ticket/Display.html?id=68994
562
563  - updated the Thanks list in README
564    https://rt.cpan.org/Ticket/Display.html?id=71607
565
566  - check there's at least one coefficient for the convolution filter
567    https://rt.cpan.org/Ticket/Display.html?id=68993
568
569  - make the APIRef synopsis ordering consistent, older versions of
570    perl could order it differently.
571    https://rt.cpan.org/Ticket/Display.html?id=71675
572
573  - we rely on Config.pm's d_vsnprintf as to whether we use
574    vsnprintf/snprintf, which is defined in the Win32 Config.pm even
575    though it only has _ prefixed versions of these.  Define our own
576    prefixed names on Win32.
577    https://rt.cpan.org/Ticket/Display.html?id=71642
578
579  - fix library detection with MSVC
580
581  - search a few more library directories, so EU::MM doesn't discard
582    them.  Hopefully fixes:
583    https://rt.cpan.org/Ticket/Display.html?id=71643
584
585 Imager 0.85_01 - 10 Oct 2011
586 ==============
587
588  - add simple tests for the Imager::Test test_image generators
589
590  - io_glue I/O buffering re-work:
591
592    - reorganize io_glue to do it's own buffering by default
593
594    - the unbuffered functions are available as i_io_raw_read() (or
595      raw_read() from perl) etc but are not recommended for typical
596      use.
597
598    - use the new i_io_peekn() when checking for file magic to avoid
599      seek, allowing Imager to detect the file type and read the file
600      from an unseekable stream (for formats that don't use random
601      access)
602
603    - added several new I/O layer API functions.
604
605    - fix the TGA performance problem, most noticably on Win32
606      https://rt.cpan.org/Ticket/Display.html?id=70037
607
608    - TIFF now uses wrapper functions of the correct types to avoid casts
609      https://rt.cpan.org/Ticket/Display.html?id=69912
610
611    - the callback IO object did its own buffering, controlled by the
612      maxbuffer parameter supplied to the read() and write() methods.
613      This buffering has been removed, to avoid redundancy with the
614      common io_glue buffering.  This also avoids a bug in that code
615      which could rarely pass a zero length to the read callback and
616      then panic about the result.
617
618    - the callback IO object now tests the result of calling the close
619      callback, which should return true for success.
620
621    - the PNM reader did its own buffering.  This buffering has been
622      removed to avoid redundancy with the common io_glue buffering.
623
624    - previously the read handlers for fd and callback I/O layers would
625      call the underlying interface (POSIX read or your supplied callback)
626      until it filled the buffer.  It now only makes one call.
627
628    - added public constructors for I/O layer objects (see Imager::IO)
629
630    - all core file handlers now use the i_io_foo() wrappers to gain
631      access to buffered I/O rather than calling the I/O layer
632      callbacks directly.
633
634    - all core file handlers now check for error on close.
635
636    - Backward compatibility: if you hava custom file handlers, you can
637      use i_io_write() etc since they're available as macros in older
638      versions of Imager.
639
640    - eliminate the final remnants of io_glue_commit_types().
641
642    - bump IMAGER_API_VERSION, since the above may break assumptions.
643
644  - removed the long unused i_gen_reader() and i_gen_writer() utility
645    functions.
646
647 Imager 0.85 - 29 Aug 2011
648 ===========
649
650 The main changes in the release versus 0.84 are:
651
652  - on 64-bit systems, 64-bit types are consistently used for image
653    dimensions and co-ordinated, and for memory block sizes.
654
655  - handle IFD loops in TIFF files correctly.  Previously this would
656    lead to an infinite loop.
657
658 Bug fixes:
659
660  - fix the link in the getheight() entry in the method index
661
662 Imager 0.84_02 - 22 Aug 2011
663 ==============
664
665 Development release, this will become 0.85 if CPAN testers is
666 favourable.
667
668 Bug fixes:
669
670  - the image file limits set by set_file_limits() weren't being
671    checked when reading TIFF files.
672    https://rt.cpan.org/Ticket/Display.html?id=69915
673
674  - Provide more information about file format module load errors on a
675    failed image file read() or write().
676    https://rt.cpan.org/Ticket/Display.html?id=69194
677
678  - use TIFFReadDirectory() instead of TIFFSetDirectory() to iterate
679    through TIFF images, since it checks for IFD loops.
680    https://rt.cpan.org/Ticket/Display.html?id=69914
681
682  - don't leak memory when out of range palette indexes are supplied to
683    setscanline().
684    https://rt.cpan.org/Ticket/Display.html?id=69242
685
686  - require a later version of CPAN::Meta to ensure JSON::PP and
687    CPAN::Meta::YAML are available.
688    https://rt.cpan.org/Ticket/Display.html?id=69008
689
690  - hoist the per-line calculations for the flines implementations, and
691    modernize the tests a bit.
692    https://rt.cpan.org/Ticket/Display.html?id=70126
693
694  - detect snprintf()/vsnprintf() (cheat by using Config.pm) and use
695    them when available.
696    https://rt.cpan.org/Ticket/Display.html?id=69147
697
698  - if t1lib failed to reinitialize it would be left as marked
699    initialized.
700    https://rt.cpan.org/Ticket/Display.html?id=69877
701
702  - update the bundled (and still modified) Devel::CheckLib
703    https://rt.cpan.org/Ticket/Display.html?id=69170
704
705 Imager 0.84_01 - 8 Aug 2011
706 ==============
707
708 Development release as a sanity check for the types re-work.
709
710 Massive types re-work:
711
712  - the type used internally for pixel co-ordinates and image sizes is
713    now 64-bit on 64-bit platforms (at least sane ones).
714
715  - size_t is now used consistently for memory block sizes.
716
717  - since this changes the binary interface, the Imager API version has
718    been incremented.  Any module that uses the API will need to be
719    rebuilt.  In most cases that will be enough, but calls to any APIs
720    that take a pointer to image sizes may need source changes.
721
722  - you should be able to create very large images on 64-bit systems,
723    if you have enough memory.  Successfully created a 32768 x 49192 x
724    3 channel image, filled with a tiled image and scaled it.  The
725    unscaled image was also successfully saved to a JPEG.
726
727  - check the image size before attempting to write BMP, GIF, JPEG,
728    PNG, SGI, TGA, TIFF images.
729
730  - correctly handle reading TGA images over 32767 pixels wide or tall.
731
732 Incidental changes:
733
734  - the gif_left and gif_top tags are now clamped to non-negative
735    values when writing a GIF image.
736
737  - removed dead callback read/write code
738
739 The default maximum memory size when reading files is now 1G.
740
741 Imager 0.84 - 20 Jun 2011
742 ===========
743
744  - Imager no longer inherits from Exporter (unless you're running an
745    old, old perl.
746
747  - Imager can now write progressive JPEGs (it could always read them).
748    https://rt.cpan.org/Ticket/Display.html?id=68691
749
750 Bug fixes:
751
752  - re-work, document and test Imager's logging facility.
753    https://rt.cpan.org/Ticket/Display.html?id=65227
754
755  - fix META.yml testing and the generated META.yml
756    https://rt.cpan.org/Ticket/Display.html?id=65235
757
758  - test and add error reporting to to_*() family methods
759
760  - add to_rgb_double() method.
761    https://rt.cpan.org/Ticket/Display.html?id=65101
762
763  - Imager no longer exports anything by default
764    https://rt.cpan.org/Ticket/Display.html?id=65228
765
766  - convert colors to grayscale if the supplied (or generated) palette
767    contains only grays when performing error diffusion color
768    translation.
769    https://rt.cpan.org/Ticket/Display.html?id=68508
770
771  - writing a paletted image to GIF wouldn't always use the colors
772    supplied (or generated, eg. via make_colors => "mono"), which was
773    confusing at best.
774    https://rt.cpan.org/Ticket/Display.html?id=67912
775
776  - replace (imager|tony)@imager.perl.org in the doc, since I don't
777    plan to continue receiving mail at that address.
778    https://rt.cpan.org/Ticket/Display.html?id=68591
779
780 Imager 0.83 - 21 May 2011
781 ===========
782
783 Bug fixes:
784
785  - diag() the error message on failure for some TIFF tests that are
786    failing on a Solaris smoker.
787    http://www.cpantesters.org/cpan/report/6396db1e-8090-11e0-9682-112b785ebe45
788
789 Imager 0.82_01 - 17 May 2011
790 ==============
791
792 Dev release, in case the compose tests are too sensitive.
793
794 Bug fixes:
795
796  - Imager::Font::T1 incorrectly checked for absolute filename under
797    Win32.  Thanks to kmx for the report and fix.
798    https://rt.cpan.org/Ticket/Display.html?id=67963
799
800  - compose() with the target, source or mask position off the top or
801    left of the target image didn't clip the source image correctly.
802    https://rt.cpan.org/Ticket/Display.html?id=67220
803
804  - compose() now returns a useful error message on a non-positive
805    opacity.
806
807  - compose.im now at 100% test coverage. (As opposed to, umm, much,
808    much less.)
809
810 Imager 0.82 - 14 Mar 2011
811 ===========
812
813 Bug fixes:
814
815  - eliminate calls to i_has_format() from the test suite, since it's
816    no longer a useful way to check for file format support.  Eliminate
817    i_has_format() from the functions exposed via XS.
818    https://rt.cpan.org/Ticket/Display.html?id=65863
819
820  - eliminate calls to note(), which isn't in the (very old) version of
821    Test::More we have as a pre-requisite.  note() is modern enough
822    that I don't feel a need to require a Test::More upgrade for it.
823    https://rt.cpan.org/Ticket/Display.html?id=65864
824
825  - skip the threads tests on Test::More 2.00_*
826    https://rt.cpan.org/Ticket/Display.html?id=65812
827
828  - add an (unshipped) test to check Imager's internal POD links
829    https://rt.cpan.org/Ticket/Display.html?id=65749
830
831  - improve the library detection summary
832    https://rt.cpan.org/Ticket/Display.html?id=9675
833
834  - increase the version of Imager::Font::Type1 so that upgrades don't
835    downgrade the version in this file.
836    https://rt.cpan.org/Ticket/Display.html?id=66250
837
838  - if we see an -rpath (or -R) option in $Config{lddlflags} supply
839    that option for the directories that would normally go in
840    LD_RUN_PATH.  Typically an explicit -rpath overrides LD_RUN_PATH.
841    https://rt.cpan.org/Ticket/Display.html?id=65955
842
843 Imager 0.81 - 14 Feb 2011
844 ===========
845
846  - added coverage tests for masked images (maskimg.c @100% test coverage)
847
848  - add hsv() method to Imager::Color
849    Thanks to Leolo (Philip Gwyn)
850    https://rt.cpan.org/Ticket/Display.html?id=65385
851
852  - split libt1 Type 1 font support into a sub-module
853    https://rt.cpan.org/Ticket/Display.html?id=49616 (partial)
854
855  - add a preload() class method for use in forking servers, and to
856    work around limitations in PAR.
857    https://rt.cpan.org/Ticket/Display.html?id=65665
858
859 Bug fixes:
860
861  - paletted writes to a masked image are now masked correctly.
862    Revealed by new coverage tests.
863
864  - update the filter plugin documentation.
865    https://rt.cpan.org/Ticket/Display.html?id=56513
866
867  - add the matrix() method to Imager::Matrix2d to allow creation of a
868    matrix with specified co-efficients.  You can now multiple an
869    Imager::Matrix2d object by a 9 element array ref or a number.
870    https://rt.cpan.org/Ticket/Display.html?id=29938
871
872  - really fix loading TTF fonts with FT2 when FT1 isn't available.
873    Thanks to Leolo (Philip Gwyn)
874    https://rt.cpan.org/Ticket/Display.html?id=65386
875    https://rt.cpan.org/Ticket/Display.html?id=62855
876
877  - make sure each test script that needs testout/ creates it.
878    https://rt.cpan.org/Ticket/Display.html?id=65088
879
880  - handle a slightly different warning from libtiff 4.x
881    https://rt.cpan.org/Ticket/Display.html?id=65268
882
883  - the sat transform2() op returned an incorrect saturation.
884    https://rt.cpan.org/Ticket/Display.html?id=65391
885
886 Imager 0.80 - 17 Jan 2011
887 ===========
888
889  - added coverage tests for Imager::Fountain and Imager::Color::Float
890
891  - Imager is now maintained in git
892    http://git.imager.perl.org/imager.git
893    git://git.imager.perl.org/imager.git
894
895 Bug fixes:
896
897  - images with an translucent alpha channel were not scaled correctly
898    by the default (qtype=normal) scaling method.
899    https://rt.cpan.org/Public/Bug/Display.html?id=63922
900
901  - Imager::Color::Float now translates "#FFFFFF" to white instead of
902    just a little darker.
903
904  - make the default color map build algorithm "mediancut".  This
905    changes the default color map builder for writing GIFs back to what
906    it was in 0.77, reverting a performance regression.
907    https://rt.cpan.org/Ticket/Display.html?id=64785
908
909  - handle failure to create a masked image correctly
910
911 Imager 0.79 - 10 Dec 2010
912 ===========
913
914  - add Imager::Test to the POD coverage tests and document the missing
915    functions.
916
917  - the convert() method now optimizes the case where all output
918    channels are either 0, sourced from a single input channel or 1.
919    This significantly speeds up presets like "addalpha", "green".
920    https://rt.cpan.org/Ticket/Display.html?id=51254
921
922  - add wiggle.pl sample, as suggested by Dan Oppenheim.
923
924  - add the combine() method to combine channels from multiple source
925    images into a new image
926    https://rt.cpan.org/Ticket/Display.html?id=11872
927
928 Bug fixes:
929
930  - treat the co-efficients for convert() as doubles instead of floats.
931
932  - If a higher (earlier) priority font handler failed to load, that
933    would crash preventing loading of later font handlers.
934    https://rt.cpan.org/Ticket/Display.html?id=62855
935
936  - parse defines from the options returned by pkg-config --cflags
937    https://rt.cpan.org/Ticket/Display.html?id=63223
938
939  - a regen of the MANIFEST revealed that GIF and FT2 tests weren't
940    included in the tarball.  They are now included.
941
942 Imager 0.78 - 4 Oct 2010
943 ===========
944
945 Bug fixes:
946
947  - don't access deprecated members of the png_structp.
948    https://rt.cpan.org/Ticket/Display.html?id=60242
949
950  - document that using color objects is faster than supplying colors
951    by name, etc.
952    https://rt.cpan.org/Ticket/Display.html?id=61047
953
954  - Imager::Probe now accepts array references for incpath and libpath.
955    https://rt.cpan.org/Ticket/Display.html?id=60244
956
957 Imager 0.77_02 - 27 Sep 2010
958 ==============
959
960  - moved Win32, FreeType 2 font support into sub-modules.
961    https://rt.cpan.org/Ticket/Display.html?id=49616 (partial)
962    Uses Imager::Probe now.
963    https://rt.cpan.org/Public/Bug/Display.html?id=61328
964
965  - tested successfully with jpeg-8b
966    https://rt.cpan.org/Ticket/Display.html?id=60221
967
968 Bug fixes:
969
970  - from _01: look for missing file support test files in the right
971    places.
972
973  - flood_fill() wouldn't fill the right side of a single scan-line
974    fill area.
975    Thanks to Nicolas Roggli for reporting this.
976
977  - flood_fill wouldn't fill to the left edge of the image if the
978    starting line didn't reach the left edge.
979    Thanks to Nicolas Roggli for reporting this.
980
981 Imager 0.77_01 - 13 Sep 2010
982 ==============
983
984  - add each library-directory/pkgconfig/ to the pkg-config search path
985    in Imager::Probe.
986    Thanks to Justin Davis.
987    https://rt.cpan.org/Ticket/Display.html?id=60491
988
989  - moved GIF, TIFF, JPEG file handling code into sub-modules in
990    preparation for separate distribution.
991    https://rt.cpan.org/Ticket/Display.html?id=49616 (partial)
992
993    Note: this removed support for libungif from Imager.
994
995  - optimize filled box drawing (color, not fill)
996
997 Bug fixes:
998
999  - Imager::Probe was calling ExtUtils::Liblist to initialize
1000    LD_RUN_PATH supplying an undefined value rather than the found
1001    directory.  Thanks to Justin Davis.
1002    https://rt.cpan.org/Ticket/Display.html?id=60491
1003
1004  - only prepend ./ to font filenames when passing them to T1Lib and
1005    then only when it would use its search mechanisms.
1006    https://rt.cpan.org/Ticket/Display.html?id=60509
1007
1008  - fix the cache check for the X rgb.txt loader.  This is typically
1009    used for color translation on Unix-like systems, and the fix
1010    improves performance of supplying colors by name by about 80 times.
1011    Test code that managed 3400 10x10 pixel boxes/second sped up to
1012    25700 boxes/second.
1013
1014  - clarify that Imager doesn't write EXIF metadata to images.
1015    https://rt.cpan.org/Ticket/Display.html?id=60637
1016
1017  - Imager::Probe can now search subdirectories under its include path.
1018    Used by the PNG Makefile.PL to find headers and libraries when they
1019    aren't in the base directory, as in cygwin.
1020    https://rt.cpan.org/Ticket/Display.html?id=60635
1021
1022 Imager 0.77 - 11 Aug 2010
1023 ===========
1024
1025 I don't want Imager::File::PNG indexed as part of Imager, but forgot
1026 to update the META.yml before updating the version.
1027
1028  - don't index Imager::File::PNG as part of Imager
1029
1030  - add resources to META.yml
1031
1032 Imager 0.76 - not released
1033 ===========
1034
1035 Bug fixes:
1036
1037  - the align_string() method would ignore a string of "0" due to a
1038    mis-use of C< ||= >.
1039    Thanks to Maurice Height for reporting this.
1040    https://rt.cpan.org/Ticket/Display.html?id=60199
1041
1042 Imager 0.75_03 - 09 Aug 2010
1043 ==============
1044
1045 Bug fixes:
1046
1047  - read_types() and write_types() would include png when it wasn't
1048    available due to a problem with the %formats tie
1049
1050  - handle dependent libraries correctly (eg -lpng requiring -lz) in
1051    the code run phase of library probing.
1052
1053 Imager 0.75_02 - 07 Aug 2010
1054 ==============
1055
1056 Bug fixes:
1057
1058  - add file missing from MANIFEST, which was causing TIFF failures.
1059
1060 Imager 0.75_01 - 06 Aug 2010
1061 ==============
1062
1063 Test release for the new PNG probe.
1064
1065  - added the ability to read multiple-image PNM files.
1066    Note that unlike the pbm/pgm/ppm specification this accepts mixed
1067    format files and allows white space padding between files.
1068    Thanks to Philip Gwyn (Leolo) for this patch.
1069
1070  - moved the PNG file handling code into a sub-module in preparation
1071    for separate distribution.
1072    https://rt.cpan.org/Ticket/Display.html?id=49616 (partial)
1073    Also helps avoid complications from -I/-L compile/link options from
1074    other libraries.
1075
1076 Bugs:
1077
1078  - Imager->new(data => $data) didn't try to process image file data in
1079    $data
1080    https://rt.cpan.org/Ticket/Display.html?id=58761
1081
1082  - t/t50basicoo.t no longer depends on the other tests to generate its 
1083    input files.
1084    https://rt.cpan.org/Ticket/Display.html?id=9798
1085    Also, it wasn't testing pnm (pnm vs ppm mix-up)
1086
1087  - update the documentation of hardinvert to match the change in 0.62.
1088    https://rt.cpan.org/Ticket/Display.html?id=59785
1089
1090  - added hardinvertall filter which also inverts the alpha channel
1091    (sorry for the mess)
1092
1093  - when probing for TIFF, set LD_RUN_PATH just as the Makefile does so
1094    the probe can find the library for the test run.
1095    https://rt.cpan.org/Ticket/Display.html?id=57518
1096
1097 Imager 0.75 - 20 Jun 2010
1098 ===========
1099
1100  - use PERL_NO_GET_CONTEXT to slightly improve performance on threaded
1101    perls (not measured)
1102
1103 Bugs:
1104
1105  - an opacity fill based on a fountain fill would segfault when
1106    filling an 8-bit/sample image.
1107
1108  - merge thickline branch polygon fix
1109    https://rt.cpan.org/Ticket/Display.html?id=43518
1110
1111 Imager 0.74 - 7 May 2010
1112 ===========
1113
1114 Bug fixes:
1115
1116  - read_multi() didn't handle a missing file format library correctly,
1117    aborting on failing to call i_readgif_multi_wiol() or
1118    i_readtiff_multi_wiol().
1119
1120  - fix spelling errors patched by Debian
1121    http://svn.debian.org/viewsvn/pkg-perl/trunk/libimager-perl/debian/patches/spelling.patch?revision=54839&view=markup
1122
1123  - add an (unshipped) author test to spellcheck Imager's POD.
1124
1125  - update the TIFF file format documentation
1126    https://rt.cpan.org/Ticket/Display.html?id=56510
1127
1128  - lib/Imager/IO.pod was written almost 4 years ago but never shipped.
1129
1130 Imager 0.73 - 15 Mar 2010
1131 ===========
1132
1133  - implement outline circles, both anti-aliased and not
1134    https://rt.cpan.org/Ticket/Display.html?id=19755
1135
1136  - a combine => "none" fill to a 1 or 3 channel image would produce
1137    the incorrect colour.
1138
1139 Imager 0.72 - 09 Dec 2009
1140 ===========
1141
1142 Bump version for release, since 0.71_03 is stable with CPAN testers.
1143
1144 Imager 0.71_03 - 5 Dec 2009
1145 ==============
1146
1147  - further adjust the threads test so it only performs the tests on
1148    perls where it's expected to work, and only if the threads module
1149    can be loaded.
1150
1151 Imager 0.71_02 - 1 Dec 2009
1152 ==============
1153
1154  - adjust the way we load the threads module for the threads test so
1155    it works with non-threaded perls
1156
1157 Imager 0.71_01 - 30 Nov 2009
1158 ===========
1159
1160 Bug fixes:
1161
1162  - use scanline oriented operations to flip images instead of pixel
1163    operations
1164    https://rt.cpan.org/Ticket/Display.html?id=39278
1165
1166  - use double/sample operations to flip large sample images instead of
1167    8-bit sample operations.
1168    https://rt.cpan.org/Ticket/Display.html?id=39280
1169
1170  - fix POD nits
1171    https://rt.cpan.org/Ticket/Display.html?id=51874
1172
1173  - prevent double-frees when someone creates Imager objects and then
1174    creates a thread.  Note: this just handles some simple cases,
1175    Imager doesn't support perl threads, and isn't likely to.
1176    https://rt.cpan.org/Ticket/Display.html?id=52268
1177
1178 Imager 0.71 - 16 Nov 2009
1179 ===========
1180
1181  - add the opacity fill type - an adaptor that modifies the opacity of
1182    another fill.
1183
1184 Bug fixes:
1185
1186  - the conv filter now enforces that the sum of the coefficients is
1187    non-zero.  Also, rather than skipping pixels off the edge off the
1188    edge of the image, the closest edge pixel is used.  Previously
1189    dividing by the zero sum of coefficients could cause invalid
1190    results or runtime exceptions.
1191    Thanks to David Cantrell's Alpha-NetBSD CPAN test box for revealing
1192    this bug.
1193
1194 Imager 0.70 - 21 Sep 2009
1195 ===========
1196
1197 Bug fixes:
1198
1199  - release image row and comments memory on all error returns in gif
1200    reader
1201
1202  - handle zero length extensions, previously this would cause a null
1203    pointer dereference
1204    Thanks to Krzysztof Wojtaś for the test data and fix for this.
1205
1206  - an integer division meant that preview scaling to below 1 pixel
1207    wide or high (which isn't too useful anyway) was calculating using
1208    NaNs on most platforms, and causing an exception on others.
1209    Thanks to David Cantrell for producing a backtrace of the crash on
1210    his Alpha-NetBSD CPAN test box which made it possible to track this
1211    down.
1212
1213 Imager 0.69 - 08 Sep 2009
1214 ===========
1215
1216 Bug fixes:
1217
1218  - broken test fix - was attempting to call a function skip_all, when
1219    that should be a parameter to plan().
1220
1221  - briefly document apidocs.perl, the tool used to build
1222    Imager::APIRef and make some minor enhancements
1223
1224  - various minor documentation enhancements and fixes.
1225
1226 Imager 0.68 - 07 Sep 2009
1227 ===========
1228
1229  - Imager->new(file => $filename) and other similar incantations will
1230    load the given file.
1231    https://rt.cpan.org/Ticket/Display.html?id=48261
1232
1233 Bug fixes:
1234
1235  - avoid using CHECK as a label in Imager::Test
1236    http://nntp.x.perl.org/group/perl.cpan.testers/5220921
1237
1238  - re-work most image file test files that require a library into
1239    separate library present/not present files to remove stupidly long
1240    conditionals
1241
1242  - don't treat rubthrough() outside the bounds of the target image as
1243    an error.
1244    http://nntp.x.perl.org/group/perl.cpan.testers/5185716
1245
1246 Imager 0.67_01 - 02 Sep 2009
1247 ==============
1248
1249 Bug fixes:
1250
1251  - correct documentation of default of raw image interleave read
1252    parameter
1253    https://rt.cpan.org/Ticket/Display.html?id=42074
1254
1255  - add raw_ prefix to raw read parameters, though the original names
1256    still work.
1257
1258  - fail the read if an invalid raw_interleave parameter is supplied
1259
1260  - warn if no interleave or raw_interleave parameter is supplied,
1261    since the documented default was wrong, and incompatible with the
1262    write format
1263
1264  - for reading raw images, if raw_storechannels > raw_datachannels,
1265    set the extra channels in the image to 0
1266
1267  - when probing for executables like freetype-config, search for .bat
1268    and .cmd on MSWin32, as well as .exe.
1269    https://rt.cpan.org/Ticket/Display.html?id=49275
1270
1271  - re-work the external libraries section of README:
1272    - list Debian and Redhat package names for each library
1273    - reformatting
1274    - update URLs
1275
1276  - use the new EU::MM META_MERGE facility instead of generating
1277    META.yml from scratch
1278    https://rt.cpan.org/Ticket/Display.html?id=47888
1279
1280  - use Devel::CheckLib (bundled, modified) to check which release of
1281    libtiff is installed and reject 3.9.0
1282    http://bugzilla.maptools.org/show_bug.cgi?id=2088
1283    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=543079
1284
1285 Imager 0.67 - 12 Dec 2008
1286 ===========
1287
1288 Bug fixes:
1289
1290  - fix a packaging error
1291
1292 Imager 0.66 - 12 Dec 2008
1293 ===========
1294
1295  - 24-bit color .ICO/.CUR files can now be read.
1296
1297 Bug fixes:
1298
1299  - an optimization skipping 0 src alpha values could cause the
1300    rubthrough() to read past the end of a buffer.
1301    http://www.nntp.perl.org/group/perl.cpan.testers/2008/05/msg1509184.html
1302
1303  - corrected a reference leak where writing GIFs would leak memory.
1304    This could also happen calling to_paletted().
1305    Also documented the underlying long existing feature where the
1306    colors parameter is filled with the generated color table and added
1307    tests for it.
1308    http://rt.cpan.org/Ticket/Display.html?id=41028
1309
1310  - write out the image size in bytes field of a BMP correctly.
1311    http://rt.cpan.org/Ticket/Display.html?id=41406
1312
1313  - add limited tests for Imager::ExtUtils
1314
1315  - make Imager::ExtUtils->includes use an absolute path, since
1316    a relative path could cause failures using Inline::C.
1317    http://rt.cpan.org/Ticket/Display.html?id=37353
1318
1319  - re-arrange the POD for Imager::Font::BBox:
1320    - mark total_width(), pos_width(), end_offset() obsolete, since
1321      they're mostly for backwards compatibility
1322    - group width methods and height methods
1323    https://rt.cpan.org/Ticket/Display.html?id=39999
1324
1325 Imager 0.65 - 20 May 2008
1326 ===========
1327
1328 Bug fixes:
1329
1330  - In some cases when an error occurs reading those parts of a JPEG
1331    file after the image the scan-line buffer could be freed a second
1332    time.  In cases where the the error occured while reading the image
1333    data it's possible that the buffer could have leaked.
1334    Thanks to Gabriel Vasseur for reporting this and help in tracking
1335    it down.
1336
1337  - the gif_screen_height tag was overriding the screen width and being
1338    ignored for the screen height when present.
1339    https://rt.cpan.org/Public/Bug/Display.html?id=35568
1340
1341 Imager 0.64 - 23 April 2008
1342 ===========
1343
1344 This is a bug fix release.  This includes a fix for a possible
1345 security issue.
1346
1347 Bug fixes:
1348
1349  - Possible security issue: The floating point sample path for image
1350    based fills had a buffer overflow.  This would overwrite the end of
1351    a malloc()ed buffer with double precision floats.
1352    http://rt.cpan.org/Ticket/Display.html?id=35324
1353    CVE-2008-1928
1354
1355  - check that the result of fileno($fh) is defined rather than simply
1356    true when read() or write() is supplied with an fh parameter.
1357    http://rt.cpan.org/Ticket/Display.html?id=35139
1358
1359  - i_scale_axis() wasn't checking the result of i_img_new_ch()
1360    resulting in a SIGSEGV when attempting to scale an image to a size
1361    too large to fit in memory.  This is a NULL pointer access issue,
1362    not a buffer overflow.
1363    Added a check for the failure.
1364    scale_calculate() (and hence scale()) will now fail if any of the
1365    scale size parameters are a reference.
1366    http://rt.cpan.org/Ticket/Display.html?id=35172
1367
1368  - Regression: filling a greyscale image with a hatch used the wrong
1369    color channels from the supplied fg/bg colors.
1370    https://rt.cpan.org/Ticket/Display.html?id=35278
1371
1372  - fixed a related problem for image fills.
1373
1374 Imager 0.63 - 7 April 2008
1375 ===========
1376
1377 This release primarily contains changes to improve ease of use -
1378 rather than you having to convert images to the appropriate number of
1379 channels, Imager handles it internally.  How to handle drawing colors
1380 and the default combine mode is a thornier problem left for some other
1381 release.
1382
1383  - the font libraries are now only initialized when needed.
1384    http://rt.cpan.org/Ticket/Display.html?id=28825
1385
1386  - moved the imtoc.perl code into Imager::Preprocess
1387
1388  - paste() and rubthrough() now adapt the source image data to the
1389    destination, so you can now safely paste/rubthrough from greyscale
1390    images to color images or back, or from alpha channel images to
1391    noalpha channels or back.
1392    https://rt.cpan.org/Ticket/Display.html?id=30908
1393
1394  - rubthrough() now falls back to pasting when the source doesn't have
1395    an alpha channel.  This effectively treats the source as having a
1396    max alpha channel, the right thing to do.
1397    http://rt.cpan.org/Ticket/Display.html?id=29944
1398
1399  - re-worked most of the area filling code to use a common set of
1400    functions when filling.
1401    Corrected normal combine mode.
1402    Rewrote most of the combine modes to match the way the SVG draft
1403    defines them with respect to a translucent source and destination.
1404    Added tests for translucent source and destination.
1405    Added tests to check 8-bit/sample and double/sample combines work
1406    similarly.
1407    https://rt.cpan.org/Ticket/Display.html?id=29879
1408
1409  - writing a 2 or 4 channel image to a JPEG file will now write that
1410    image as if composited against a background, black by default,
1411    overridable with the i_background tag/parameter.
1412    https://rt.cpan.org/Ticket/Display.html?id=29876
1413
1414  - writing a 2 or 4 channel image to a PGM/PPM file will now write
1415    that image as if composited against a background, black by default,
1416    overridable with the i_background tag/parameter.
1417    http://rt.cpan.org/Ticket/Display.html?id=30074
1418
1419  - writing a 2 or 4 channel image to a BMP file will now write that
1420    image as if composited against a background, black by default,
1421    overridable with the i_background tag/parameter.
1422    http://rt.cpan.org/Ticket/Display.html?id=30075
1423
1424 Bug fixes:
1425
1426  - Imager::Matrix2d->translate() now only requires one of the x or y
1427    parameters.
1428    http://rt.cpan.org/Ticket/Display.html?id=29937
1429
1430  - mixing qtype scaling now sets all channels of a pixel to zero if
1431    the pixel has zero coverage (zero alpha).  This should produce more
1432    compressible output files.
1433    http://rt.cpan.org/Ticket/Display.html?id=32324
1434
1435  - removed the pointless #! line from lib/Imager/Font/Wrap.pm
1436    Noticed when I saw:
1437    https://bugzilla.redhat.com/show_bug.cgi?id=166254
1438    I'm not changing the #! lines of the sample code, since it's sample
1439    code, not intended for installation.
1440    http://rt.cpan.org/Ticket/Display.html?id=33408
1441
1442  - some TGA images weren't being detected correctly as TGA images
1443    https://rt.cpan.org/Ticket/Display.html?id=32925
1444
1445  - handling of the left-over bit for 16-bit/pixel TGA images has been
1446    changed to match the behaviour of the GIMP.  Previously the bit
1447    being set was treated as an opaque pixel, but one user reported a
1448    problem with loading such an image.  I haven't been able to find any
1449    tools beyond the GIMP that handle alpha-channel 16-bit TGAs, so
1450    I'll match it's behaviour.  See issue 114913 in the GIMP's
1451    bugzilla.
1452    http://rt.cpan.org/Ticket/Display.html?id=32926
1453
1454 Imager 0.62 - 10 December 2007
1455 ===========
1456
1457  - Makefile.PL now expands ~/path supplied to --incpath or --libpath
1458    to /path under your home directory.
1459    http://rt.cpan.org/Ticket/Display.html?id=29484
1460
1461  - the old dynaload code used Mach API functions to load dynamic
1462    libraries on Mac OS X.  These APIs have been deprecated in OS X
1463    10.5 and were causing some build problems.
1464    So henceforth Imager uses the dlopen() family of functions, and you 
1465    will need version 10.3 or later of OS X.
1466
1467  - added the det() function to the transform2() engine.
1468    added the sample quad_to_square.pl
1469    Courtesy Richard Fairhurst.
1470    http://rt.cpan.org/Ticket/Display.html?id=31244
1471
1472 Bug fixes:
1473
1474  - samples/gifscale.pl sourced the base value for gif_top from
1475    gif_left.
1476    Thanks to Eleneldil G. Arilou for pointing this out.
1477
1478  - t/t82inline.t no longer loads B at runtime, to work around a bug
1479    in some 5.005_0[45] installations.
1480    http://rt.cpan.org/Ticket/Display.html?id=30508
1481
1482  - work around Module::Depends::Intrusive bug #21229
1483    http://rt.cpan.org/Ticket/Display.html?id=30520
1484
1485  - the hardinvert filter no-longer inverts the alpha channel.
1486    http://rt.cpan.org/Ticket/Display.html?id=30002
1487
1488  - the hardinvert filter now supports large samples
1489
1490 Imager 0.61_02 - 28 November 2007
1491 ==============
1492
1493  - major TIFF support re-work
1494    http://rt.cpan.org/Ticket/Display.html?id=20329
1495
1496  - added a C level image interface for accessing samples from 1-32
1497    bits, exposed this at the perl level in getsamples()
1498
1499  - the conv filter now works at floating point precision for high bit
1500    images
1501
1502  - added is_bilevel method to test whether an image should be written as
1503    a bilevel image if the image format supports it.
1504
1505  - added -log-stderr as an Imager import list option
1506
1507  - added some important types to Imager::APIRef
1508
1509  - added test_image_double() to Imager::Test
1510
1511 Bug fixes:
1512
1513  - Imager::Fountain couldn't read GIMP gradient files with 10 or more
1514    segments
1515
1516  - the scale() method with qtype mixing now handles images with an
1517    alpha channel correctly.
1518
1519  - fixed a broken link from the "animated GIF" entry in the concept index.
1520    Thanks to Slaven Rezic.
1521    http://rt.cpan.org/Ticket/Display.html?id=30889
1522
1523  - on some perl's the infix expression parser test would fail due to
1524    actions in the grammar returning false.  Made sure all actions return
1525    a true value.
1526    Thanks to Richard Fairhurst for spending a lot of time in tracking
1527    down this problem.
1528    http://rt.cpan.org/Public/Bug/Display.html?id=29562
1529
1530 Imager 0.61 - 5 November 2007
1531 ===========
1532
1533  - added samples/gifscale.pl, which adjusts the screen size/position tags
1534    when scaling an animated gif
1535    http://rt.cpan.org/Ticket/Display.html?id=27591
1536
1537 Bug fixes:
1538
1539  - correct handling of sz in matrix_transform() - this should allow
1540    perspective type transformations to work now.
1541    http://rt.cpan.org/Ticket/Display.html?id=29936
1542
1543  - prevent a cast to integer warning on x64 builds in datatypes.c
1544    also fixed some other type warnings
1545    https://rt.cpan.org/Ticket/Display.html?id=30204
1546
1547  - some sub-directory tests depended on files produced by the parent
1548    directory tests
1549    http://rt.cpan.org/Ticket/Display.html?id=30203
1550
1551  - Imager::Font::Wrap doesn't correctly set savepos
1552    thanks to Nikita Dedik and Eleneldil G. Arilou for reporting this.
1553    http://rt.cpan.org/Ticket/Display.html?id=29771
1554
1555  - test 171 in t/t01introvert.t was failing on perls configured to
1556    use long double.
1557    http://rt.cpan.org/Ticket/Display.html?id=29413
1558
1559  - the code for the transform2() uminus operator was missing a break.
1560    Added tests for better code coverage of the ops.
1561    http://rt.cpan.org/Ticket/Display.html?id=29296
1562
1563  - the SGI RLE compression code could overflow its compression buffer
1564    http://rt.cpan.org/Ticket/Display.html?id=30334
1565
1566  - the 32-bit output function used by the SGI code only handled values
1567    under 0x10000.  This was most noticable when writing large RLE images.
1568    http://rt.cpan.org/Ticket/Display.html?id=30335
1569
1570  - validate chan_count for chans == NULL for each of the i_gsamp()
1571    implementations.
1572    http://rt.cpan.org/Ticket/Display.html?id=28985
1573
1574  - attempt to work around the test failure at 
1575    http://www.nntp.perl.org/group/perl.cpan.testers/2007/09/msg650810.html
1576    http://rt.cpan.org/Ticket/Display.html?id=29562
1577
1578  - improve the error messages produced when attempting to read or write
1579    an unknown image file format.
1580    http://rt.cpan.org/Ticket/Display.html?id=30103
1581
1582  - improve the transform2() documentation
1583    http://rt.cpan.org/Ticket/Display.html?id=29267
1584
1585  - correctly generate the author key in META.yml
1586    http://rt.cpan.org/Ticket/Display.html?id=30377
1587
1588  - correctly blend a rotated (or matrix_transformed()) image when
1589    performing interpolation in the presence of an alpha channel.
1590    Also corrected the centring of the rotated image on the output
1591    image.
1592
1593 Imager 0.60 - 30 August 2007
1594 ===========
1595
1596  - Finished/rewrote Arnar's old SGI RGB file format support, so Imager
1597    now has full SGI RGB image format, including RLE and 16-bit/sample
1598    images.
1599    https://rt.cpan.org/Ticket/Display.html?id=8666
1600
1601  - logging functions are now available in the API
1602
1603  - applied Gabriel Vasseur's patch
1604    added documentation, further tests, and support for greyscale images
1605    Obviously problems are my fault :)
1606    https://rt.cpan.org/Ticket/Display.html?id=28142
1607
1608  - the mask for ICO/CUR images is now applied as an alpha channel to
1609    the returned image.  For the old behaviour, supply ico_masked => 0
1610    to read() or read_multi().  This should be less confusing when
1611    using Imager as a general image processor.
1612    https://rt.cpan.org/Ticket/Display.html?id=29001
1613
1614 Bug fixes:
1615
1616  - in some cases it's possible for giflib/libungif to return color 
1617    indexes outside the range of colors defined by the image's palette.
1618    We now expand the palette to match the indexes used.
1619    Thanks to Gabriel Vasseur for reporting this.
1620
1621  - fixed various memory leaks that could occur when failing to read png,
1622    jpeg, bmp or tga files.
1623
1624  - to avoid confusion, channels not present in the image are returned as
1625    zero by getscanline().  This has no effect on the C level i_glin()
1626    and i_glinf() API functions which continue to not set the unused
1627    channels.
1628
1629  - the convert() method now returns an image of the same sample size as
1630    the source image.
1631    https://rt.cpan.org/Ticket/Display.html?id=28492
1632
1633  - remove repeated text in Imager::Files
1634    http://rt.cpan.org/Ticket/Display.html?id=27589
1635
1636  - be even more explicit that scale() and friends don't modify the source
1637    image, but return a new image.
1638    http://rt.cpan.org/Ticket/Display.html?id=28570
1639
1640  - improve the error message from errstr() when you try to load a font
1641    for which the driver hasn't been built in Imager.
1642    http://rt.cpan.org/Ticket/Display.html?id=27571
1643
1644  - transparency is now enabled by default when writing GIF images
1645    http://rt.cpan.org/Ticket/Display.html?id=27615
1646
1647  - Imager would not load on Windows 98
1648    http://rt.cpan.org/Ticket/Display.html?id=27653
1649
1650 Imager 0.59 - 14 June 2007
1651 ===========
1652
1653 Bug fixes:
1654
1655  - fixes a regression introduced by the fixes for RT 11972
1656    http://rt.cpan.org/Ticket/Display.html?id=27546
1657
1658  - cropping outside the image would return an Imager object with
1659    no low-level image object, instead of returning false.
1660    Fixed by: Philip Gwyn (Leolo)
1661    http://rt.cpan.org/Ticket/Display.html?id=27509
1662
1663 Imager 0.58 - 16 May 2007
1664 ===========
1665
1666 No significant changes from 0.57_01.
1667
1668 Imager 0.57_01 - 11 May 2007
1669 ==============
1670
1671  - added to_rgb16 to produce a 16-bit/sample version of an image
1672
1673  - improve freetype 1.x text output efficiency
1674
1675 Bug fixes:
1676
1677  - search another place for rgb.txt, and check all the places 
1678    Imager::Color checks when deciding whether to skip testing it
1679    http://rt.cpan.org/Ticket/Display.html?id=26064
1680
1681  - use a convolution kernel size based on the stddev rather than a
1682    fixed size when performing a gaussian blur
1683    http://rt.cpan.org/Ticket/Display.html?id=25645
1684
1685  - document the difference() method's mindist parameter, and debug it.
1686
1687  - put the Imager release number in the Inline::C generated code to
1688    regenerate Inline code when a new release of Imager is installed.
1689    http://rt.cpan.org/Ticket/Display.html?id=26278
1690
1691  - fix rendering on alpha channel images for the FreeType 1.x driver.
1692    http://rt.cpan.org/Ticket/Display.html?id=11972
1693
1694  - fix rendering on alpha channel images for the T1lib driver.
1695    http://rt.cpan.org/Ticket/Display.html?id=11972
1696
1697  - reworked library probing, we can now set more than one probe
1698    function for a library.  Disabled the default (non-freetype-config)
1699    library probe and added an extra probe function that searches for
1700    both ft2build.h and whatever it includes, and adds -I as needed.
1701    Hopefully this will fix build problems like
1702    http://www.nntp.perl.org/group/perl.cpan.testers/2007/05/msg472281.html
1703    http://rt.cpan.org/Ticket/Display.html?id=26086
1704
1705 Imager 0.57 - 30 Apr 2007
1706 ===========
1707
1708 This is a maintenence release fixing a security issue in Imager.
1709
1710  - CRITICAL: a specially crafted compressed BMP file can cause a buffer
1711    overflow in malloced memory.  There will be further discussion of
1712    this issue in the ticket below.
1713    http://rt.cpan.org/Ticket/Display.html?id=26811
1714    CVE-2007-2459  CVE-2007-2413
1715    The descriptions at cve.mitre.org varied in quality, please see the
1716    ticket at rt.cpan.org for a more accurate description of the issue.
1717
1718 Imager 0.56 - 1 Apr 2007
1719 ===========
1720
1721  - added support for reading 16-bit/sample PGM/PPM images
1722
1723  - added support for writing 16-bit/sample PGM/PPM images
1724
1725  - improved performance of reading PBM/PGM/PPM images
1726
1727  - added support for writing PBM images if the image is paletted and
1728    contains only black and white
1729
1730  - added a new make_colors value - "mono"
1731
1732  - switched from the svn log Changes to a manual Changes to reduce
1733    noise
1734
1735  - new sample code - samples/flasher.pl
1736
1737 Bug fixes:
1738
1739  - CRITICAL: the "Imager" typemap entry (not used by Imager itself)
1740    was returning an image object with an extra reference, this
1741    resulted in a memory leak.
1742    http://rt.cpan.org/Ticket/Display.html?id=24992
1743
1744  - fix rendering on alpha channel images for the FreeType 2.x driver
1745    http://rt.cpan.org/Ticket/Display.html?id=11972
1746
1747  - reading bmp files now consitently handles short reads.  You can now
1748    supply a parameter to treat a short read as successful and set
1749    i_incomplete
1750    http://rt.cpan.org/Ticket/Display.html?id=8426
1751
1752  - previously, reading ASCII PBM files required spaces between samples,
1753    even though the format doesn't require that
1754
1755  - improved documentation of the unsharpmask filter (I hope)
1756    http://rt.cpan.org/Ticket/Display.html?id=25531
1757
1758  - force flushing of the output from i_tt_dump_names() and test output
1759    in t/t35ttfont.t to prevent output from being mixed up.
1760    https://rt.cpan.org/Ticket/Display.html?id=24859
1761
1762  - rewrite a conditional expression as an if() to hopefully work around
1763    a bug in the pre-4.0 GCC Apple shipped with OS X 10.4.
1764    https://rt.cpan.org/Ticket/Display.html?id=25561
1765
1766  - avoid Data::Dumper in regops.perl to support older releases of perl
1767    https://rt.cpan.org/Ticket/Display.html?id=24391
1768
1769 Imager 0.55 - 16 Dec 2006
1770 ===========
1771
1772 This is primarily a bug fix release.
1773
1774 Note: Test::More is now a pre-requisite for Imager and is no longer bundled.
1775
1776 There is one new feature:
1777
1778  - the Win32 font driver now supports UTF8 (RT 22166)
1779    http://www.cpanforum.com/threads/3276
1780    http://rt.cpan.org/Ticket/Display.html?id=22166
1781
1782 Several bugs were fixed:
1783
1784  - the string() method would not output the string "0"
1785    http://rt.cpan.org/Public/Bug/Display.html?id=21770
1786
1787  - fills.c was failing to compile on Solaris 10 (compiler unknown)
1788    http://rt.cpan.org/Public/Bug/Display.html?id=21944
1789
1790  - the gif_disposal and gif_user_input tags weren't being read from
1791    the file correctly
1792    http://rt.cpan.org/Public/Bug/Display.html?id=22192
1793
1794  - gif.c was failing to build under MSVC
1795    http://rt.cpan.org/Ticket/Display.html?id=23922
1796
1797  - in some cases strings passed to the string() method were treated as
1798    terminated by NUL (chr 0)
1799    http://rt.cpan.org/Public/Bug/Display.html?id=21770
1800
1801  - on "MSWin32" perl builds we now link to -lzlib instead of -lz since
1802    that's the default build name for zlib on Win32.
1803    http://rt.cpan.org/Ticket/Display.html?id=23064
1804
1805  - search $Config{incpath} for headers too, which we should have been
1806    doing all along.
1807
1808 Win32 font driver fixes:
1809
1810  - the global descent value from bounding box was the wrong sign
1811    http://www.cpanforum.com/threads/3276
1812
1813  - if the first or last glyph overflowed the left or right side of the
1814    advance width they would be clipped
1815
1816
1817 Imager 0.54 - 14 Sep 2006
1818 ===========
1819
1820 This is primarily a feature release:
1821
1822  - a new qtype value 'mixing' has been added to the scale()
1823    method. This is faster than 'normal', slower than 'preview'. This
1824    is based on the method used by pnmscale, and seems to produce less
1825    blurry results than normal.
1826    http://rt.cpan.org/Public/Bug/Display.html?id=20677
1827
1828  - the rubthrough() method can now render onto images with an alpha
1829    channel.
1830    http://rt.cpan.org/Ticket/Display.html?id=20678
1831
1832  - the read_multi() method now falls back to calling doing a single
1833    image read via the read() method and write_multi() will now fall
1834    back to calling write() if a single image is supplied. This means
1835    you can simply call the read_multi() or write_multi() functions
1836    without having to check if the type is formatted by that method.
1837    http://rt.cpan.org/Ticket/Display.html?id=19457
1838    http://rt.cpan.org/Ticket/Display.html?id=19458
1839
1840  - the GIF loop extension can now be written. If you don't have
1841    libungif/giflib 4.1.4 (or some distribution's bugfixed equivalent) you
1842    should upgrade.
1843    http://rt.cpan.org/Ticket/Display.html?id=21185
1844
1845  - getscanline() and setscanline() can now read/write palette index
1846    based data from/to the image for paletted images, by setting type to
1847    'index'.
1848    http://rt.cpan.org/Ticket/Display.html?id=20338
1849
1850  - we no longer hassle you to disable GIF support
1851    http://rt.cpan.org/Ticket/Display.html?id=20687
1852
1853  - minor documentation fixes
1854
1855
1856 Imager 0.53 - 26 Jul 2006
1857 ===========
1858
1859 This is a bugfix release.
1860
1861 Some test code was left in a code path not covered by the test
1862 suite. A test was added to cover this code path and the test code was
1863 removed.
1864 http://rt.cpan.org/Public/Bug/Display.html?id=20705
1865
1866
1867 Imager 0.52 - 25 Jul 2006
1868 ===========
1869
1870 This is primarily a feature release, but contains a fair few bug
1871 fixes, new features:
1872
1873  - ability to read and write MS Windows ICO and CUR files
1874
1875  - you can now add file format plugins to support new file formats
1876
1877  - add POD coverage tests
1878
1879  - setcolors() and addcolors() now accept color names and so on
1880    instead of requiring Imager::Color objects.
1881    http://rt.cpan.org/Ticket/Display.html?id=20056
1882
1883  - flood_fill() can now fill to a specified border color instead of
1884    just to the area the same color as the seed.
1885    http://rt.cpan.org/Ticket/Display.html?id=19618
1886
1887
1888 Bug fixes:
1889
1890  - bounding_box for the T1 driver wasn't converting UTF8 to ascii when
1891    calculating the advance width.
1892    http://rt.cpan.org/Public/Bug/Display.html?id=20554
1893
1894  - bounding_box for the T1 driver wasn't including leading and
1895    trailing spaces in the bounding box as the other drivers did, it also
1896    produced strange results for empty strings or strings containing only
1897    spaces
1898
1899  - when reading CMYK jpeg images they were being transferred to the
1900    image object as is, producing a four channel image. It only looked ok
1901    due to an old still unfixed Photoshop bug. We now convert from the
1902    inverted CMYK that photoshop (and Corel for example) produce into RGB.
1903    http://rt.cpan.org/Ticket/Display.html?id=20416
1904
1905  - reading a CYMK TIFF would result in a 4 channel image, reading any
1906    image with more than 4 channels (eg. RGB with 2 alpha channels) would
1907    result in an error.
1908    http://rt.cpan.org/Ticket/Display.html?id=20415
1909
1910  - added /usr/local/include to the default include search path, since
1911    we were already searching /usr/local/lib for libraries.
1912
1913 And various minor fixes and documentation updates.
1914
1915
1916 Imager 0.51 - 23 Apr 2006
1917 ===========
1918
1919  - fix a validation bug when processing JPEG EXIF data that can cause
1920    a crash
1921    http://rt.cpan.org/Public/Bug/Display.html?id=18496
1922
1923  - fix mis-processing of the src_maxx and src_maxy parameters of the
1924    paste() method
1925    http://rt.cpan.org/Public/Bug/Display.html?id=18712
1926
1927  - fix a problem in Imager's "smart" handling of the color parameter
1928    to various methods.
1929    http://rt.cpan.org/Public/Bug/Display.html?id=18561
1930
1931
1932 Imager 0.50 - 29 Mar 2006
1933 ===========
1934
1935  - CRITICAL: fixes a segmentation fault from attempting to write a 2
1936    or 4 channel image to jpeg or a 2 channel image to tga where the
1937    output is an in-memeory buffer.
1938    http://rt.cpan.org/Public/Bug/Display.html?id=18397
1939
1940  - fixes an incorrect pointer parameter in the PNG code
1941    http://rt.cpan.org/Public/Bug/Display.html?id=18051
1942
1943  - skip Inline::C tests when building in a directory with spaces
1944    http://rt.cpan.org/Public/Bug/Display.html?id=18049