BUILD_REGION nged BRL-CAD BRL-CAD User Commands
build_region Builds a region from existing solids that have specifically formatted names based on the provided tags and numbers.
`build_region` -a region_num tag start_num end_num

## DESCRIPTION

Builds a region from existing solids that have specifically formatted names based on the provided tags and numbers. The created region will be named "tag.rx," where "x" is the first number (starting from 1) that produces an unused region name. If the -a option is used, then the specified "region_num" will be used for "x." If that region already exists, this operation will append the new geometry to the existing region definition. If that region does not exist, a new one will be created. The solids that will be involved in this operation are those with names of the form "tag.s#" or "tag.s#o@," where "#" is a number between start_num and end_num inclusive, "o" is either "u," "-," or "+," and "@" is any number. The operators and numbers coded into the solid names are used to build the region.

## EXAMPLES

The example demonstrates how to use the `build_region` command to build a region from existing solids.

Build a region from existing solids

mged> `build_region abc 1 2`

  Creates a region named "abc.r1" consisting of:

  - u abc.s1
  - u abc.s2
  - + abc.s2+1
  - - abc.s2-1
  provided that the above shapes already exist in the database.

## AUTHOR

BRL-CAD Team

## BUG REPORTS

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