1Imager::LargeSamples(3)User Contributed Perl DocumentatioInmager::LargeSamples(3)
2
6 Imager::LargeSamples - track/document large sample support
7
9 # make a large sample image
10 my $im = Imager->new(..., bits => 16);
11 # call some method
13 my $result = $im->$method(...);
14 # was the image modified at its full sample size
16
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 This document will track which methods support large samples and which
23 don't, for future improvements.
24
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 [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 [2] box() will fill the area at the supplied color, but outline at
68 8-bits/sample.
69
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
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
109 Tony Cook <tonyc@cpan.org>
110perl v5.36.0 2023-01-20 Imager::LargeSamples(3)