TEEM(1)

💖 TEEM(1) — user commands, but make it cute 💖

okay bestie, welcome to the manual page for teem-overrgb, part of the TEEM fam. yes it's a section 1 user command, yes it's giving ✨utility✨, and yes i'm about to walk you through every single flag because we don't gatekeep here. 🫶

🌸 NAME 🌸

teem-overrgb — composites an RGBA nrrd over a background color. that's it, that's the whole vibe. no cap.

✨ SYNOPSIS ✨

teem-overrgb -i <nin> [-c <contrast>] [-cfp <fixed point>] \fR

[-g <gamma>] [-b <background>] [-bi <nbg>] -o <filename>

(yes the \fR is in there, it's a troff thing, we leave it alone, we respect it 💅)

🦋 DESCRIPTION 🦋

./teem-overrgb composites an RGBA nrrd over a background color (or image), after doing gamma correction, then quantizes to an 8-bit image. slay. literally.

okay so here's the tea 🍓 — the input nrrd can have more than 4 values per pixel, but only the first four are used. the other ones are just... there. background characters. main character energy only for the first four.

if the RGBA nrrd is floating point, the values are taken at face value. if it is fixed point, the values are interpreted as having been quantized (so that 8-bit RGBA images will act as you expect). no guessing, that's just how it is, iykyk.

when compositing with a background image, the given background image does not have to be the same size as the input image — it will be resampled (with linear interpolation) to fit. it's flexible like that. 🌈

🎀 the options 🎀

• -i <nin> — input nrrd to composite (nrrd)
• -c <contrast> — contrast to apply to RGB values, before gamma. "0.0" means no change, "1.0" means thresholding, "-1.0" means a complete washout. (double); default: "0.0"
• -cfp <fixed point> — component level that doesn't change with contrast (double); default: "0.5"
• -g <gamma> — gamma to apply to image data, after contrast (double); default: "1.0"
• -b <background> — background color to composite against; white is 1 1 1, not 255 255 255. (3 doubles); default: "0 0 0"
• -bi <nbg> — 8-bit RGB background image to composite against (nrrd); default: ""
• -o <filename> — file to write output PPM image to (string)

bestie pls note: -b takes 1 1 1 for white, not 255 255 255. this is the number one way people mess this up and i will not let it happen to you. 💀

👑 SEE ALSO 👑

The full documentation for teem-overrgb is maintained as a Texinfo manual. if the info and teem-overrgb programs are properly installed at your site, the command

info teem-overrgb

should give you access to the complete manual. go read it, it's free knowledge and free knowledge is iconic. ⭐

and that's the whole page bestie!! this was TEEM version 1.10.0, dated December 10, 2008 — yeah she's a vintage queen, an elder icon, and she still eats. 💜✨🎀