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