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

FreeBSD Manual Pages

  
 
  

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

NAME
       bb - Report dimensional information about objects using Bounding	Boxes

SYNOPSIS
       bb [options...] objects...

DESCRIPTION
       bb calculates a bounding	box for	an object or set of objects supplied
       as arguments, and reports information about bounding box	dimensions at
       the MGED	command	prompt.	It supports various options, most of which
       control the type	of information reported. It can	optionally create an
       ARB8 in a database corresponding	to the bounding	box of the object(s).
       By default, an axis-aligned bounding box	(AABB) is created, but support
       for an oriented bounding	box (OBB) is available as well.

       The objects list	consists of one	or more	geometry objects in the
       current database.

       -c bbox_object_name.s
	   Create an ARB8 primitive in the current database with the
	   dimensions of the bounding box of the object(s) listed.

       -d
	   Report dimensional information (length, width and height.) On by
	   default.

       -e
	   Report the extent of	the bounding box using the min and max 3D
	   points of the bounding box.

       -o
	   Calculate an	oriented bounding box instead of an axis aligned
	   bounding box. This will produce tighter bounding volumes if the
	   geometry is not symmetric to	the XYZ	grid. Uses the algorithms and
	   code	from Barequet and Har-Peled - see the papers Efficiently
	   Approximating the Minimum-Volume Bounding Box of a Point Set	in
	   Three Dimensions(SODA 99) and A Practical Approach for Computing
	   the Diameter	of a Point-Set for details.

       -q
	   Quiet mode -	disable	printing of the	header,	which is on by
	   default. Useful when	processing output from bb.

       -u
	   Ignore air volumes when calculating the bounding box.

       -v
	   Print the volume of the bounding box. On by default.

EXAMPLES
       Example 1. Determine the	size of	the bounding box for a Havoc
       helicopter

       bb havoc

	   Bounding Box	Dimensions, Object(s) havoc:
	   X Length: 1988.4 cm
	   Y Length: 1683.6 cm
	   Z Length: 625.0 cm
	   Bounding Box	Volume:	2092246392.4 cm^3

       Example 2. Report only the min and max points of	a bounding box

       bb -q -e	havoc

	   min {-759.447479 -8437.866455 -890.000000} max {19124.621094	8397.693207 5360.000000}

       Example 3. Bounding Box for multiple components

       bb havoc_front havoc_middle havoc_tail

	   Bounding Box	Dimensions, Object(s) havoc_front,  havoc_middle,  havoc_tail:
	   X Length: 1775.9 cm
	   Y Length: 358.0 cm
	   Z Length: 536.0 cm
	   Bounding Box	Volume:	340782488.9 cm^3

       Example 4. Create Bounding Box ARB8 in database

       bb -c havoc_parts_bbox.s	havoc_front havoc_middle havoc_tail

	   mged> bb -c havoc_parts_bbox.s havoc_front havoc_middle havoc_tail
	   Bounding Box	Dimensions, Object(s) havoc_front,  havoc_middle,  havoc_tail:
	   X Length: 1775.9 cm
	   Y Length: 358.0 cm
	   Z Length: 536.0 cm
	   Bounding Box	Volume:	340782488.9 cm^3

	   havoc havoc_tail havoc_middle havoc_parts_bbox.s havoc_front
	   mged> l havoc_parts_bbox.s
	   havoc_parts_bbox.s:	ARB8
		1 (-75.9447, -158, -4.86374e-06)
		2 (-75.9447, -158, 536)
		3 (-75.9447, 200, 536)
		4 (-75.9447, 200, -4.86374e-06)
		5 (1700, -158, -4.86374e-06)
		6 (1700, -158, 536)
		7 (1700, 200, 536)
		8 (1700, 200, -4.86374e-06)

SEE ALSO
       make_bb(nged).

COPYRIGHT
       This software is	Copyright (c) 2009-2019	United States Government as
       represented by the U.S. Army Research Laboratory.

BUG REPORTS
       Reports of bugs or problems should be submitted via electronic mail to
       <bugs@brlcad.org>.

AUTHOR
       BRL-CAD Team

BRL-CAD				  08/29/2020			      BB(nged)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | COPYRIGHT | BUG REPORTS | AUTHOR

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

home | help