BB

## 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-2021 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