Image::Info::XPM(3)

💅 Image::Info::XPM(3) — XPM support for Image::Info 💅

okay bestie, this is the User Contributed Perl Documentation page for Image::Info::XPM(3) — it's giving XPM support for Image::Info, no cap ✨

🌸 NAME 🌸

Image::Info::XPM - XPM support for Image::Info

⭐ SYNOPSIS ⭐

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);

🦋 DESCRIPTION 🦋

This module supplies the standard key names except for Compression, Gamma, Interlace, LastModificationTime, as well as these iconic extras:

• 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.
• 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

$Image::Info::XPM::RGBLIB 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
• Image::Xpm

🐚 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.

---

mwah 💋 this whole manual page is from perl v5.42.0, dated 2024-03-08, and it's literally Image::Info::XPM(3) — bye bestie! 🫶✨