NORMAL3D(1)

💅 NAME 💅

normal3d — bestie, this is the little icon that applies a transformation matrix inside a Raster3D input file ✨

It lives in the General Commands Manual, section 1, so you know it's a real one 💖

✨ SYNOPSIS ✨

normal3d [options] < infile.r3d > normalized.r3d

Like. That's it. Pipe in, pipe out, glow up achieved 🦋

🎀 DESCRIPTION 🎀

okay so here's the vibe: normal3d reads a Raster3D input file from stdin, applies whatever coordinate manipulations were specified up in the header, and writes the modified file straight to stdout. no cap, that's the whole job 💁‍♀️

The output file describes exactly the same image as the original input file. fr fr. The header records are left unchanged — except for the transformation matrix (which becomes the identity matrix) and the format specifiers (which get set to *). And if you pass the -h flag, it just fully suppresses all the header records in the output file. gone. not invited 💀

All objects in the input file are also in the output file — nothing ghosted — but their coordinate descriptions have been normalized (i.e. the original transformation matrix has been applied). so they're the same objects, just, like, settled into their final form 💅

🌸 OPTIONS 🌸

• -ang AA — only relevant when you're generating stereo pairs, iykyk. By default the stereo separation is created using a shear operator. But -ang instead introduces an angular separation by rotating the left and right eye images by +/- AA degrees with respect to the original view angle. rotate, queen 🔄
• -expand — in-line and normalize all instances of file indirection in the input stream. this gives you a single input file containing no file indirection at all. the default, btw, is to simply copy file indirection lines (the ones beginning with @) into the new input file without opening them or normalizing their contents. so if you want them expanded, you gotta say so 🫶
• -h — suppress header records in output. this one is lowkey useful for producing files that describe only part of a scene, which you then later combine with descriptor files 🎀
• -size HHHxVVV — force the image size to HHH pixels horizontal and VVV pixels vertical. control the canvas, bestie 🖼️
• -stereo [scratch] — this one makes the program produce two extra files, left.r3d and right.r3d, containing header records suitable for rendering the normalized object description file as a side-by-side stereo pair 👑 Heads up: this option always suppresses header records in the primary output file. And if you give it a scratch directory name, that name gets prepended, giving you output files {scratch}_left.r3d and {scratch}_right.r3d ✨

💜 SOURCE 💜

web URL:

http://www.bmsc.washington.edu/raster3d/raster3d.html

contact:

Ethan A Merritt
University of Washington, Seattle WA 98195
merritt@u.washington.edu

🦋 SEE ALSO 🦋

• render(l)
• raster3d(l)
• stereo3d(l)

the whole friend group, periodt 🌈

👑 AUTHORS 👑

Ethan A Merritt. (the goat, honestly 🫡)

and that's the page!! this one is from Raster3D, dated 12 Dec 2010 — shoutout to the OG release, she ate and left no crumbs 💖✨🎀