Image::Info::XPM (3pm)

 use Image::Info qw(image_info dim);

 my $info = image_info("image.xpm");
 if (my $error = $info->{error}) {
     die "Can't parse image info: $error\n";
 }
 my $color = $info->{color_type};

 my($w, $h) = dim($info);

This modules supplies the standard key names except for Compression, Gamma, Interlace, LastModificationTime, as well as:

ColorPalette

Reference to an array of all colors used. This key is only present if \*(C`image_info\*(C' is invoked as \*(C`image_info({ColorPalette>=1})\*(C'.

ColorTableSize

The number of colors the image uses.

HotSpotX

The x-coord of the image's hotspot. Set to -1 if there is no hotspot.

HotSpotY

The y-coord of the image's hotspot. Set to -1 if there is no hotspot.

L1D_Histogram

Reference to an array representing a one dimensioanl luminance histogram. This key is only present if \*(C`image_info\*(C' is invoked as \*(C`image_info($file, L1D_Histogram=>1)\*(C'. The range is from 0 to 255, however auto-vivification is used so a null field is also 0, and the array may not actually contain 255 fields.

XPM_CharactersPerPixel

This is typically 1 or 2. See Image::Xpm.

XPM_Extension-.*

\s-1XPM\s0 Extensions (the most common is \s-1XPMEXT\s0) if present.

\$1

$info->process_file($source, $options);

Processes one file and sets the found info fields in the $info object.

This module requires Image::Xpm

$Image::Info::XPM::RGBLIB is set to /usr/X11R6/lib/X11/rgb.txt by default, this is used to resolve textual color names to their \s-1RGB\s0 counterparts.

Image::Info, Image::Xpm

For more information about \s-1XPM\s0 see:

ftp://ftp.x.org/contrib/libraries/xpm-README.html

While the module attempts to be as robust as possible, it may not recognize older XBMs (Versions 1-3), if this is the case try inserting /* \s-1XPM\s0 */ as the first line.

Jerrad Pierce <[email protected]>/<[email protected]>

Now maintained by Tels - (c) 2006.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.