PNGCP(1)

📦
version 1.2 · 7 versions
, in ubuntu stonking

💖 PNGCP(1) 💖

okay bestie, welcome to pngcp from the pngtools collection — it's the lil glow-up tool that makes you a brand new PNG file with a whole new set of attributes. ✨

🌸 NAME 🌸

pngcp — create a new PNG file, having changed some attributes 🦋

✨ SYNOPSIS ✨

pngcp [-d <depth>] [-s <samples per pixel>] <input filename> <output filename>

💅 DESCRIPTION 💅

so here's the vibe: pngcp makes a new PNG file, and it does that by grabbing the image data straight out of your input file and repackaging it. 🎀

the output file gets the bitdepth and the number of samples per pixel that you told it on the command line. main character transformation energy, no cap.

but babes, listen — the PNG spec has limits on what counts as a valid combination of those two things. like, not every combo is allowed. 💀 and pngcp will literally tell you when you've handed it an invalid combination, so it's not gonna just quietly do something cursed.

🫶 real talk though: samples with more than eight bits are not correctly handled at the moment. that's just how it is right now. not me pretending otherwise.

🧚 RETURNS 🧚

Nothing. zero. zilch. it just does the thing. 🤷‍♀️

🌈 EXAMPLE 🌈

pngcp toucan.png new.png

toucan pic goes in, toucan pic comes out. iconic. 🦜💖

👑 SEE ALSO 👑

⭐ VERSION ⭐

This documentation is for pngtools 1.0.

💜 AUTHOR 💜

pngtools was written by Michael Still and is released under the GNU GPL. The project is hosted at https://github.com/mikalstill/pngtools.

🍓 BUGS 🍓

Please report bugs at https://github.com/mikalstill/pngtools/issues.

and that's the whole page, bestie!! 🎀 this lil writeup is part of the User Commands manual, and it's dated 10 June 2026 — go forth and convert your pixels, you absolute legend 💅🌸✨

📦 where this page comes from