SOLIDS_ON_RAY(nged)

list all primitives intersected by a ray through a display point

📅 published 7.44.0, from nixpkgs unstable

💅 SOLIDS_ON_RAY (nged) 💅

okay bestie, so this one lives in the BRL-CAD User Commands family (the nged manual, iykyk) and honestly? it's giving detective energy. You point at a spot on your screen, and it tells you every single primitive solid your imaginary laser beam ran into. Lowkey iconic. 🔥

✨ NAME ✨

solids_on_ray — lists all the primitives that get intersected by a ray shot through a display point 🎯

🦋 SYNOPSIS 🦋

solids_on_ray h v

🌸 DESCRIPTION 🌸

So here's the vibe: solids_on_ray fires a ray through the current view, straight out from the screen position (h, v). That position is in normalized display coordinates, and the one thing you gotta remember is that 0,0 is the view center. The ray then reports back every single primitive solid it smacked into. no cap. 💅

The ray originates from the current view center and travels in the viewing direction at the specified screen offset. And it doesn't play favorites — all currently displayed objects get tested for intersection. everyone's invited to the vibe check. ✨

Both the h and v arguments are required, bestie. Omit them and it hits you with a usage error — not me forgetting, that's just the rules 😭. Also, the values have to be within the valid display bounds, so don't go sending it somewhere off-screen.

The output lists the full paths of all the primitives it hit, and it does it in the order they're encountered along the ray — so it's basically a receipt of your laser's whole journey. 🧚

🎀 EXAMPLES 🎀

Example 1. Find solids at the center of the view

mged> solids_on_ray 0 0

Fires a ray straight through the center of the current view and lists every primitive solid sitting along that ray. main character ray behavior honestly. 👑

Example 2. Find solids at an offset position

mged> solids_on_ray 100 50

Fires a ray 100 units right and 50 units up from the view center, then lists the intersected primitives. slay. 🌈

💜 SEE ALSO 💜

  • nirt(nged)
  • who(nged)

🫶 AUTHOR 🫶

BRL-CAD Team — we stan 💖

💀 BUG REPORTS 💀

Found a bug or a problem? Don't suffer in silence, bestie — send it via electronic mail to devs@brlcad.org 📧

and that's the whole page, periodt ✨ This one's from the BRL-CAD fam — page SOLIDS_ON_RAY(nged), mwah, go shoot some rays 💅🎀🦋

📦 where this page comes from