OFF_UTIL(1)

📦 version 0.32, in nixos 26.05, nixpkgs unstable

💅 OFF_UTIL(1) — utilities for OFF files ✨

okay bestie, listen up: this is the off_util page from User Commands and it's literally about utilities for OFF files. it's giving swiss-army-knife energy and we're gonna go through every single flag together, no skipping 💖

✨ SYNOPSIS ✨

off_util [options] input_files

🦋 DESCRIPTION 🦋

So here's the vibe: it reads one or more files in OFF format, combines them into a single file, and then processes that one file. simple queen behavior 🎀

Most operations are about manipulating elements — adding, deleting, and combining elements, triangulating and orienting faces, making an edge skeleton, and rounding the precision of coordinates. iconic.

Other miscellaneous operations include projection onto a sphere, creating a net, truncating vertices, and converting edges to quadrilaterals. like, the range? unmatched 🌈

⭐ Operations are performed in the order they are given on the command line. order matters, bestie, don't forget it!!

input_files is the list of files to process, which may include 'null' as an empty geometry — or if it's not given, the program reads from standard input. slay, stdin rep 🫶

🎀 Options 🎀

  • -h,--help — this help message (run off_util -H help for general help) 💅
  • --version — version information, obviously
  • -M <args> — sort and merge elements whose coordinates are the same, to the number of decimal places given by option -l. args is 1 or 2 comma separated parts. the first part is the elements to merge, which can include: v - vertices, e - edges, f - faces, a - all (vef), b - bond (merge 've' and delete any face coincident with another), s - sort without merging. the second part (default 3) is the merge blend color: first=1, last=2, rgb=3, ryb=4
  • -l <lim> — minimum distance for unique vertex locations as negative exponent (default: 12 giving 1e-12) 🍓
  • -O <opt> — orient the faces first (if possible) then adjust for signed volume. value may be: positive, negative, reverse, or flip (which reverses the orientation of the model as it was input) 🔥
  • -T <rat> — truncate vertices by cutting edges at a ratio from each vertex. can also be 'rat,num' to truncate only vertices of order num
  • -s — skeleton, write the face edges and remove the faces 💀
  • -t <disp> — triangulate, include face parts according to winding number, from: odd, nonzero, positive, negative, triangulate (synonym for nonzero)
  • -g — geometry only, remove all colours, remove all two-vertex faces (edges) that are also a face edge
  • -x <elms> — remove OFF face elements. the element string is processed in order and can include v, e, f to remove OFF faces with one vertex (vertices), two-vertices (edges) and three or more vertices (faces); V to remove vertices that are not part of any face or edge; E to remove two-vertex faces (edges) that are not part of any face; D to remove two-vertex faces (edges) that are also a face edge (decorators); F to remove faces that do not share a vertex with another face 🧚
  • -e — Fill in missing explicit edges
  • -D <list> — delete a list of elements. list starts with element letter, followed by an index number list, given as index ranges separated by commas. range can be one number or two numbers separated by a hyphen (default range numbers: 0 and largest index). Element letters may also be F or E to delete compound parts by part number. Index number list may be preceded by f, e, v, E or F to find elements based on connectivity to another element type or part. Compound parts may also be found by element number. Only elements specifically specified are deleted. list can have a suffix '%' to invert results. e or E only act on explicit edges. If some explicit edges are missing, use -e to fill them in. special connectivity selectors: o - vertices by vertex order, s - faces by number of sides, or to select by a color… x - vertex color, y - edge color, z - face color 🌸
  • -K <list> — keep a list of elements using the same parameters as -D. Only elements specifically specified are kept along with their vertex and edge decorators if present. Implicit edges which are kept are converted to explicit edges 👑
  • -A <elem> — add element. elem is element letter (v, e, f), followed by element data, optionally followed by ':' and a colour. Data is:
    • v: three comma separated coordinates, 0 for origin
    • e: a comma separated list of index numbers, joined as a ring
    • f: a comma separated list of index numbers

negative index numbers are relative to the end of the vertex list, last vertex is -1 (useful to refer to added vertices.) 🙈

  • -c <col> — close polyhedron, each hole converted to a face with colour col. holes having a vertex with more than two open edges are not filled
  • -S — project onto unit sphere centred at origin 🌈
  • -u <args> — unfold a polyhedron into a net. takes up to three comma separated values for base face index, dihedral fraction (normally 1.0 to -1.0, default: 0.0 flat), and final option letters: 'f' centre on centroid of face centres, 'z' align base face normal to z_axis.
  • -d <dgts> — number of significant digits (default 16) or, if negative, then the number of digits after the decimal point 💜
  • -o <file> — write output to file (default: write to standard output)

🫶 SEE ALSO 🫶

The full documentation for off_util is maintained as a Texinfo manual. If the info and off_util programs are properly installed at your site, the command

info off_util

should give you access to the complete manual. iykyk 💖

✨ that's the whole page, bestie ✨ this one's off_util from Antiprism 0.32 — http://w... (yes that's literally how the URL shows up, no cap 😭) — mwah, go read the Texinfo manual for the rest 💅🎀

📦 where this page comes from