1Imager::LargeSamples(3)User Contributed Perl DocumentatioInmager::LargeSamples(3)
2
3
4

NAME

6       Imager::LargeSamples - track/document large sample support
7

SYNOPSIS

9         # make a large sample image
10         my $im = Imager->new(..., bits => 16);
11
12         # call some method
13         my $result = $im->$method(...);
14
15         # was the image modified at its full sample size
16

DESCRIPTION

18       Imager has had in-memory support for large samples for years now, but
19       many methods still don't work at the higher sample size when supplied
20       with a large sample image.
21
22       This document will track which methods support large samples and which
23       don't, for future improvements.
24

Support by method

26         Method       Support    Notes
27         ------       -------    -----
28         arc          Partial    [1]
29         box          Partial    [1]
30         circle       Partial    [1]
31         convert      Full
32         copy         Full
33         crop         Full
34         difference   Full
35         filter       Partial    Depends on the filter.
36         flip         None
37         flood_fill   Partial    [1]
38         getpixel     Full
39         getsamples   Full
40         getscanline  Full
41         map          None
42         masked       Full
43         matrix_transform
44                      Full
45         paste        Full
46         polygon      Partial    [1]
47         polyline     None
48         read         Partial    See L<File format large sample support>
49         read_multi   Partial    See L<File format large sample support>
50         rotate       Full
51         rubthrough   Full
52         scale        Partial    Some qtypes support large samples
53         scaleX       None
54         scaleY       None
55         setpixel     Full
56         setscanline  Full
57         string       Full       Preserves large samples, but most font drivers
58                                 generate 8 or fewer bits of levels of coverage.
59         transform    None
60         transform2   None
61         write        Partial    See L<File format large sample support>
62         write_multi  Partial    See L<File format large sample support>
63
64       [1] filling an area using the fill parameter works at the full depth of
65       the image, using filled => 1 and color works at 8-bits/sample
66

File format large sample support

68         Format    Format samples    Imager support
69         ------    --------------    --------------
70         BMP       8                 8
71         GIF       8                 8
72         ICO       8                 8
73         JPEG      8, 12             8
74         PBM       1                 1
75         PGM/PPM   1-16              read any, writes 8, 16
76         PNG       1, 2, 4, 8, 16    8
77         RAW                         8
78         SGI       8, 16             8, 16
79         TGA       8                 8
80         TIFF      (many)            read/write 8, 16, 32 contig rgb/grey images
81                                     read/write bi-level
82                                     read/write 4/8 paletted images
83

Filter larger sample support

85         Filter      Large sample support
86         ------      --------------------
87         autolevels      No
88         bumpmap         No
89         bumpmap_complex No
90         contrast        No
91         conv            Yes
92         fountain        Yes
93         gaussian        Yes
94         gradgen         No
95         hardinvert      Yes
96         mosaic          No
97         postlevels      No
98         radnoise        No
99         turbnoise       No
100         unsharpmask     Yes
101         watermark       No
102

AUTHOR

104       Tony Cook <tony@imager.perl.org>
105
106
107
108perl v5.8.8                       2008-03-28           Imager::LargeSamples(3)
Impressum