PNMSTITCH(1)

💖 PNMSTITCH(1) — Pnmstitch User Manual 💖

okay bestie, welcome to the General Commands Manual section, we're talking about pnmstitch today and honestly? it's giving panorama-gluing icon. let's go 🫶

---

✨ NAME ✨

pnmstitch — stitch together two panoramic (side-by-side) photographs 🌸

---

✨ SYNOPSIS ✨

pnmstitch [ [left_filespec] right_filespec | left_filespec
right_filespec output_filespec ] [-width=width] [-height=height]
[-xrightpos=column] [-yrightpos=row] [-stitcher={RotateSliver,
BiLinearSliver,LinearSliver}] [-filter={LineAtATime,HorizontalCrop}]
[-output=output_filespec] [-verbose]

All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one. You may separate an option name and its value with white space instead of an equals sign. yes really, she's flexible like that 💅

---

✨ DESCRIPTION ✨

This program is part of Netpbm(1). 💖

pnmstitch stitches together two panoramic photographs. like, imagine you're standing in front of something SO huge that one camera frame simply cannot contain it — you take a pic of the left side, you take a pic of the right side, and then pnmstitch joins them into one wide picture. main character behavior tbh. 📸

pnmstitch works only on side-by-side images, not top and bottom. (though bestie, you could absolutely use pamflip in combination with pnmstitch to achieve that, no cap.) It stitches together two images, but you can use it repeatedly to stitch together as many as you need to. 👑

Your photographs must overlap in order for pnmstitch to work, and the overlap should be substantial — fr fr, this is not optional. pnmstitch shifts and stretches the right hand image to match it up with the left hand image. You probably want to crop the result with pamcut to make a nice rectangular image. ✂️✨

If you're just trying to join (concatenate) two images at their edges, use pamcat instead — different tool, different vibe. 🐱

The left_filespec and right_filespec arguments are the specifications (names) of the PNM files containing the left hand and right hand images. Here's the tea on how they behave:

• If you specify only right_filespec, the left hand image comes from Standard Input.
• If you specify neither, both images come from Standard Input as a multi-image file containing first the left and then the right image. 🦋

output_filespec is the specification (name) of the output PNM file. The -output option also specifies the output file. You cannot specify both the argument and the option. If you specify neither, the output goes to Standard Output. periodt. 💅

---

✨ OPTIONS ✨

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

• -width=width — a constraint on where pnmstitch stitches the images together.
• -height=height — also a constraint on where pnmstitch stitches the images together.
• -xrightpos=column — constraint on the stitch location. For the LinearSliver method, column tells what location in the right hand image matches up to the top right corner of the left hand image. 📍
• -yrightpos=row — constraint on the stitch location. For the LinearSliver method, row tells what location in the right hand image matches up to the top right corner of the left hand image. 📍
• -stitcher={RotateSliver,BiLinearSliver,LinearSliver} — picks the stitching method. The default is RotateSliver. 🌈
• -filter={LineAtATime,HorizontalCrop} — No details available. 🙈 (yes, that's genuinely all we got, don't come for me)
• -output=output_filespec — name of output file. If you don't specify this option, the output image goes to Standard Output. 🎀
• -verbose — this option causes pnmstitch to issue messages to Standard Error about the stitching process. living out loud, narrating her own journey fr 💬

---

✨ SEE ALSO ✨

pamcut(1), pamcat(1), pamflip(1), pnm(1),

---

✨ HISTORY ✨

This program was added to Netpbm in Release 10.7 (August 2002). a true vintage queen 👑

---

✨ 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/pnmstitch.html

---

and that's the whole page, bestie!! shoutout to netpbm documentation, dated July 2002 💜 — go stitch something wide, you've got this. 🦋✨💅