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