CAMERATOPAM(1)

🎀 NAME 🎀

cameratopam — convert raw camera image to PAM 💖

---

📸 SYNOPSIS 📸

cameratopam

[input_file_name]

[-identify_only] [-quick_interpolate] [-half_size] [-four_color_rgb]
[-document_mode] [-balance_auto] [-balance_camera] [-red_scale=float]
[-blue_scale=float] [-brightness=fraction] [-no_clip_color] [-rgb]
[-secondary] [-linear] [-verbose]

okay bestie, housekeeping first: every single option can be abbreviated down to its shortest unique prefix. You can also use two hyphens instead of one if that's your vibe, and you can put either white space or an equals sign between an option name and its value. Whatever floats your boat 🛶

---

🌸 DESCRIPTION 🌸

This program is part of Netpbm(1).

cameratopam converts from any of dozens of raw camera image formats to PAM. Dozens!! dozens ✨

So here's the tea ☕: digital still cameras often can produce images in a special raw format in addition to something more standard such as TIFF or JFIF (JPEG). The software that ships with the camera lets you manipulate the image using information which is lost when the camera converts to the common format. And a particular camera model often has a unique raw format — so like, every camera's raw is doing its own little main character thing 👑

---

✨ OPTIONS ✨

On top of the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), cameratopam recognizes the following command line options:

• -identify_only — Report to Standard Error the format of the input image but don't generate an output image. Program fails if it cannot recognize the format. It's giving "just tell me what you are, no pictures" 😭
• -verbose — Report to Standard Error details of the processing. She's chatty, she's sharing the lore 🗣️
• -quick_interpolate — Use simple bilinear interpolation for quick results. The default is to use a slow, high-quality adaptive algorithm. So yeah, fast and mid vs slow and gorgeous, pick your fighter 🥊
• -half_size — Half-size the output image. Instead of interpolating, reduce each 2x2 block of sensors to one pixel. Much faster than -quick_interpolate. zoom zoom 🏎️
• -four_color_rgb — Interpolate RGB as four colors. This causes a slight loss of detail, so use this only if you see false 2x2 mesh patterns in blue sky. Fixes the sky, costs you a lil detail, we love a tradeoff 💅
• -document_mode — Show the raw data as a grayscale image with no interpolation. This is good for photographing black and white documents. Scandocs found ✨📄
• -balance_auto — Automatic color balance. The default is to use a fixed color balance based on a white card photographed in sunlight. Let the algorithm cook 🧑🍳
• -balance_camera — Use the color balance specified by the camera. If cameratopam can't find this, it prints a warning and reverts to the default. She'll warn you and then just do the default thing, no biggie 🫶
• -red_scale=float
• -blue_scalefloat — Further adjust the color balance by multiplying the red and blue channels by these values. Both default to 1.0. So like, crank it if you must 🌡️
• -brightness=float — Change the output brightness. Default is 1.0. 🌞
• -no_clip_color — By default, cameratoapm clips all colors to prevent pink hues in the highlights. Combine this option with -brightness=0.25 to leave the image data completely unclipped. Fully unclipped, fully raw, fully iconic 💖
• -rgb — Write raw camera colors to the output file. By default, cameratoapm converts to sRGB colorspace. 🎨
• -secondary — For cameras based on the Fuji Super CCD SR, this option causes cameratopam to use the secondary sensors, in effect underexposing the image by four stops to reveal detail in the highlights. cameratopam silently ignores this option for all other cameras. Not your camera? She will not even acknowledge it. ghosted 💀
• -linear — This option causes cameratopam to generate a variation on PAM that has "linear" color samples. In true PAM, each sample in the image raster is gamma-corrected; i.e. it is essentially proportional to brightness. With the linear option, cameratopam generates an image in which the samples are instead proportional to light intensity.

Without -linear, the image maxval is 255, so the image contains one byte per sample. With -linear, the maxval is 65535, so the image contains two bytes per sample.

Without -linear, cameratopam uses a 99th percentile white point. With -linear, it doesn't. I don't know what that means. 😅 genuinely no clue bestie, I'm just the messenger 🧚

---

🔗 SEE ALSO 🔗

411toppm(1), pamflip(1), pam(1),

---

📜 HISTORY 📜

cameratopam was new in Netpbm 10.28 (June 2005). ⭐

It was derived from the program dcraw by Dave Coffin , by Bryan Henderson in April 2005. Bryan replaced the part that generates the Netpbm output image and removed the Adobe Photoshop output function. Bryan changed the command syntax and made other small changes to make the program consistent with Netpbm. He also split the source code into manageable pieces (dcraw had a single 5000 line source file). 5000 lines?! In ONE file?! not me screaming 😭 she got a glow-up fr fr

---

📄 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/cameratopam.html

---

and that's the whole page bestie 🫶 this came to you straight from the netpbm documentation, dated 12 April 2005 — Cameratopam User Manual(1). periodt. 💅✨