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