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