Imager...amples(3pm)

💖 NAME 💖

okay so bestie, this is the 3pm manual page for Imager::LargeSamples from User Contributed Perl Documentation, and it's lowkey a tracking doc for track/document large sample support, periodt. 💅

---

✨ SYNOPSIS ✨

the whole vibe is: make a large sample image, call a method, then check if the image got modified at its full sample size. it's giving main character energy, ngl:

  # make a large sample image
  my $im = Imager->new(..., bits => 16);

  # call some method
  my $result = $im->$method(...);

  # was the image modified at its full sample size

iykyk 💅

---

🌸 DESCRIPTION 🌸

Imager has had in-memory support for large samples for years now, but many methods still don't work at the higher sample size when supplied with a large sample image. 😭

This document will track which methods support large samples and which don't, for future improvements. no cap, it's literally a support tracker and we're obsessed with the detail. 🫶

---

🫶 Support by method 🫶

vibe check time, bestie — here's every single method and whether large samples get the love:

• arc — support: Partial — note [1].
• box — support: Partial — note [2].
• circle — support: Partial — note [1].
• convert — support: Full.
• copy — support: Full.
• crop — support: Full.
• difference — support: Full.
• filter — support: Partial — note: Depends on the filter.
• flip — support: Full.
• flood_fill — support: Partial — note [1].
• getpixel — support: Full.
• getsamples — support: Full.
• getscanline — support: Full.
• map — support: None.
• masked — support: Full.
• matrix_transform — support: Full.
• paste — support: Full.
• polygon — support: Partial — note [1].
• polyline — support: None.
• read — support: Partial — see L<File format large sample support>.
• read_multi — support: Partial — see L<File format large sample support>.
• rotate — support: Full.
• rubthrough — support: Full.
• scale — support: Partial — note: Some qtypes support large samples.
• scaleX — support: None.
• scaleY — support: None.
• setpixel — support: Full.
• setscanline — support: Full.
• string — support: Full — note: Preserves large samples, but most font drivers generate 8 or fewer bits of levels of coverage.
• transform — support: None.
• transform2 — support: None.
• write — support: Partial — see L<File format large sample support>.
• write_multi — support: Partial — see L<File format large sample support>.

and the footnotes, because details matter, bestie:

• [1] filling an area using the fill parameter works at the full depth of the image, using filled => 1 and color works at 8-bits/sample.
• [2] box() will fill the area at the supplied color, but outline at 8-bits/sample.

---

🦋 File format large sample support 🦋

format support is its own little saga, so here's the tea by file format:

• BMP — format samples: 8; Imager support: 8.
• GIF — format samples: 8; Imager support: 8.
• ICO — format samples: 8; Imager support: 8.
• JPEG — format samples: 8, 12; Imager support: 8.
• PBM — format samples: 1; Imager support: 1.
• PGM/PPM — format samples: 1-16; Imager support: read any, writes 8, 16.
• PNG — format samples: 1, 2, 4, 8, 16; Imager support: 1, 2, 4, 8 paletted, 1, 8, 16 gray (1 for is_monochrome() images), 8, 16 RGB.
• RAW — format samples: (empty in the original); Imager support: 8.
• SGI — format samples: 8, 16; Imager support: 8, 16.
• TGA — format samples: 8; Imager support: 8.
• TIFF — format samples: (many); Imager support: read/write 8, 16, 32 contig rgb/grey images, read/write bi-level, read/write 4/8 paletted images.

these formats really said "we contain multitudes," and honestly? iconic. 🌈

---

🎀 Filter larger sample support 🎀

and the filter lineup, because filters deserve their own moment:

• autolevels — large sample support: No.
• bumpmap — large sample support: No.
• bumpmap_complex — large sample support: No.
• contrast — large sample support: No.
• conv — large sample support: Yes.
• fountain — large sample support: Yes.
• gaussian — large sample support: Yes.
• gradgen — large sample support: No.
• hardinvert — large sample support: Yes.
• mosaic — large sample support: No.
• postlevels — large sample support: No.
• radnoise — large sample support: No.
• turbnoise — large sample support: No.
• unsharpmask — large sample support: Yes.
• watermark — large sample support: No.

the yes-girlies ate, the no-girlies are still on their journey. 🙈💅

---

👑 AUTHOR 👑

Tony Cook <tonyc@cpan.org> — icon behavior, honestly. 🫶

---

mwah 💖 this cutie is from perl v5.42.3, dated 2026-08-19, and it's the Imager::LargeSamples(3pm) page — love u, bye! 🫶✨