
=encoding UTF-8

=head1 NAME

Image::Similar - find out how similar two images are

=head1 SYNOPSIS

    use Image::Similar;

=head1 VERSION

This documents version 0.01 of Image::Similar corresponding to git
commit 4d2a578b6e4fc10a5740551f034317a3afb8ee8e released on Wed Feb 17 18:26:16 2016 +0900.

=head1 DESCRIPTION

Compare two images.

=head1 FUNCTIONS

=head2 load_image

Using L<Imager>:

    my $img = Imager->new ();
    $img->read (file => 'my.jpg');
    my $is = load_image ($img);

The return value is an Image::Similar object.

=head1 METHODS

=head2 new

    my $is = Image::Similar->new (height => 10, width => 10);

This is no use at the moment, use L</load_image> instead.

=head2 diff

    my $diff = $is1->diff ($is2);

Find the difference between images C<$is1> and C<$is2>.

=head1 SEE ALSO

=over

=item L<Image::Libpuzzle>

This uses a similar algorithm to Image::Similar, but it requires
installing a third-party library called libpuzzle, as well as the gd
library.

=back


=head1 AUTHOR

Ben Bullock, <bkb@cpan.org>

=head2 Request

If you'd like to see this module continued, let me know that you're
using it. For example, send an email, write a bug report, star the
project's github repository, add a patch, add a C<++> on Metacpan.org,
or write a rating at CPAN ratings. It really does make a
difference. Thanks.

=head1 COPYRIGHT & LICENCE

This package and associated files are copyright (C) 
2016
Ben Bullock.

You can use, copy, modify and redistribute this package and associated
files under the Perl Artistic Licence or the GNU General Public
Licence.



