1Imager::LargeSamples(3)User Contributed Perl DocumentatioInmager::LargeSamples(3)
2
3
4
6 Imager::LargeSamples - track/document large sample support
7
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
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
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
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
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
104 Tony Cook <tony@imager.perl.org>
105
106
107
108perl v5.8.8 2008-03-28 Imager::LargeSamples(3)