BOT_DECIMATE nged BRL-CAD BRL-CAD User Commands
bot_decimate Reduces the number of triangles in the old_bot_primitive and saves the results to the new_bot_primitive.
`bot_decimate` -f feature_size -c maximum_chord_error -n maximum_normal_error -e minimum_edge_length new_bot_primitive old_bot_primitive

## DESCRIPTION

Reduces the number of triangles in the old_bot_primitive and saves the results to the new_bot_primitive. The reduction is accomplished through an edge decimation algorithm. Only changes that do not violate the specified constraints are performed. Specifying the feature_size parameter will result in use of the new GCT decimator (this parameter is mutually exclusive with the other tolerances). The maximum_chord_error parameter specifies the maximum distance allowed between the original surface and the surface of the new BOT primitive in the current editing units. The maximum_normal_error specifies the maximum change in surface normal (degrees) between the old and new surfaces. The minimum_edge_length specifies the length of the longest edge that will be decimated. At least one constraint must be supplied. If more than one constraint is specified, then only operations that satisfy all the constraints are performed.

## EXAMPLES

These examples demonstrate the use of the `bot_decimate` command to create new primitives by reducing the number of triangles within certain constraints.

Decimate Specifying Chord Error and Max Normal Error

Creating a new BOT primitive by reducing the number of triangles in the old BOT primitive and specifying the maximum chord error and maximum normal error between the old and new primitives.

mged> `bot_decimate -c 0.5 -n 10.0 bot.new abot`

  Creates a new BOT primitive named bot.newby reducing the number of triangles in abot while keeping the resulting surface within 0.5 units of the surface of abot and keeping the surface normals within 10 degrees.

  Note that the constraints specified only relate the output BOT primitive to the input BOT primitive for a single invocation of the command. Repeated application of this command on its own BOT output will result in a final BOT primitive that has unknown relationships to the original BOT primitive. For example:

mged> `bot_decimate -c 10.0 bot_b bot_a`

mged> `bot_decimate -c 10.0 bot_c bot_b`

  This sequence of commands will produce primitive bot_cwith up to 20.0 units of chord error between bot_a and bot_c.

mged> `bot_decimate -c 10.0 bot_b bot_a`

mged> `bot_decimate -n 5.0 bot_c bot_b`

  This sequence of commands will produce primitive bot_c with no guaranteed relationships to bot_a.

## AUTHOR

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org