DATA_LINES(nged)

💅 DATA_LINES(nged) — the glow-up guide

okay bestie, so this is a page from the BRL-CAD User Commands manual, and it's about data_lines. it lives in the nged family, and honestly? it's lowkey iconic for overlays. let's get into it 🎀

---

✨ NAME ✨

data_lines — manage an arbitrary line set attached to the current view. that's it, that's the vibe 💫

---

🌸 SYNOPSIS 🌸

here's every single way you can call it, no cap, nothing skipped:

data_lines draw [0|1]
data_lines color [r g b]
data_lines line_width [width]
data_lines points [{{x y z} {x y z} ...}]
data_lines snap [0|1]
view data_lines draw [0|1]
view data_lines color [r g b]
view data_lines line_width [width]
view data_lines points [{{x y z} {x y z} ...}]
view data_lines snap [0|1]

like, both the plain form and the view-prefixed form exist, and they do the same thing. twin energy fr fr 👯‍♀️

---

🦋 DESCRIPTION 🦋

so data_lines manages a view-associated line set that is not tied to database geometry. think of it as your little aesthetic scratchpad for the view — it's useful for temporary guide lines, annotations, and other visual overlays. main character overlay energy, honestly 💅

the command accepts the following subcommands:

• draw — report or set whether the line set should be drawn. yes queen, toggle your visibility ✨
• color — report or set the RGB color used for the line set. serve looks 🌈
• line_width — report or set the line width. thick or thin, your call 💖
• points — report or set the Tcl-style list of line endpoints. ⚠️ important: points are consumed in pairs, so the list must contain an even number of 3D points. odd numbers? not today bestie, it will not slay.
• snap — report or set the current view's line-snapping flag. snapping on = that magnetic precision 🧲

ngl the whole "report or set" thing is the move here: give it an argument and you're setting, give it nothing and it reports back at you. very responsive, very communicative 🫶

the same functionality is also available through the view data_lines ... command form. same powers, different door 🚪

also hi — the related sdata_lines command uses the same subcommands on a separate line set maintained by the current view. so don't confuse the two, they're siblings, not twins 👑

---

🔥 EXAMPLES 🔥

Example 1. Create and display red guide lines in the current view.

verbatim, character for character, because i would never touch your commands:

mged> data_lines points {{0 -1000 0} {0 1000 0} {100 -1000 0} {100
1000 0}} mged> data_lines color 255 0 0 mged> data_lines line_width
100 mged> data_lines draw 1

what this does, bestie: defines two vertical guide lines, colors them red, sets a wider line width, and turns drawing on for the line set. red lines, chunky width, visible — absolute serve 🔥🍓

---

💜 SEE ALSO 💜

go read these next, iykyk:

• sdata_lines(nged)
• view(nged)

---

👑 AUTHOR 👑

BRL-CAD Team — the ones who built this. thank them, they ate 💐

---

🙈 BUG REPORTS 🙈

reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. like, if something's acting up, don't suffer in silence — tell the devs, fr fr 😭📬

---

💀 reminder to self: points needs an even number of 3D points. pairs only. no solo points allowed. periodt.

okay that's the whole page!! this was from the BRL-CAD manual, page DATA_LINES(nged) — original footer vibes and all 🎀✨💖