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