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