DSP(nged)

💅 DSP(nged) — bestie's guide to DSP primitives ✨

okay so real talk, this is the dsp command from the BRL-CAD user commands, and it's literally here to help you query or compare DSP (Displacement Map Surface) primitive objects. no cap. 🎀

---

🌸 SYNOPSIS 🌸

dsp object xy x y
dsp object diff obj2 [min_diff_val]

✨ DESCRIPTION ✨

so the dsp command gives you two subcommands for snooping on DSP (Displacement Map Surface) primitive objects. and what even is a DSP primitive? glad you asked bestie — it represents a height-field terrain surface derived from a 2D raster data source, with integer height values on a uniform grid. terrain vibes. 🏔️

both subcommands need the database to be open — like, that's non-negotiable. and the object argument has to name an existing DSP primitive. no fake ones, no imaginary ones. 💅

🦋 Subcommands 🦋

• xy x y — reports the integer height value stored at grid coordinates (x, y) inside the DSP object object. the coordinates are zero-based grid indices. if the coordinate is outside the bounds of the DSP grid, you get an error. periodt. 💀
• diff obj2 [min_diff_val] — compares the height values of object and obj2 at every grid coordinate. heads up: the two DSP objects must have the same grid dimensions or this whole thing falls apart. it prints each (x,y) position plus the magnitude of the height difference wherever the values differ. and if you pass min_diff_val, only differences greater than or equal to that value get reported. filtered. iconic. 🔥

---

⭐ EXAMPLES ⭐

Example 1. Query the height at a grid coordinate

mged> dsp terrain.dsp xy 50 30

returns the height value stored at grid position (50, 30) in terrain.dsp — for example: 1024. slay. 👑

Example 2. Query a coordinate at the grid origin

mged> dsp terrain.dsp xy 0 0

returns the height at grid position (0, 0). origin behavior. we love to see it. 🌱

Example 3. Compare two DSP objects

mged> dsp terrain.dsp diff terrain_modified.dsp

reports all grid positions where terrain.dsp and terrain_modified.dsp have different height values, with the magnitude of each difference. the way it just tells you everything 😭

Example 4. Compare with a minimum difference threshold

mged> dsp terrain.dsp diff terrain_modified.dsp 10

reports only grid positions where the height difference between the two DSP objects is 10 or greater. lowkey the useful one tbh. 🍓

---

🧚 SEE ALSO 🧚

• in(nged)
• make(nged)

💜 AUTHOR 💜

BRL-CAD Team — the main characters fr fr 🫶

🙈 BUG REPORTS 🙈

if you find bugs or problems, report them via electronic mail to devs@brlcad.org. don't suffer in silence bestie, tell the devs. 📬

---

ngl that's the whole page — every flag, every coordinate, every threshold. go query some terrain. 💖

BRL-CAD · DSP(nged) — mwah, that's the version and date footer, catch you in the next manpage 🌈✨