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    [2]
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         Full
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
67       [2] box() will fill the area at the supplied color, but outline at
68       8-bits/sample.
69

File format large sample support

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

Filter larger sample support

90         Filter      Large sample support
91         ------      --------------------
92         autolevels      No
93         bumpmap         No
94         bumpmap_complex No
95         contrast        No
96         conv            Yes
97         fountain        Yes
98         gaussian        Yes
99         gradgen         No
100         hardinvert      Yes
101         mosaic          No
102         postlevels      No
103         radnoise        No
104         turbnoise       No
105         unsharpmask     Yes
106         watermark       No
107

AUTHOR

109       Tony Cook <tonyc@cpan.org>
110
111
112
113perl v5.36.0                      2023-01-20           Imager::LargeSamples(3)
Impressum