Skip to documentation
BRL-CAD
DocumentationAll documentsEnglish

WHICHID(nged)

NAME

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

On this page

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

-h, -?, --help

Print help and exit.

-s, --script

Use script-oriented output formatting.

-V

List all active ids even when no associated regions are found.

-U, --unused

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

SEE ALSO

search(nged)

AUTHOR

BRL-CAD Team

BUG REPORTS

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