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 8
80 RAW 8
81 SGI 8, 16 8, 16
82 TGA 8 8
83 TIFF (many) read/write 8, 16, 32 contig rgb/grey images
84 read/write bi-level
85 read/write 4/8 paletted images
86
88 Filter Large sample support
89 ------ --------------------
90 autolevels No
91 bumpmap No
92 bumpmap_complex No
93 contrast No
94 conv Yes
95 fountain Yes
96 gaussian Yes
97 gradgen No
98 hardinvert Yes
99 mosaic No
100 postlevels No
101 radnoise No
102 turbnoise No
103 unsharpmask Yes
104 watermark No
105
107 Tony Cook <tonyc@cpan.org>
108perl v5.12.3 2011-06-06 Imager::LargeSamples(3)