Imager...ansform(3pm)

📦
version 1.035 · 9 versions
, in ubuntu stonking

🦋 Imager...ansform(3pm) 🦋

Okay so this page is from the User Contributed Perl Documentation crew, and the manual name is right there in the title: Imager...ansform(3pm). Yes, dots and all — we are not editing the iconic truncation, bestie. 💅

🌸 NAME 🌸

Imager::Transform — a library of register machine image transformations. That's the whole assignment. 💖

✨ SYNOPSIS ✨

# get a list of transformations
my @funcs = Imager::Transform->list;
# create a transformation object
my $tran = Imager::Transform->new($name);
# describe it
print $tran->describe;
# a list of constant names
my @constants = $tran->constants;
# information about some of the constants
my @info = $tran->constants(@constants);

🎀 DESCRIPTION 🎀

This module provides a library of transformations that use the Imager transform2() function. Lowkey the whole point is to have a place to collect these transformations together. 🫶

At some point there might be an interface to add new functions, but there's not a whole lot of point to that. Not me explaining the entire roadmap in one sentence. 💀

The interface is a little sparse as yet. It's giving "small but mighty," bestie. ✨

💅 METHODS 💅

  • my @names = Imager::Transform->list — Returns a list of the transformations. Simple, iconic, no notes. 👑
  • my $desc = Imager::Transform->describe($name) / my $desc = $tran->describe() — Describes a transformation specified either by name (as a class method) or by reference (as an instance method). The class method returns undef if there is no such transformation. 🎀
  • my $tran = Imager::Transform->new($name) — Create a new transformation object. Returns undef if there is no such transformation. No cap. 💖
  • my @inputs = $tran->inputs / my $inputs = $tran->inputs — Returns a list of input image descriptions, or the number of them, depending on content. The list contains hash references, which currently contain only one member, "desc", a description of the use of the input image. 🦋
  • $tran->constants — Returns a list of names of constants that can be set for the transformation. Collect them like little Pokémon, bestie. ✨
  • $tran->constants($name, $name, ...) — Returns a hashref for each named constant, which contains the default in key "default" and a description in key "desc". 🎀
  • my $out = $tran->transform(\%opts, \%constants, @imgs) — Perform the image transformation. Returns the new image on success, or undef on failure, in which case you can use $tran->errstr to get an error message. Main character transformation energy. 🔥
  • $tran->errstr — The error message, if any from the last image transformation. 😭

💀 BUGS 💀

Needs more transformations.

That's it. That's the whole bug list, and honestly? It's giving "we just want more slay." 💀

🌈 SEE ALSO 🌈

Go peep those, bestie. 🫶

👑 AUTHOR 👑

Tony Cook <tonyc@cpan.org> — take a bow. 👑

Catch you later, bestie! This footer is brought to you by perl v5.42.3, dated 2026-08-19, and that's the tea. 💅✨

📦 where this page comes from