custom META.yml was a waste.
- bump to 0.47_01
+0.48
+- removed unused hashinfo() function from Imager.xs
+- added =items for various methods, so Pod::Coverage will pick them up
+ (Pod::Coverage tests to be added in 0.49)
+
=================================================================
For latest versions check the Imager-devel pages:
masked() - L<Imager::ImageTypes/masked> - make a masked image
-matrix_transform() - L<Imager::Engines/"Matrix Transformations">
+matrix_transform() - L<Imager::Engines/matrix_transform>
maxcolors() - L<Imager::ImageTypes/maxcolors>
scale() - L<Imager::Transformations/scale>
-setscanline() - L<Imager::Draw/setscanline>
-
scaleX() - L<Imager::Transformations/scaleX>
scaleY() - L<Imager::Transformations/scaleY>
setpixel() - L<Imager::Draw/setpixel>
+setscanline() - L<Imager::Draw/setscanline>
+
+settag() - L<Imager::ImageTypes/settag>
+
set_file_limits() - L<Imager::Files/"Limiting the sizes of images you read">
string() - L<Imager::Draw/string> - draw text on an image
void
malloc_state()
-void
-hashinfo(hv)
- PREINIT:
- HV* hv;
- int stuff;
- PPCODE:
- if (!SvROK(ST(0))) croak("Imager: Parameter 0 must be a reference to a hash\n");
- hv=(HV*)SvRV(ST(0));
- if (SvTYPE(hv)!=SVt_PVHV) croak("Imager: Parameter 0 must be a reference to a hash\n");
- if (getint(hv,"stuff",&stuff)) printf("ok: %d\n",stuff); else printf("key doesn't exist\n");
- if (getint(hv,"stuff2",&stuff)) printf("ok: %d\n",stuff); else printf("key doesn't exist\n");
-
void
DSO_open(filename)
char* filename
=head2 Matrix Transformations
+=over
+
+=item matrix_transform
+
Rather than having to write code in a little language, you can use a
matrix to perform affine transformations, using the matrix_transform()
method:
used for pixels where there is no corresponding pixel in the source
image.
+=back
+
=cut
=head2 Limiting the sizes of images you read
+=over
+
+=item set_file_limits
+
In some cases you will be receiving images from an untested source,
such as submissions via CGI. To prevent such images from consuming
large amounts of memory, you can set limits on the dimensions of
# only bytes is limited
Imager->set_file_limits(reset=>1, bytes=>10_000_000);
+=item get_file_limits
+
You can get the current limits with the get_file_limits() method:
my ($max_width, $max_height, $max_bytes) =
Imager->get_file_limits();
+=back
=head1 TYPE SPECIFIC INFORMATION
Filters are operations that have similar calling interface.
+=over
+
+=item filter
+
+Parameters:
+
+=over
+
+=item *
+
+type - the type of filter, see L</Types of Filters>.
+
+=item *
+
+many other possible parameters, see L</Types of Filters> below.
+
+=back
+
+=back
+
=head2 Types of Filters
Here is a list of the filters that are always avaliable in Imager.
Linux, Solaris, HPUX, OpenBSD, FreeBSD, TRU64/OSF1, AIX.
If you test this on other systems please let me know.
+=over
+
+=item load_plugin
+
+This is a function, not a method, exported by default. You should
+import this function explicitly for future compatibility if you need
+it.
+
+Accepts a single parameter, the name of a shared library file to load.
+
+Returns true on success. Check Imager->errstr on failure.
+
+=item unload_plugin
+
+This is a function, not a method, which is exported by default. You
+should import this function explicitly for future compatibility if you
+need it.
+
+Accepts a single parameter, the name of a shared library to unload.
+This library must have been previously loaded by load_plugin().
+
+Returns true on success. Check Imager->errstr on failure.
+
+=back
+
=head2 Image Difference
+=over
+
+=item difference
+
You can create a new image that is the difference between 2 other images.
my $diff = $img->difference(other=>$other_img);
The width and heigh of $diff will be the minimum of each of the width
and height of $img and $other_img.
+=back
+
=cut
In each case deltag() returns the number of tags deleted.
+=item settag
+
+settag() replaces any existing tags with a new tag. This is
+equivalent to calling deltag() then addtag().
+
=back
=head2 Common Tags
=head2 Color transformations
+=over
+
+=item convert
+
You can use the convert method to transform the color space of an
image using a matrix. For ease of use some presets are provided.
[ 0, 0, 0, 0.5 ],
]);
+=back
+
=head2 Color Mappings
+=over
+
+=item map
+
You can use the map method to map the values of each channel of an
image independently using a list of lookup tables. It's important to
realize that the modification is made inplace. The function simply
$img->map(maps=>[\@redmap, [], \@bluemap]);
+=back
+
=head1 SEE ALSO
L<Imager>, L<Imager::Engines>