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