WINICONTOPAM(1)

📦
version 11.13.03 · 5 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 winicontopam — the Winicontopam User Manual, but make it a vibe 💖

okay bestie, welcome to the winicontopam(1) glow-up. this is a General Commands Manual page, part of the Netpbm family, and it's literally about turning Windows icon files into PAM images. iconic behavior. let's get into it 🎀

✨ NAME ✨

winicontopam — convert a Microsoft Windows icon file into a Netpbm PAM file 🦋

📜 SYNOPSIS 📜

winicontopam [-image=index | -allimages] [-andmasks] [-verbose]
[icon_file]

All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or equals signs between an option name and its value. 💅 (yes, it's flexible like that, we love a low-maintenance flag)

🌈 DESCRIPTION 🌈

This program is part of Netpbm(1). 🫶

winicontopam reads a Microsoft Windows icon file and converts it to one or more RGB_ALPHA Netpbm PAM images. that's the whole job. she's a converter. she converts. main character energy fr fr.

okay so, transparency lore time 👑: there are two kinds of transparency information a Windows icon can have — the and mask and the graded transparency map.

  • the and mask is the older one, and it just says, per pixel, whether that pixel is fully opaque or fully transparent. no in-between. binary queen.
  • the graded transparency map can do translucent values too. she's nuanced. she's got range. she shows up in an icon that uses PNG encoding, or uses BMP encoding with 32 bits per pixel.

The transparency plane in the PAM output of winicontopam comes from:

  • the graded transparency map if it exists, and
  • the and mask otherwise.

An icon may actually have both forms of transparency information. 👀 See -andmasks.

The output goes to Standard Output. 📤

The output is a multi-image PAM file. If you want a separate file for each image, use pamsplit(1). no cap.

💅 OPTIONS 💅

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), winicontopam recognizes the following command line options:

  • -allimages — Convert all images in the input. 🗂️

You may not specify this together with -image.

By default, winicontopam converts only the one "best quality" image (largest, then most bits per pixel). she's picking the baddest one automatically, periodt.

  • -image=index — Convert image number index (starting with zero). 🔢

You may not specify this together with -allimages.

By default, winicontopam converts the "best quality" image (largest, then most bits per pixel).

  • -andmasks — If the image to be extracted contains both graded transparency data and an AND mask, produce five-channel Netpbm PAM images with the AND mask as the fifth plane. 🖐️
heads up: an image that formally has graded transparency data, but that data indicates nothing but opaque pixels, is considered not to have graded transparency data — so -andmasks would have no effect on it. it's giving "technically has it but doesn't count". 🙈
  • -verbose — Print more messages. 🗣️ she gets chatty. we support her.

🔍 SEE ALSO 🔍

For information on the PNG format, see http://schaik.com/png . 🌐

📖 HISTORY 📖

winicontopam was new in Netpbm 10.63 (June 2013). ⭐

It obsoleted winicontoppm by providing more function and conforming better to Netpbm conventions. rest in peace to the old one, she served, but the new one ate 💀🔥

👑 AUTHOR 👑

Copyright (C) 2013 by Ludolf Holzheid.

Translated to Netpbm coding style by Bryan Henderson.

🧚 DOCUMENT SOURCE 🧚

This manual page was generated by the Netpbm tool makeman from HTML source. The master documentation is at

http://netpbm.sourceforge.net/doc/winicontopam.html

and that's the whole page bestie, you're officially fluent in winicontopam 🌸💜 this absolute gem of a manual page came to you from the netpbm documentation, dated 29 August 2020 — mwah, slay, go convert some icons 🎀✨🦋

📦 where this page comes from