WHICHID(nged)

NAME

whichid - Reports information relating to usage of the region_id property on regions.

SYNOPSIS

whichid [options …] {ident[-ident]}…

DESCRIPTION

Reports information about the usage of the region_id property by regions in a .g file. Its default mode is to report which regions in a .g file are using one or a range of region_id values. If a root object is specified, it will report that result only for the regions in the tree of the root object. If the U is specified, the reporting is inverted and the command will report the ranges of unused ids rather than the regions using various ids.

OPTIONS

-U: Report unused id ranges.
--root objname: Limit reporting to regions in the CSG tree below objname.

EXAMPLES

For these examples the geometry file used is the standard ktank.g included with BRL-CAD.

Example 1. Report all regions using region ids between 4000 and 7000.

mged> whichid 4000-7000

Region[s] with ident 4001:
   r23
   r25
Region[s] with ident 4050:
   r24
   r26
Region[s] with ident 6001:
   r210
Region[s] with ident 6002:
   r212

Example 2. Report all regions using region ids between 1000-2000 and 4000-5000.

mged> whichid 1000-2000 4000-5000

Region[s] with ident 1010:
   r213
Region[s] with ident 1011:
   r214
Region[s] with ident 4001:
   r23
   r25
Region[s] with ident 4050:
   r24
   r26

Example 3. Report all regions using region ids between 1000-2000 and 4000-5000, limitingresults to regions in the tank geomtry tree.

mged> whichid --root tank 1000-2000 4000-5000

Region[s] with ident 4001:
   r23
   r25
Region[s] with ident 4050:
   r24
   r26

Example 4. Report all unused region_id ranges in the database between 1 and 1000.

mged> whichid -U 1-1000

Unused idents:
   1
   4
   6-99
   105-109
   112-114
   116-119
   122-159
   161-164
   166-204
   210-224
   226-504
   519-609
   620-719
   730-829
   840-939
   950-1000

AUTHOR

BRL-CAD Team

COPYRIGHT

BUG REPORTS

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