WHICHID

## 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, limiting results 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

## BUG REPORTS

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