TOL(nged)

Used with no arguments, tol lists the current tolerance settings.

📅 published 7.44.0, from nixpkgs unstable

💖 NAME

okay bestie, this is TOL(nged) — literally the tol command from the BRL-CAD MGED Commands crew. With no arguments, tol lists the current tolerance settings. That’s the vibe: tolerances, but make it group chat. 💅

✨ SYNOPSIS

tol [abs#] [rel#] [norm#] [dist#] [perp#]

🎀 DESCRIPTION

okay so tol with no arguments lists the current tolerance settings. If the command line includes any of the keywords followed by a number, then that tolerance setting will be modified. The keywords are as follows:

🧚 Tessellation tolerances

Tessellation tolerances are used to control the facetization of primitive shapes. If more than one tolerance value is specified, the tessellation is performed to meet the most stringent. Periodt, that’s the rule.

  • abs — This absolute tolerance is specified in mm and represents the maximum allowable error in the distance from the actual shape surface to the tessellated surface. An absolute tolerance of 0 means that the absolute tolerance should be ignored.
  • rel — This relative tolerance is specified in terms of a fraction of the shape size. The value is multiplied by the size of the shape to determine another bound on the maximum allowable error in the distance from the actual shape surface to the tessellated surface. A relative tolerance of 0 means that the relative tolerance should be ignored.
  • norm — This normal tolerance is specified in degrees and represents the maximum angle between the actual shape surface normal and the tessellated surface normal. A normal tolerance of 0 means that the normal tolerance should be ignored.

🧚 Calculational tolerances

Calculational tolerances are used in evaluating the Boolean operations specified in a combination. This is used, for example, in the ev, facetize, and bev commands. iykyk 👑

  • dist — The distance tolerance is specified in mm and represents the minimum distance required between two vertices to consider them distinct.
  • perp — The perpendicularity tolerance is specified as the cosine of an angle. Two objects will be considered perpendicular if the cosine of the angle between them is less than the perpendicularity tolerance. Similarly, two objects will be considered parallel if the cosine of the angle between them is greater than 1.0, the perpendicularity tolerance.

🌸 EXAMPLES

The example shows the use of the tol command to set the relative and perpendicularity tolerances. Obsessed with a clean demo. 🫶

Example 1. Set the relative and perpendicularity tolerances.

mged>tol rel .05 perp 1e-6

Sets the relative tolerance to 5% and the perpendicularity tolerance to 1e-06 (cosine of 89.9999°). Slay. ✨

💅 AUTHOR

BRL-CAD Team — iconic, no cap. 👑

🦋 BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. fr fr, tell them everything. 😭

💖 source/version: BRL-CAD · page: TOL(nged) · date: no date in the footer, bestie — bye! 🫶

📦 where this page comes from