IN(nged)

💅 in — the IN(nged) manual page, but make it make sense 💅

okay so this is the BRL-CAD User Commands page for in, and it's genuinely giving “type the args, make a shape, slay.” The manual name is IN(nged) — that's the vibe check for this whole page. ✨

🌸 NAME 🌸

in lets you type in the arguments needed to create a shape with the name new_shape_name of the type shape_type. You can invoke the command with no arguments, and it will prompt you for all needed information. No cap, it'll walk you through it. 🫶

✨ SYNOPSIS ✨

in [[-f] | [-s]] [new_shape_name] [shape_type] {parameters}

💖 DESCRIPTION 💖

This command is the whole “type the arguments, get a shape” pipeline. It allows you to type in the arguments needed to create a shape with the name new_shape_name of the type shape_type. The command may be invoked with no arguments, and it will prompt the user for all needed information. Literally the chillest way to get prompted through the whole thing. 💬

The two flags are giving very different energy:

• -s — invokes primitive edit mode on the new shape immediately after creation. Immediately after, not later. Iconic.
• -f — does not draw the new shape, and because of that, -s may not be used in conjunction with -f. Do not try to combo them; the page says no.

The possible values for shape_type are literally these — every single one, no skipping:

• arb8 — ARB (eight vertices)
• arb7 — ARB (seven vertices)
• arb 6 — ARB (six vertices)
• arb 5 — ARB (five vertices)
• arb 4 — ARB (four vertices)
• arbn — Arbitrary polyhedron with arbitrary number of vertices (plane equations)
• bot — Bag of Triangles
• dsp — Displacement Map
• pipe — Pipe (run of connected pipe or wire)
• ebm — Extruded Bit Map
• vol — Voxels
• hf — Height Field deprecated, see dsp
• ars — Arbitrary Faceted Solid
• half — Half Space
• sph — Ellipsoid (center and radius)
• ell — Ellipsoid (center and three semi-axes)
• ellg — Ellipsoid (foci and chord length)
• ell1 — Ellipsoid (center, one semi-axis, and a radius of revolution)
• tor — Torus
• tgc — Truncated General Cone (most general TGC)
• tec — TGC (top radii are scaled from base radii)
• rec — TGC (right elliptical cylinder)
• trc — TGC (truncated right circular cone)
• rcc — TGC (right circular cylinder)
• box — ARB (vertex and three vectors)
• raw — ARB (right angle wedge)
• rpp — ARB (axis aligned rectangular parallelepiped)
• rpc — Right Parabolic Cylinder
• rhc — Right Hyperbolic Cylinder
• epa — Elliptical Paraboloid
• ehy — Elliptical Hyperboloid
• eto — Elliptical Torus
• part — Particle
• ebm — Extruded Bitmap
• datum — Datum Point, Line, Plane

and yeah, ebm is listed twice — once as Extruded Bit Map and once as Extruded Bitmap. We're keeping both because that's what the page says. periodt. 💅

🦋 EXAMPLES 🦋

The example shows the use of the in command to create a shape of a specified type. Here are all three, with the exact commands preserved because we do not play with command text. 💖

Example 1. Create a new shape in the form of a right angle wedge.

mged> in new1 raw 0 0 0 0 0 1 1 0 0 0 1 0

Creates an ARB named new1 in the form of a right angle wedge.

Example 2. Creating ebm from bitmap file

mged> in new1.s ebm f image_name.bw 350 350 20

Creates an ebm named new1.s using file image_name.bw, dimensions of image_name.bw (e.g. '350 350'), and the desired extrusion distance (e.g. '20').

Example 3. Creating ebm with database objects

mged> in new1.s ebm o dbobj 350 350 20

Creates an ebm named new1.s using database object dbobj, dimensions of original bitmap image (e.g. '350 350'), and the desired extrusion distance (e.g. '20'). (see 'bo' command for creating database object).

👑 AUTHOR 👑

BRL-CAD Team — absolute legends, no notes. 💖

🎀 BUG REPORTS 🎀

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. If something's broken, tell the team — they wanna know. 📧

Cute sign-off: source/version is BRL-CAD, manual is IN(nged), and the footer has no date listed — so no fake date, periodt. 💖