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