img-pcx(n)

img-pcx 💅

okay bestie, welcome to the Paintbrush corner of the Img manual — this page is img-pcx(n), like, the manual-entry-flavoured one. we're talking the Tcl/Tk Img family, and this is the .pcx handler. let's go 🎀

---

✨ NAME ✨

img-pcx — Paintbrush format (pcx). that's it, that's the whole vibe. 🖌️

---

✨ SYNOPSIS ✨

package require img::pcx ?2.1?

---

✨ DESCRIPTION ✨

package require img::pcx

so here's the thing, bestie: like every single package in Img, this one does not hand you new commands. nope. it extends the Tk command image that you already know and love, so that image suddenly supports files holding raster images in the Paintbrush format (pcx). more specifically, img::pcx extends Tk's photo image type — yeah, that one: https://www.tcl.tk/man/tcl9.0/TkCmd/photo.html. 🦋

the name of the new format handler is pcx. and this handler brings new additional configuration options with it. slide into the Options section for the full tea. 💅

all of the above means that in a call like:

image create photo ?name? ?options?

1. image data in pcx format (the options -data and -file) is detected automatically. no cap, you don't have to tell it. ✨
2. the format name pcx is recognized by the option -format. 👑

plus — and this is the cute part — the value of option -format is treated as a list and may contain any of the special options listed in section Options. it's giving multitasking icon.

the package img::pcx is a sub-package of Img. you can load it as a part of the complete Img support via package require Img, or on its own via package require img::pcx. either way she's ready. 🫶

---

🌈 SUPPORTED TYPES 🌈

this format handler supports the following image types:

• 1-bit pixels: Black and White. 🖤🤍
• 8-bit pixels: Grayscale or indexed. 🌫️
• 24-bit pixels: Truecolor (RGB, 8-bit channels). 🎨

and every single one of those image types may be either uncompressed or run-length encoded. slay.

now the read/write receipts, laid out nice for you:

• 1-bit — read via -file: Yes · read via -data: Yes · write via -file: No · write via -data: No
• 8-bit — read via -file: Yes · read via -data: Yes · write via -file: No · write via -data: No
• 24-bit — read via -file: Yes · read via -data: Yes · write via -file: Yes · write via -data: Yes

so like… she reads everything but she only writes 24-bit. know your limits, queen. 💀

---

📝 NOTES 📝

1. Chapter Image Metadata of the Img manual page describes the parameters of the resolution related options. go read that if you're nosy (affectionate). 🙈

---

💖 OPTIONS 💖

the handler provides the following options:

• -verbose bool — this option is supported for reading and writing. available since version 1.3. if set to true, additional information about the read or written image is printed to stdout. default is false. so basically it narrates what it's doing. main character behaviour honestly. 🗣️
• -compression string — this option is supported for writing only. available since version 1.3. set the compression mode to either none or rle. default is rle. 🗜️
• -resolution xres ?yres? — this option is supported for writing only. available since version 2.0. set the resolution values of the written image file. if yres is not specified, it is set to the value of xres (she matches her own energy, iconic). if the option is not specified, the DPI and aspect values of the metadata dictionary are written. if no metadata values are available, no resolution values are written. 📐
• -xresolution xres — this option is supported for writing only. available since version 2.0. set the horizontal resolution value of the written image file. ➡️
• -yresolution yres — this option is supported for writing only. available since version 2.0. set the vertical resolution value of the written image file. ⬇️

heads up bestie: -compression, -resolution, -xresolution and -yresolution are write-only. don't try to read with them, it's not that kind of party. 🚫

---

👀 SEE ALSO 👀

img, img-bmp, img-dted, img-flir, img-gif, img-ico, img-jpeg, img-pcx, img-pixmap, img-png, img-ppm, img-ps, img-raw, img-sgi, img-sun, img-tga, img-tiff, img-window, img-xbm, img-xpm

(yes, img-pcx is listed in the see-also of img-pcx. she contains multitudes. self-love. 💅)

---

©️ COPYRIGHT ©️

Copyright (c) 1995-2025 Jan Nijtmans <nijtmans@users.sourceforge.net> Copyright (c) 2002-2025 Andreas Kupries <andreas_kupries@users.sourceforge.net> Copyright (c) 2003-2025 Paul Obermeier <obermeier@users.sourceforge.net>

---

and that's the whole page, bestie! this lil' beauty is img-pcx, version 2.1 — straight out of the img-pcx(n) manual entry, date and all. go forth and read your Paintbrush files. mwah. 💖✨🎀🦋🌸🫶