# phpman > perldoc > Image::Info::XPM

## NAME
    [Image::Info::XPM](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AInfo%3A%3AXPM/markdown) - XPM support for [Image::Info](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AInfo/markdown)

## SYNOPSIS
     use [Image::Info](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AInfo/markdown) 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);

## DESCRIPTION
    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 "image_info" is
        invoked as "image_info($file, ColorPalette>=1)".

    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 dimensional luminance histogram. This key is only
        present if "image_info" is invoked as "image_info($file, L1D_Histogram=>1)". 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](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AXpm/markdown).

    XPM_Extension-.*
        XPM Extensions (the most common is XPMEXT) if present.

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

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

## FILES
    This module requires [Image::Xpm](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AXpm/markdown)

    *$[Image::Info::XPM::RGBLIB](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AInfo%3A%3AXPM%3A%3ARGBLIB/markdown)* is set to /usr/X11R6/lib/X11/rgb.txt or an equivalent path (see the
    "_get_rgb_txt" function for the complete list) by default, this is used to resolve textual color
    names to their RGB counterparts.

## SEE ALSO
    [Image::Info](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AInfo/markdown), [Image::Xpm](https://www.chedong.com/phpMan.php/perldoc/Image%3A%3AXpm/markdown)

## NOTES
    For more information about XPM see <ftp://ftp.x.org/contrib/libraries/xpm-README.html>

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

## AUTHOR
    Jerrad Pierce <<belg4mit@mit.edu>>/<<webmaster@pthbb.org>>

    Tels - (c) 2006.

    Now maintained by Slaven Rezic <<srezic@cpan.org>>.

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