Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BOT_DECIMATE(nged)	     BRL-CAD User Commands	    BOT_DECIMATE(nged)

NAME
       bot_decimate - Reduces the number of triangles in the old_bot_primitive
       and saves the results to	the new_bot_primitive.

SYNOPSIS
       bot_decimate [-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. 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.

       Example 1. 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>, or via the "cadbug.sh" script.

BRL-CAD				  07/08/2017		    BOT_DECIMATE(nged)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | AUTHOR | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=bot_decimate&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help