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