OFF_ALIGN(1)

💖 OFF_ALIGN(1) — off_align: alignment of OFF files 💖

User Commands corner, bestie! This is the off_align(1) page, and we’re about to make OFF-file alignment make sense. 🦋

🌸 NAME 🌸

off_align — alignment of OFF files ✨

🎀 SYNOPSIS 🎀

off_align [options] [input_file]

🦋 DESCRIPTION 🦋

Okay so the whole vibe: read a base file and a brick file in OFF format, then use vertices or faces to position the brick with respect to the base. The brick may be repeated symmetrically and/or merged with the base. If input_file is not given, the program reads from standard input. 💅

✨ Options ✨

• -h, --help — this help message. For general help, run off_util -H help. 🫶
• --version — version information.
• -v <arg> — align by vertices. arg is a comma separated list of a brick geometry (if empty use base) optionally followed by r (reverse brick orientation) followed by two, four or six points given as the vertex index number in the OFF files (starting at 0). The base points are all given first and then the brick points. Formats:
  • u1,v1 — point alignment
  • translation u1-v1 (so v1 of brick moves to u1 of base)
  • u1,u2,v1,v2 — line alignment: point alignment as above followed by rotation through u1 perpendicular to u1u2 and v1v2 to align u1u2 and v1v2.
  • u1,u2,u3,v1,v2,v3 — face alignment: line alignment as above followed by a rotation around u1,u2 so v3 lies in plane of u1u2u3.
• -f <arg> — align by face index. arg is a comma separated list of a brick geometry (if empty use base) followed by up to three numbers separated by commas: base face index, brick face index (default: 0), polygon alignment selection number (default: 0).
• -F <arg> — align and combine polyhedra by face index. arg is a comma separated list of a brick geometry (if empty use base) followed by up to three numbers: base face index, brick face index (default: 0), polygon alignment selection number (default: 0). Brick is after base, bond vertices are merged, bond faces are removed.
• -M <val> — merge parts, select and order parts in the output. val may be:
  • default (0) — any combined part (-F) followed by any brick parts (-v, -f)
  • brick (1) — brick parts only
  • base_brick (2) — base part, possibly combined (-F), followed by any brick parts (-v, -f)
  • brick_base (3) — brick parts (-v, -f), followed by base part
• -y <sub> — repeat bricks according to symmetry of base. sub is symmetry subgroup (Schoenflies notation) or full optionally followed by a , and conjugation type (integer).
• -o <file> — write output to file (default: write to standard output).

🌈 SEE ALSO 🌈

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

info off_align

should give you access to the complete manual. 👑

Bottom-of-page sign-off 💖 off_align: Antiprism 0.32 — http://... — footer tag OFF_ALIGN(1) — the original footer doesn’t show a date, so no invented date, bestie. 🫶