- add limited tests for Imager::ExtUtils
[imager.git] / Changes
1 Imager release history.  Older releases can be found in Changes.old
2
3 Imager 0.67 - unreleased
4 ===========
5
6 Bug fixes:
7
8  - corrected a reference leak where writing GIFs would leak memory.
9    This could also happen calling to_paletted().
10    Also documented the underlying long existing feature where the
11    colors parameter is filled with the generated color table and added
12    tests for it.
13    http://rt.cpan.org/Ticket/Display.html?id=41028
14
15  - write out the image size in bytes field of a BMP correctly.
16    http://rt.cpan.org/Ticket/Display.html?id=41406
17
18  - add limited tests for Imager::ExtUtils
19
20  - make Imager::ExtUtils->includes use an absolute path, since
21    a relative path could cause failures using Inline::C.
22    http://rt.cpan.org/Ticket/Display.html?id=37353
23
24 Imager 0.66 - 22 April 2008
25 ===========
26
27  - 24-bit color .ICO/.CUR files can now be read.
28
29 Bug fixes:
30
31  - an optimization skipping 0 src alpha values could cause the
32    rubthrough() to read past the end of a buffer.
33    http://www.nntp.perl.org/group/perl.cpan.testers/2008/05/msg1509184.html
34
35 Imager 0.65 - 20 May 2008
36 ===========
37
38 Bug fixes:
39
40  - In some cases when an error occurs reading those parts of a JPEG
41    file after the image the scan-line buffer could be freed a second
42    time.  In cases where the the error occured while reading the image
43    data it's possible that the buffer could have leaked.
44    Thanks to Gabriel Vasseur for reporting this and help in tracking
45    it down.
46
47  - the gif_screen_height tag was overriding the screen width and being
48    ignored for the screen height when present.
49    https://rt.cpan.org/Public/Bug/Display.html?id=35568
50
51 Imager 0.64 - 23 April 2008
52 ===========
53
54 This is a bug fix release.  This includes a fix for a possible
55 security issue.
56
57 Bug fixes:
58
59  - Possible security issue: The floating point sample path for image
60    based fills had a buffer overflow.  This would overwrite the end of
61    a malloc()ed buffer with double precision floats.
62    http://rt.cpan.org/Ticket/Display.html?id=35324
63    CVE-2008-1928
64
65  - check that the result of fileno($fh) is defined rather than simply
66    true when read() or write() is supplied with an fh parameter.
67    http://rt.cpan.org/Ticket/Display.html?id=35139
68
69  - i_scale_axis() wasn't checking the result of i_img_new_ch()
70    resulting in a SIGSEGV when attempting to scale an image to a size
71    too large to fit in memory.  This is a NULL pointer access issue,
72    not a buffer overflow.
73    Added a check for the failure.
74    scale_calculate() (and hence scale()) will now fail if any of the
75    scale size parameters are a reference.
76    http://rt.cpan.org/Ticket/Display.html?id=35172
77
78  - Regression: filling a greyscale image with a hatch used the wrong
79    color channels from the supplied fg/bg colors.
80    https://rt.cpan.org/Ticket/Display.html?id=35278
81
82  - fixed a related problem for image fills.
83
84 Imager 0.63 - 7 April 2008
85 ===========
86
87 This release primarily contains changes to improve ease of use -
88 rather than you having to convert images to the appropriate number of
89 channels, Imager handles it internally.  How to handle drawing colors
90 and the default combine mode is a thornier problem left for some other
91 release.
92
93  - the font libraries are now only initialized when needed.
94    http://rt.cpan.org/Ticket/Display.html?id=28825
95
96  - moved the imtoc.perl code into Imager::Preprocess
97
98  - paste() and rubthrough() now adapt the source image data to the
99    destination, so you can now safely paste/rubthrough from greyscale
100    images to color images or back, or from alpha channel images to
101    noalpha channels or back.
102    https://rt.cpan.org/Ticket/Display.html?id=30908
103
104  - rubthrough() now falls back to pasting when the source doesn't have
105    an alpha channel.  This effectively treats the source as having a
106    max alpha channel, the right thing to do.
107    http://rt.cpan.org/Ticket/Display.html?id=29944
108
109  - re-worked most of the area filling code to use a common set of
110    functions when filling.
111    Corrected normal combine mode.
112    Rewrote most of the combine modes to match the way the SVG draft
113    defines them with respect to a translucent source and destination.
114    Added tests for translucent source and destination.
115    Added tests to check 8-bit/sample and double/sample combines work
116    similarly.
117    https://rt.cpan.org/Ticket/Display.html?id=29879
118
119  - writing a 2 or 4 channel image to a JPEG file will now write that
120    image as if composited against a background, black by default,
121    overridable with the i_background tag/parameter.
122    https://rt.cpan.org/Ticket/Display.html?id=29876
123
124  - writing a 2 or 4 channel image to a PGM/PPM file will now write
125    that image as if composited against a background, black by default,
126    overridable with the i_background tag/parameter.
127    http://rt.cpan.org/Ticket/Display.html?id=30074
128
129  - writing a 2 or 4 channel image to a BMP file will now write that
130    image as if composited against a background, black by default,
131    overridable with the i_background tag/parameter.
132    http://rt.cpan.org/Ticket/Display.html?id=30075
133
134 Bug fixes:
135
136  - Imager::Matrix2d->translate() now only requires one of the x or y
137    parameters.
138    http://rt.cpan.org/Ticket/Display.html?id=29937
139
140  - mixing qtype scaling now sets all channels of a pixel to zero if
141    the pixel has zero coverage (zero alpha).  This should produce more
142    compressible output files.
143    http://rt.cpan.org/Ticket/Display.html?id=32324
144
145  - removed the pointless #! line from lib/Imager/Font/Wrap.pm
146    Noticed when I saw:
147    https://bugzilla.redhat.com/show_bug.cgi?id=166254
148    I'm not changing the #! lines of the sample code, since it's sample
149    code, not intended for installation.
150    http://rt.cpan.org/Ticket/Display.html?id=33408
151
152  - some TGA images weren't being detected correctly as TGA images
153    https://rt.cpan.org/Ticket/Display.html?id=32925
154
155  - handling of the left-over bit for 16-bit/pixel TGA images has been
156    changed to match the behaviour of the GIMP.  Previously the bit
157    being set was treated as an opaque pixel, but one user reported a
158    problem with loading such an image.  I haven't been able to find any
159    tools beyond the GIMP that handle alpha-channel 16-bit TGAs, so
160    I'll match it's behaviour.  See issue 114913 in the GIMP's
161    bugzilla.
162    http://rt.cpan.org/Ticket/Display.html?id=32926
163
164 Imager 0.62 - 10 December 2007
165 ===========
166
167  - Makefile.PL now expands ~/path supplied to --incpath or --libpath
168    to /path under your home directory.
169    http://rt.cpan.org/Ticket/Display.html?id=29484
170
171  - the old dynaload code used Mach API functions to load dynamic
172    libraries on Mac OS X.  These APIs have been deprecated in OS X
173    10.5 and were causing some build problems.
174    So henceforth Imager uses the dlopen() family of functions, and you 
175    will need version 10.3 or later of OS X.
176
177  - added the det() function to the transform2() engine.
178    added the sample quad_to_square.pl
179    Courtesy Richard Fairhurst.
180    http://rt.cpan.org/Ticket/Display.html?id=31244
181
182 Bug fixes:
183
184  - samples/gifscale.pl sourced the base value for gif_top from
185    gif_left.
186    Thanks to Eleneldil G. Arilou for pointing this out.
187
188  - t/t82inline.t no longer loads B at runtime, to work around a bug
189    in some 5.005_0[45] installations.
190    http://rt.cpan.org/Ticket/Display.html?id=30508
191
192  - work around Module::Depends::Intrusive bug #21229
193    http://rt.cpan.org/Ticket/Display.html?id=30520
194
195  - the hardinvert filter no-longer inverts the alpha channel.
196    http://rt.cpan.org/Ticket/Display.html?id=30002
197
198  - the hardinvert filter now supports large samples
199
200 Imager 0.61_02 - 28 November 2007
201 ==============
202
203  - major TIFF support re-work
204    http://rt.cpan.org/Ticket/Display.html?id=20329
205
206  - added a C level image interface for accessing samples from 1-32
207    bits, exposed this at the perl level in getsamples()
208
209  - the conv filter now works at floating point precision for high bit
210    images
211
212  - added is_bilevel method to test whether an image should be written as
213    a bilevel image if the image format supports it.
214
215  - added -log-stderr as an Imager import list option
216
217  - added some important types to Imager::APIRef
218
219  - added test_image_double() to Imager::Test
220
221 Bug fixes:
222
223  - Imager::Fountain couldn't read GIMP gradient files with 10 or more
224    segments
225
226  - the scale() method with qtype mixing now handles images with an
227    alpha channel correctly.
228
229  - fixed a broken link from the "animated GIF" entry in the concept index.
230    Thanks to Slaven Rezic.
231    http://rt.cpan.org/Ticket/Display.html?id=30889
232
233  - on some perl's the infix expression parser test would fail due to
234    actions in the grammar returning false.  Made sure all actions return
235    a true value.
236    Thanks to Richard Fairhurst for spending a lot of time in tracking
237    down this problem.
238    http://rt.cpan.org/Public/Bug/Display.html?id=29562
239
240 Imager 0.61 - 5 November 2007
241 ===========
242
243  - added samples/gifscale.pl, which adjusts the screen size/position tags
244    when scaling an animated gif
245    http://rt.cpan.org/Ticket/Display.html?id=27591
246
247 Bug fixes:
248
249  - correct handling of sz in matrix_transform() - this should allow
250    perspective type transformations to work now.
251    http://rt.cpan.org/Ticket/Display.html?id=29936
252
253  - prevent a cast to integer warning on x64 builds in datatypes.c
254    also fixed some other type warnings
255    https://rt.cpan.org/Ticket/Display.html?id=30204
256
257  - some sub-directory tests depended on files produced by the parent
258    directory tests
259    http://rt.cpan.org/Ticket/Display.html?id=30203
260
261  - Imager::Font::Wrap doesn't correctly set savepos
262    thanks to Nikita Dedik and Eleneldil G. Arilou for reporting this.
263    http://rt.cpan.org/Ticket/Display.html?id=29771
264
265  - test 171 in t/t01introvert.t was failing on perls configured to
266    use long double.
267    http://rt.cpan.org/Ticket/Display.html?id=29413
268
269  - the code for the transform2() uminus operator was missing a break.
270    Added tests for better code coverage of the ops.
271    http://rt.cpan.org/Ticket/Display.html?id=29296
272
273  - the SGI RLE compression code could overflow its compression buffer
274    http://rt.cpan.org/Ticket/Display.html?id=30334
275
276  - the 32-bit output function used by the SGI code only handled values
277    under 0x10000.  This was most noticable when writing large RLE images.
278    http://rt.cpan.org/Ticket/Display.html?id=30335
279
280  - validate chan_count for chans == NULL for each of the i_gsamp()
281    implementations.
282    http://rt.cpan.org/Ticket/Display.html?id=28985
283
284  - attempt to work around the test failure at 
285    http://www.nntp.perl.org/group/perl.cpan.testers/2007/09/msg650810.html
286    http://rt.cpan.org/Ticket/Display.html?id=29562
287
288  - improve the error messages produced when attempting to read or write
289    an unknown image file format.
290    http://rt.cpan.org/Ticket/Display.html?id=30103
291
292  - improve the transform2() documentation
293    http://rt.cpan.org/Ticket/Display.html?id=29267
294
295  - correctly generate the author key in META.yml
296    http://rt.cpan.org/Ticket/Display.html?id=30377
297
298  - correctly blend a rotated (or matrix_transformed()) image when
299    performing interpolation in the presence of an alpha channel.
300    Also corrected the centring of the rotated image on the output
301    image.
302
303 Imager 0.60 - 30 August 2007
304 ===========
305
306  - Finished/rewrote Arnar's old SGI RGB file format support, so Imager
307    now has full SGI RGB image format, including RLE and 16-bit/sample
308    images.
309    https://rt.cpan.org/Ticket/Display.html?id=8666
310
311  - logging functions are now available in the API
312
313  - applied Gabriel Vasseur's patch
314    added documentation, further tests, and support for greyscale images
315    Obviously problems are my fault :)
316    https://rt.cpan.org/Ticket/Display.html?id=28142
317
318  - the mask for ICO/CUR images is now applied as an alpha channel to
319    the returned image.  For the old behaviour, supply ico_masked => 0
320    to read() or read_multi().  This should be less confusing when
321    using Imager as a general image processor.
322    https://rt.cpan.org/Ticket/Display.html?id=29001
323
324 Bug fixes:
325
326  - in some cases it's possible for giflib/libungif to return color 
327    indexes outside the range of colors defined by the image's palette.
328    We now expand the palette to match the indexes used.
329    Thanks to Gabriel Vasseur for reporting this.
330
331  - fixed various memory leaks that could occur when failing to read png,
332    jpeg, bmp or tga files.
333
334  - to avoid confusion, channels not present in the image are returned as
335    zero by getscanline().  This has no effect on the C level i_glin()
336    and i_glinf() API functions which continue to not set the unused
337    channels.
338
339  - the convert() method now returns an image of the same sample size as
340    the source image.
341    https://rt.cpan.org/Ticket/Display.html?id=28492
342
343  - remove repeated text in Imager::Files
344    http://rt.cpan.org/Ticket/Display.html?id=27589
345
346  - be even more explicit that scale() and friends don't modify the source
347    image, but return a new image.
348    http://rt.cpan.org/Ticket/Display.html?id=28570
349
350  - improve the error message from errstr() when you try to load a font
351    for which the driver hasn't been built in Imager.
352    http://rt.cpan.org/Ticket/Display.html?id=27571
353
354  - transparency is now enabled by default when writing GIF images
355    http://rt.cpan.org/Ticket/Display.html?id=27615
356
357  - Imager would not load on Windows 98
358    http://rt.cpan.org/Ticket/Display.html?id=27653
359
360 Imager 0.59 - 14 June 2007
361 ===========
362
363 Bug fixes:
364
365  - fixes a regression introduced by the fixes for RT 11972
366    http://rt.cpan.org/Ticket/Display.html?id=27546
367
368  - cropping outside the image would return an Imager object with
369    no low-level image object, instead of returning false.
370    Fixed by: Philip Gwyn (Leolo)
371    http://rt.cpan.org/Ticket/Display.html?id=27509
372
373 Imager 0.58 - 16 May 2007
374 ===========
375
376 No significant changes from 0.57_01.
377
378 Imager 0.57_01 - 11 May 2007
379 ==============
380
381  - added to_rgb16 to produce a 16-bit/sample version of an image
382
383  - improve freetype 1.x text output efficiency
384
385 Bug fixes:
386
387  - search another place for rgb.txt, and check all the places 
388    Imager::Color checks when deciding whether to skip testing it
389    http://rt.cpan.org/Ticket/Display.html?id=26064
390
391  - use a convolution kernel size based on the stddev rather than a
392    fixed size when performing a gaussian blur
393    http://rt.cpan.org/Ticket/Display.html?id=25645
394
395  - document the difference() method's mindist parameter, and debug it.
396
397  - put the Imager release number in the Inline::C generated code to
398    regenerate Inline code when a new release of Imager is installed.
399    http://rt.cpan.org/Ticket/Display.html?id=26278
400
401  - fix rendering on alpha channel images for the FreeType 1.x driver.
402    http://rt.cpan.org/Ticket/Display.html?id=11972
403
404  - fix rendering on alpha channel images for the T1lib driver.
405    http://rt.cpan.org/Ticket/Display.html?id=11972
406
407  - reworked library probing, we can now set more than one probe
408    function for a library.  Disabled the default (non-freetype-config)
409    library probe and added an extra probe function that searches for
410    both ft2build.h and whatever it includes, and adds -I as needed.
411    Hopefully this will fix build problems like
412    http://www.nntp.perl.org/group/perl.cpan.testers/2007/05/msg472281.html
413    http://rt.cpan.org/Ticket/Display.html?id=26086
414
415 Imager 0.57 - 30 Apr 2007
416 ===========
417
418 This is a maintenence release fixing a security issue in Imager.
419
420  - CRITICAL: a specially crafted compressed BMP file can cause a buffer
421    overflow in malloced memory.  There will be further discussion of
422    this issue in the ticket below.
423    http://rt.cpan.org/Ticket/Display.html?id=26811
424    CVE-2007-2459  CVE-2007-2413
425    The descriptions at cve.mitre.org varied in quality, please see the
426    ticket at rt.cpan.org for a more accurate description of the issue.
427
428 Imager 0.56 - 1 Apr 2007
429 ===========
430
431  - added support for reading 16-bit/sample PGM/PPM images
432
433  - added support for writing 16-bit/sample PGM/PPM images
434
435  - improved performance of reading PBM/PGM/PPM images
436
437  - added support for writing PBM images if the image is paletted and
438    contains only black and white
439
440  - added a new make_colors value - "mono"
441
442  - switched from the svn log Changes to a manual Changes to reduce
443    noise
444
445  - new sample code - samples/flasher.pl
446
447 Bug fixes:
448
449  - CRITICAL: the "Imager" typemap entry (not used by Imager itself)
450    was returning an image object with an extra reference, this
451    resulted in a memory leak.
452    http://rt.cpan.org/Ticket/Display.html?id=24992
453
454  - fix rendering on alpha channel images for the FreeType 2.x driver
455    http://rt.cpan.org/Ticket/Display.html?id=11972
456
457  - reading bmp files now consitently handles short reads.  You can now
458    supply a parameter to treat a short read as successful and set
459    i_incomplete
460    http://rt.cpan.org/Ticket/Display.html?id=8426
461
462  - previously, reading ASCII PBM files required spaces between samples,
463    even though the format doesn't require that
464
465  - improved documentation of the unsharpmask filter (I hope)
466    http://rt.cpan.org/Ticket/Display.html?id=25531
467
468  - force flushing of the output from i_tt_dump_names() and test output
469    in t/t35ttfont.t to prevent output from being mixed up.
470    https://rt.cpan.org/Ticket/Display.html?id=24859
471
472  - rewrite a conditional expression as an if() to hopefully work around
473    a bug in the pre-4.0 GCC Apple shipped with OS X 10.4.
474    https://rt.cpan.org/Ticket/Display.html?id=25561
475
476  - avoid Data::Dumper in regops.perl to support older releases of perl
477    https://rt.cpan.org/Ticket/Display.html?id=24391
478
479 Imager 0.55 - 16 Dec 2006
480 ===========
481
482 This is primarily a bug fix release.
483
484 Note: Test::More is now a pre-requisite for Imager and is no longer bundled.
485
486 There is one new feature:
487
488  - the Win32 font driver now supports UTF8 (RT 22166)
489    http://www.cpanforum.com/threads/3276
490    http://rt.cpan.org/Ticket/Display.html?id=22166
491
492 Several bugs were fixed:
493
494  - the string() method would not output the string "0"
495    http://rt.cpan.org/Public/Bug/Display.html?id=21770
496
497  - fills.c was failing to compile on Solaris 10 (compiler unknown)
498    http://rt.cpan.org/Public/Bug/Display.html?id=21944
499
500  - the gif_disposal and gif_user_input tags weren't being read from
501    the file correctly
502    http://rt.cpan.org/Public/Bug/Display.html?id=22192
503
504  - gif.c was failing to build under MSVC
505    http://rt.cpan.org/Ticket/Display.html?id=23922
506
507  - in some cases strings passed to the string() method were treated as
508    terminated by NUL (chr 0)
509    http://rt.cpan.org/Public/Bug/Display.html?id=21770
510
511  - on "MSWin32" perl builds we now link to -lzlib instead of -lz since
512    that's the default build name for zlib on Win32.
513    http://rt.cpan.org/Ticket/Display.html?id=23064
514
515  - search $Config{incpath} for headers too, which we should have been
516    doing all along.
517
518 Win32 font driver fixes:
519
520  - the global descent value from bounding box was the wrong sign
521    http://www.cpanforum.com/threads/3276
522
523  - if the first or last glyph overflowed the left or right side of the
524    advance width they would be clipped
525
526
527 Imager 0.54 - 14 Sep 2006
528 ===========
529
530 This is primarily a feature release:
531
532  - a new qtype value 'mixing' has been added to the scale()
533    method. This is faster than 'normal', slower than 'preview'. This
534    is based on the method used by pnmscale, and seems to produce less
535    blurry results than normal.
536    http://rt.cpan.org/Public/Bug/Display.html?id=20677
537
538  - the rubthrough() method can now render onto images with an alpha
539    channel.
540    http://rt.cpan.org/Ticket/Display.html?id=20678
541
542  - the read_multi() method now falls back to calling doing a single
543    image read via the read() method and write_multi() will now fall
544    back to calling write() if a single image is supplied. This means
545    you can simply call the read_multi() or write_multi() functions
546    without having to check if the type is formatted by that method.
547    http://rt.cpan.org/Ticket/Display.html?id=19457
548    http://rt.cpan.org/Ticket/Display.html?id=19458
549
550  - the GIF loop extension can now be written. If you don't have
551    libungif/giflib 4.1.4 (or some distribution's bugfixed equivalent) you
552    should upgrade.
553    http://rt.cpan.org/Ticket/Display.html?id=21185
554
555  - getscanline() and setscanline() can now read/write palette index
556    based data from/to the image for paletted images, by setting type to
557    'index'.
558    http://rt.cpan.org/Ticket/Display.html?id=20338
559
560  - we no longer hassle you to disable GIF support
561    http://rt.cpan.org/Ticket/Display.html?id=20687
562
563  - minor documentation fixes
564
565
566 Imager 0.53 - 26 Jul 2006
567 ===========
568
569 This is a bugfix release.
570
571 Some test code was left in a code path not covered by the test
572 suite. A test was added to cover this code path and the test code was
573 removed.
574 http://rt.cpan.org/Public/Bug/Display.html?id=20705
575
576
577 Imager 0.52 - 25 Jul 2006
578 ===========
579
580 This is primarily a feature release, but contains a fair few bug
581 fixes, new features:
582
583  - ability to read and write MS Windows ICO and CUR files
584
585  - you can now add file format plugins to support new file formats
586
587  - add POD coverage tests
588
589  - setcolors() and addcolors() now accept color names and so on
590    instead of requiring Imager::Color objects.
591    http://rt.cpan.org/Ticket/Display.html?id=20056
592
593  - flood_fill() can now fill to a specified border color instead of
594    just to the area the same color as the seed.
595    http://rt.cpan.org/Ticket/Display.html?id=19618
596
597
598 Bug fixes:
599
600  - bounding_box for the T1 driver wasn't converting UTF8 to ascii when
601    calculating the advance width.
602    http://rt.cpan.org/Public/Bug/Display.html?id=20554
603
604  - bounding_box for the T1 driver wasn't including leading and
605    trailing spaces in the bounding box as the other drivers did, it also
606    produced strange results for empty strings or strings containing only
607    spaces
608
609  - when reading CMYK jpeg images they were being transferred to the
610    image object as is, producing a four channel image. It only looked ok
611    due to an old still unfixed Photoshop bug. We now convert from the
612    inverted CMYK that photoshop (and Corel for example) produce into RGB.
613    http://rt.cpan.org/Ticket/Display.html?id=20416
614
615  - reading a CYMK TIFF would result in a 4 channel image, reading any
616    image with more than 4 channels (eg. RGB with 2 alpha channels) would
617    result in an error.
618    http://rt.cpan.org/Ticket/Display.html?id=20415
619
620  - added /usr/local/include to the default include search path, since
621    we were already searching /usr/local/lib for libraries.
622
623 And various minor fixes and documentation updates.
624
625
626 Imager 0.51 - 23 Apr 2006
627 ===========
628
629  - fix a validation bug when processing JPEG EXIF data that can cause
630    a crash
631    http://rt.cpan.org/Public/Bug/Display.html?id=18496
632
633  - fix mis-processing of the src_maxx and src_maxy parameters of the
634    paste() method
635    http://rt.cpan.org/Public/Bug/Display.html?id=18712
636
637  - fix a problem in Imager's "smart" handling of the color parameter
638    to various methods.
639    http://rt.cpan.org/Public/Bug/Display.html?id=18561
640
641
642 Imager 0.50 - 29 Mar 2006
643 ===========
644
645  - CRITICAL: fixes a segmentation fault from attempting to write a 2
646    or 4 channel image to jpeg or a 2 channel image to tga where the
647    output is an in-memeory buffer.
648    http://rt.cpan.org/Public/Bug/Display.html?id=18397
649
650  - fixes an incorrect pointer parameter in the PNG code
651    http://rt.cpan.org/Public/Bug/Display.html?id=18051
652
653  - skip Inline::C tests when building in a directory with spaces
654    http://rt.cpan.org/Public/Bug/Display.html?id=18049