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