MITER(1)

💖 MITER — bestie's guide to the lil renderer that could ✨

okay so this is the manual page for miter, from the User Commands corner of the man pages. no cap, it's a simple but effective little volume renderer — and honestly? she ate. 💅

---

🌸 NAME 🌸

miter — a simple but effective little volume renderer 🦋

---

✨ SYNOPSIS ✨

bestie, look at this. it's a lot. breathe. it's fine. 🫶

miter [@file ...]  [-i <nsin>] [-vi <nvin>] [-ti <ntin>] -txf <nin ...>
-fr <eye pos> [-at <at pos>] [-up <up dir>] [-rh] [-or] -dn <near> -di
<image> -df <far> [-ar] [-ur <uMin uMax>] [-vr <vMin vMax>] [-fv
<field of view>] [-offfr] [-fr <fake from>] [-turn <angle>] [-am
<ambient>] [-ld <light pos>] [-is <image size>] [-iss <scale>] [-ads
<ka kd ks>] [-sp <spec pow>] [-k00 <kernel>] [-k11 <kernel>] [-k22
<kernel>] [-ss <shading spec>] [-ns <normal spec>] [-side <normal side>]
[-rn] [-gmc <min gradmag>] [-step <size>] [-ref <size>] [-vp
<verbosepixel>] [-n1 <near1>] [-nt <# threads>] [-o <filename>]

fr fr, if that stressed you out, the OPTIONS section below has your back. 🧚

little heads up: -ar shows up in the synopsis but the options list doesn't describe it. not me noticing that. 🙈 anyway, moving on!

---

👑 OPTIONS 👑

• @file ... — response file(s) containing command-line arguments. yes, the args can live in a file, and honestly? main character energy. 📄
• -i <nsin> — input scalar volume to render (nrrd); default: ""
• -vi <nvin> — input vector volume to render (nrrd); default: ""
• -ti <ntin> — input tensor volume to render (nrrd); default: ""
• -txf <nin ...> — one or more transfer functions (1 or more nrrds). plural. she's flexible like that. 💜
• -fr <eye pos> — camera eye point (3 doubles). this is where the camera is at, bestie. 👁️
• -at <at pos> — camera look-at point (3 doubles); default: 0 0 0
• -up <up dir> — camera pseudo-up vector (3 doubles); default: 0 0 1
• -rh — use a right-handed UVN frame (V points down). lowkey the V goes down, that's the whole thing. ⬇️
• -or — orthogonal (not perspective) projection. no vanishing point, no drama. 🔥
• -dn <near> — distance to near clipping plane (double)
• -di <image> — distance to image plane (double)
• -df <far> — distance to far clipping plane (double)
• -ur <uMin uMax> — range in U direction of image plane (2 doubles)
• -vr <vMin vMax> — range in V direction of image plane (2 doubles)
• -fv <field of view> — angle (in degrees) vertically subtended by view window (double); default: 20
• -offfr — the given eye point (-fr) is to be interpreted as an offset from the at point. 👀 it's a relative situation.
• -ffr <fake from> — eye point to use for view-dependent transfer functions. By default (not using this option), the point used is the normally specified camera eye point. (3 doubles) — fake from, real results. 💅
• -turn <angle> — angle (degrees) by which to rotate the from point around true up, for making stereo pairs. Positive means move towards positive U (the right) (double); default: 0.0. stereo pairs bestie!! 🎀
• -am <ambient> — ambient light color (3 floats); default: 1 1 1
• -ld <light pos> — view space light position (extended to infinity) (3 floats); default: 0 0 -1. extended to infinity. she's endless. ✨
• -is <image size> — image dimensions (2 ints); default: 256 256
• -iss <scale> — scaling of image size (from -is) (float); default: 1.0
• -ads <ka kd ks> — phong components (3 floats); default: 0.1 0.6 0.3
• -sp <ka kd ks> — phong specular power (double);default: 30 (yes, that's exactly how it's written in the original — double);default: with no space, iconic typo, no notes 💀)
• -k00 <kernel> — value reconstruction kernel (kernel specification); default: tent
• -k11 <kernel> — first derivative kernel (kernel specification); default: cubicd:1,0
• -k22 <kernel> — second derivative kernel (kernel specification); default: cubicdd:1,0
• -ss <shading spec> — how to do shading (string); default: phong:gage(scalar:n)
• -ns <normal spec> — normal to use for those miteVal's that need one (string); default: ""
• -side <normal side> — how to interpret gradients as normals:
  • 1: normal points to lower values (higher == more "inside")
  • 0: "two-sided": dot-products are abs()'ed
  • -1: normal points to higher values (lower == more "inside")

default: 1

• -rn — renormalize kernel weights at each new sample location. "Accurate" kernels don't need this; doing it always makes things go slower.
• -gmc <min gradmag> — For curvature-based transfer functions, set curvature to zero when gradient magnitude is below this (double); default: 0.0

⚠️ ngl bestie, in the original page the -rn blurb and -gmc are mushed together in one blob. i split them for readability but the facts are all there, untouched. 🫶

• -step <size> — step size along ray in world space (double); default: 0.01
• -ref <size> — "reference" step size (world space) for doing opacity correction in compositing (double); default: 0.01
• -vp <verbose pixel> — pixel for which to turn on verbose messages (2 ints); default: -1 -1. one pixel gets to be the loud one. 😭
• -n1 <near1> — opacity close enough to 1.0 to terminate ray (double); default: 0.99. she stops when she's basically opaque. periodt.
• -nt <# threads> — number of threads hoover should use (int); default: 1. (yes it says "hoover" — that's the original, and we respect it 🧹)
• -o <filename> — file to write output nrrd to (string); default: -. a - means stdout vibes, iykyk.

---

🌈 SEE ALSO 🌈

go hang out with the rest of the family, they're all iconic too:

gprobe(1), ilk(1), mrender(1), nrrdSanity(1), overrgb(1), puller(1), tend(1), unu(1), vprobe(1)

---

and that's the whole page, bestie!! this drop is from April 2021, and it's living in section MITER(1). go render something gorgeous. 💖✨🎀🦋