pilot-read-palmpix(1)

📦
version 0.12.5_git20241124 · 2 versions
, in alpine 3.24

🌸 pilot-read-palmpix — the vibe check 💅

okay so bestie, grab a strawberry drink 🍓 because this one lives in section 1 of the PILOT-LINK manual and it's literally here to rescue your ancient Palm pics. no cap.

✨ NAME ✨

pilot-read-palmpix — converts, like, all the pictures sitting in the files you hand it, or the ones it finds chilling on a Palm handheld. iconic behaviour honestly 🫶

🦋 SECTION 🦋

pilot-link: Userland conduits. yes we're in the conduits club, welcome 💜

🎀 SYNOPSIS 🎀

 pilot-read-palmpix [-p|--port <port>] [--version] [-?|--help] [--usage]
[-q|--quiet] [-s|--stretch] [-c|--colour] [-t|--type [ppm|png]]
[-b|--bias  bias] [-l|--list] [-n|--name  name] [file] ...

 pilot-read-palmpix Image1.pdb Image2.pdb Image3.pdb

look at that second line — three whole .pdb files, she's thriving 😭🔥

💖 DESCRIPTION 💖

So if you're a Kodak PalmPix camera user (vintage, love that for you), pilot-read-palmpix lets you pull the images out of your Palm handheld and convert them into Portable Network Graphic (.png) or Portable Pixmap (.ppm) files right there on your system. the default output type? Portable Pixmap (.ppm). periodt.

And the main character move: pilot-read-palmpix converts all the pictures in the files you give it — or, if you give it no files at all, the pics on a Palm handheld — into Portable Pixmap files. simple as that ✨

⭐ OPTIONS ⭐

💅 pilot-read-palmpix options

  • -b, --bias bias — lightens or darkens the image. numbers 0..49 darken it, 51..100 lighten it. yes there's a gap at 50, don't come for me, that's just what it says 🙈
  • -c, --colour — does a simple colour correction. the colour correction code builds a histogram from the image, then uses that histogram to cook up a couple of colour tables to try and balance the colours. it also clips the top and bottom colours so the contrast looks better to your eyeballs. it's giving glow-up 🌈
  • -l, --list — lists the picture info found on the Palm handheld instead of converting the entries it found into image files. window shopping only 🎀
  • -n, --name <pixname> — converts only pixname to STDOUT, output as type: .ppm or .png. one pic, straight to your terminal, no notes 💫
  • -s, --stretch — does a histogram stretch on the colour planes. stretch it out bestie 🧚
  • -t, --type [ppm|png] — specifies the output picture type. can be either "png" or "ppm". that's the whole menu, pick one 🍓

🌸 Conduit Options

  • -p, --port port — use device file port to communicate with the Palm handheld. if you don't specify it, pilot-read-palmpix will go looking for the $PILOTPORT environment variable. if neither is found or supplied, pilot-read-palmpix prints the usage information. it's not mad, it's just disappointed 😭
  • -q, --quiet — suppresses the 'Hit HotSync button' message. peace and quiet, we love to see it 🤫
  • -v, --version — displays the version of pilot-read-palmpix and exits without connecting. no handshake, no commitment 💀

🦋 Help Options

  • -h, --help — displays the help synopsis for pilot-read-palmpix and exits without connecting. the assist has arrived 👑
  • --usage — displays a brief usage message and exits without connecting. short and sweet, fr fr ⭐

🌟 USAGE 🌟

If you don't hand it a filelist, it connects to the target Palm handheld and reads the images it finds in the Kodak PalmPix image database (ArchImage.pdb), and it lets you view the list of images and image details, or select one or all of them, and convert them to Portable Network Graphic (.png) or Portable Pixmap (.ppm) files so you can view or print them at the desktop. whole little photoshoot pipeline 💖

If no options are specified at all, all of the images on the device get converted to ppm files by default. defaults are undefeated.

If a filelist is given, it converts all the listed files that you previously fetched via pilot-xfer. but heads up — see BUGS: a single file argument is ignored, a list will work. one file? ignored. a list? slay. iykyk 😭

🫶 AUTHOR 🫶

pilot-read-palmpix was originally written by Angus Ainslie <angusa at deltatee.com > ,and updated by John Marshall <jmarshall@acm.org> to include core pilot-link functionality.

This manual page was converted to XML by Neil Williams <linux@codehelp.co.uk> 🧚

💀 BUGS 💀

🙈 Known Bugs

pilot-read-palmpix's colour correction is nearly as good as Kodak's own — but Kodak has deprecated the PalmPix device, so it's not likely there will ever be any updates to their software in the future, so this may be as good as it gets. ngl, that's the whole mood. a simple method to improve the look of colours is to do a histogram equalization in your favourite image editor. DIY era ✨

And the big one, listen up: the pilot-read-palmpix command DOES read from a file, but only if you specify a LIST of files. if only one file is given, the command tries reading from $PILOTPORT. not me finding this out the hard way 😭

🔥 Reporting Bugs

We have an online bug tracker. using it is the only way to ensure that your bugs are recorded and that we can track them until they are resolved or closed. reporting bugs via email, while easy, is not very useful in terms of accountability. please point your browser to http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your bugs and issues there. the tracker is the main character here, respectfully 👑

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

🌈 SEE ALSO 🌈

and that's the whole page bestie 💫 this lil rewrite is version 0.13.0, brought to you by Copyright 1996-2007 FSF, and it's still filed under pilot-read-palmpix(1) — mwah, go convert some grainy palm pics 🎀💜🦋

📦 where this page comes from