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