MGED CMD build region

From BRL-CAD

build_region[edit]

Syntax[edit]

build_region [-a region_num] tag start_num end_num


Argument(s)[edit]

[-a region_num]
Append to end of existing Regions
tag
Base Name for regions
start_num
Starting Region ID number
end_num
Ending Region ID number


Return Value(s)[edit]

No Return Values for this command.


Description[edit]

The "build_region" command builds a region from existing solids that have specifically formated 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 to it. 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.


Example(s)[edit]

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.


See Also[edit]

No related commands.



Page Generated by David Loman on: 10/11/2007 at: 12:03:38 PM