PBMTOMACP(1)

📦
version 11.13.03 · 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Pbmtomacp User Manual 💖

okay bestie, welcome to pbmtomacp — it lives in the General Commands Manual section and it's literally here to turn your PBM pics into MacPaint files. no cap. let's get into it 🎀

✨ NAME ✨

pbmtomacp — convert a PBM image to a MacPaint file

🌸 SYNOPSIS 🌸

pbmtomacp [-left left]

          [-right right]

          [-top top]

          [-bottom bottom]

          [pbmfile]

quick lil rules of the game, and yes these are real:

  • All options can be abbreviated to their shortest unique prefix.
  • You may use two hyphens instead of one to designate an option. (so --left hits the same, iykyk)
  • You may use either white space or equals signs between an option name and its value.

🦋 DESCRIPTION 🦋

so this program is part of Netpbm(1), obvi. 💅

Here's the tea: pbmtomacp reads a PBM image as input and produces a MacPaint file as output. that's the whole job. iconic.

If you do not specify pbmfile, pbmtomacp uses Standard Input. classic.

⚠️ heads up bestie, this one matters: the generated file is only the data fork of a picture. You will need a program such as mcvert to generate a Macbinary or a BinHex file that contains the necessary information to identify the file as a PNTG file to MacOS. so don't come crying to me when MacOS doesn't recognize your lil file, okay?? 🥺

🎀 OPTIONS 🎀

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

  • -norle — this one tells pbmtomacp not to use any run length encoding compression in the MacPaint image it produces. That output, while not normal, conforms to MacPaint specifications and can be read by any MacPaint decoder without any special settings. fr fr. ✨

lowkey the only value of this option is testing and experimentation. The option causes every output image to contain exactly 53072 bytes, which is the theoretical maximum size for a MacPaint image. yes, every single one. 💀

Without -norle, MacPaint compresses the image as much as possible and the output size depends on the nature of the input. so it's giving "depends on the vibe of your image." 🦋

  • -left, -right, -top, -bottom — these options let you define a rectangle within the image to convert. The default is the whole file. If the specified image is too large for a MacPaint-file, pbmtomacp cuts the image to fit, starting at the specified top left corner. ✂️

These options exist for backward compatibility with an unfortunate original design. 😭 They do the same thing that you can do in a more Netpbm-like way and more flexibly by processing the input through pamcut. so like, they work, but bestie… there's a better way now. 💅

👑 SEE ALSO 👑

macptopbm(1), ppmtopict(1), pamcut(1), pbm(1), mcvert documentation

🌈 HISTORY 🌈

pbmtomacp was added to Netpbm in 1988, written by Douwe van der Schaaf (...!mcvax!uvapsy!vdschaaf). throwback era. ⭐

In 2015, Akira Urushibata replaced the program with the current version, using different logic and none of the original code. The new version used the "packed PBM" facilities of the Netpbm library and the shhopt method of command line parsing. glow-up, honestly. 🧚

💜 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/pbmtomacp.html

that's the whole page babes 🫶 this was netpbm documentation, dated 26 April 2015, and it's the Pbmtomacp User Manual. go convert something cute, and remember: data fork only, mkay?? mwah 💖🌸🎀

📦 where this page comes from