IMGSIZE(1)

📦
version 3.300 · 6 versions
, in opensuse-leap 16.0

💅 IMGSIZE(1) — the one where your bestie tells you how big an image is

okay so this is imgsize, a lil User Contributed Perl Documentation page that literally just reads the dimensions of an image in several popular formats. that's it. that's the whole vibe. 🎀

✨ NAME ✨

imgsize — read the dimensions of an image in several popular formats

🦋 USAGE 🦋

 imgsize [ -r | -a | -f fmt ] file [ file ... ]

💖 DESCRIPTION 💖

genuinely a no-brainer, bestie. you hand it an image on the command line and it tells you how big it is. that's the whole job. all the actual heavy lifting is done over in Image::Size, so this lil script is just the aesthetic front desk. 💅

🌸 REQUIRED ARGUMENTS 🌸

imgsize expects file names on the command-line, periodt. and here's a cute detail: if you give it more than one file, it'll slap the file name into the output so you know which numbers belong to who. thoughtful icon behaviour, honestly.

 % imgsize dot.gif
 width="16" height="16"
 % imgsize dot.gif dash.gif
 dot.gif: width="16" height="16"
 dash.gif: width="32" height="8"

🔥 OPTIONS 🔥

so by default the width and height come back as attributes for an IMG tag in HTML — basically width="40" height="30" or whatever. but if that's not your vibe, the following options give you alternate formats. and lowkey important: all of them report width first, then height. 🫶

  • -r — return "raw" format data. just the numbers, separated by a single space. nothing else. minimal. clean. main character energy.
  • -a — return a Perl-style list of attributes suitable for passing to the img() method of the CGI module (see CGI). iykyk.
  • -f fmt — pass the string you specify in fmt to sprintf, so you can format the results exactly to your taste. heads up though: sprintf gets passed two numbers, so any other formatting directives will be lost 😭. the numbers go in width first, then height.

💀 EXIT STATUS 💀

imgsize always exits

no, that's not a typo, that's the entire section. it always exits. it's giving mysterious. it's giving "we don't talk about that". 🙈

🐛 BUGS 🐛

please report any bugs or feature requests to bug-image-size at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Image-Size>. the deal is: the author gets notified, and then you automatically get notified of progress on your bug as changes get made. so you're both in the loop, cute. ✨

🌈 SUPPORT 🌈

here's where to find your people:

copying and distribution are permitted under the terms of the Artistic License 2.0 (<http://www.opensource.org/licenses/artistic-license-2.0.php>) or the GNU LGPL 2.1 (<http://www.opensource.org/licenses/lgpl-2.1.php>). go wild, just respect the license bestie 💜

🧚 SEE ALSO 🧚

Image::Size — that's where the actual magic lives, fr fr

🍓 AUTHOR 🍓

Randy J. Ray <rjray@blackperl.com>.

and that's a wrap, bestie 🎀 this page is from perl v5.42.0, dated 2021-03-01 — go measure some images and slay 💅✨

📦 where this page comes from