PUT(nged)

mged command which creates a new object of indicated type with supplied attributes. Similar to the in command, but without prompting - making it especially useful for scripting.

📅 published 7.44.0, from nixpkgs unstable

💖 PUT(nged) — put 💖

okay bestie, so this is <pink>put</pink>, a BRL-CAD User Command that lives in mged (the nged manual, iykyk) ✨

🌸 NAME 🌸

put — the mged command that creates a new object of indicated type with the attributes you supply 🫶 It's literally the in command, except no prompting — which makes it especially useful for scripting, no cap 💅

ngl, this is the one you want when you're automating stuff. in asks questions, put does not. periodt.

🎀 SYNOPSIS 🎀

put {object type} [attrs]...

✨ DESCRIPTION ✨

So it creates a new object of the type you indicate 💖 Here's the thing though — object attributes are per-object dependent, meaning every type does its own thing 😭 There are some similarities among different object types, like how both sph and ell have a vertex 'V' — cute, right? 🦋

To find out the possible attributes and how to form your parameters correctly, use the form command 👑

Possible values for type are:

  • annot — 2d annotations
  • arb8 — ARB (eight vertices)
  • arbn — ARB (n vertices)
  • ars — Arbitrary faceted solid
  • binunif — Uniform-array binary object
  • bot — bag of triangles
  • brep — Boundary Representation
  • cline — Cline element
  • comb — Combination
  • constrnt — Constraint
  • datum — Datum set
  • dsp — Displacement map
  • ebm — Extruded bitmap
  • ehy — Elliptical Hyperboloid
  • ell — Ellipsoid
  • epa — Elliptical Paraboloid
  • eto — Elliptical Torus
  • extrude — 2d Extrusion
  • grip — Support for joints
  • half — Half space
  • hrt — Heart
  • hyp — Hyperboloid
  • joint — Joint
  • material — Material
  • metaball — Metaball
  • nmg — Non-Manifold Geometry
  • part — Particle
  • pipe — Pipe
  • pnts — Collection of points
  • poly — Polygon
  • rec — Truncated General Cone (right elliptical cylinder)
  • revolve — Truncated general revolve
  • rhc — Right Hyperbolic Cylinder
  • rpc — Right Parabolic Cylinder
  • script — Procedural script
  • sketch — 2d sketch
  • sph — Ellipsoid (sphere)
  • submodel — Instanced submodel
  • superell — Superquadratic Ellipsoid
  • tgc — Truncated General Cone
  • tor — Torus
  • vol — 3d volume

like, that's a lot of types bestie 🍓 but you got this 💜

🦋 EXAMPLES 🦋

The following are run from the MGED command prompt 💫

Example 1. Create a sphere.

mged> put ball sph V {0 0 0} A {100 0 0} B {0 100 0} C {0 0 100}

Creates a sphere named "ball", centered at (0,0,0), and with radius 100 🔥 ate, honestly 👑

💜 AUTHOR 💜

BRL-CAD Team

🐛 BUG REPORTS 🐛

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org 📧 (yes, electronic mail, they're being fancy 🙈)

okay bestie, real talk: since put doesn't prompt you for anything, if you form your attributes wrong it's not gonna hold your hand 😭 hit up form first, fr fr.

💖 that's the whole page!! 💖 courtesy of BRL-CAD and this PUT(nged) page — go build something iconic bestie, ily 🎀🫶✨

📦 where this page comes from