view release on metacpan or  search on metacpan

README.textile  view on Meta::CPAN

h1. Image::Size - Determine the size of images in several common formats

Version: 3.300 (See CHANGES below)

h2. WHAT IS IT

Image::Size is a library based on the image-sizing code in the wwwimagesize script, a tool that analyzes HTML files and adds HEIGHT and WIDTH tags to IMG directives. Image::Size has generalized that code to return a raw (X, Y) pair, and included wrap...

I did this because my old WWW server generated a lot of documents on demand rather than keeping them in static files. These documents not only used directional icons and buttons, but other graphics to annotate and highlight sections of the text. With...


h2. USING Image::Size IN YOUR SCRIPTS

Image::Size has pod documentation that gives a more complete overview, but in a nutshell:

<pre>
<code>
        use Image::Size;

        ($x, $y) = imgsize("something.gif");
</code>
</pre>

And <code>($x, $y)</code> is now the width and height of something.gif. 95% of my usage of this library is in conjunction with Lincoln Stein's CGI.pm:

<pre>
<code>
        use CGI ':all';
        use Image::Size 'attr_imgsize';

        #
        # Emit an IMG tag with size attributes:
        #
        print img({-SRC => '/server/images/arrow.gif',
                   attr_imgsize('/server_root/server/images/arrow.gif')});
</code>
</pre>

Alternately, if you are running under Apache and mod_perl:

<pre>
<code>
        # Assume $Q is an object of class CGI, $r is an Apache request object
        $r->print($Q->img({ -src => $imgpath,
                            attr_imgsize($r->lookup_uri($imgpath)->
                                         filename) }));
</code>
</pre>

h2. BUILDING/INSTALLING

This package uses Makefile.PL:

<pre>
<code>
        perl Makefile.PL
        make && make test
        make install
</code>
</pre>

You may need super-user access to install.


h2. PROBLEMS/BUG REPORTS

Please send any reports of problems or bugs to rjray@blackperl.com.