'\" t
.\"     Title: WHICHID
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "WHICHID" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD MGED Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
whichid \- Reports information relating to usage of the region_id property on regions\&.
.SH "SYNOPSIS"
.HP \w'\fBwhichid\fR\ 'u
\fBwhichid\fR [\fIoptions\ \&.\&.\&.\fR] {\fIident[\-ident]\fR...}
.SH "DESCRIPTION"
.PP
Reports information about the usage of the
\fIregion_id\fR
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
\fBU\fR
is specified, the reporting is inverted and the command will report the ranges of
\fIunused\fR
ids rather than the regions using various ids\&.
.SH "OPTIONS"
.PP
\fB\-U\fR
.RS 4
Report unused id ranges\&.
.RE
.PP
\fB\-\-root objname\fR
.RS 4
Limit reporting to regions in the CSG tree below
\fIobjname\fR\&.
.RE
.SH "EXAMPLES"
.PP
For these examples the geometry file used is the standard
\fIktank\&.g\fR
included with BRL\-CAD\&.
.PP
\fBExample\ \&1.\ \&Report all regions using region ids between 4000 and 7000.\fR
.PP

mged>\fBwhichid 4000\-7000\fR
.sp
.if n \{\
.RS 4
.\}
.nf
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
    
.fi
.if n \{\
.RE
.\}
.sp

.PP
\fBExample\ \&2.\ \&Report all regions using region ids between 1000-2000 and 4000-5000.\fR
.PP

mged>\fBwhichid 1000\-2000 4000\-5000\fR
.sp
.if n \{\
.RS 4
.\}
.nf
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
    
.fi
.if n \{\
.RE
.\}
.sp

.PP
\fBExample\ \&3.\ \&Report all regions using region ids between 1000-2000 and 4000-5000, limiting results to regions in the \fItank\fR geomtry tree.\fR
.PP

mged>\fBwhichid \-\-root tank 1000\-2000 4000\-5000\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Region[s] with ident 4001:
   r23
   r25
Region[s] with ident 4050:
   r24
   r26
    
.fi
.if n \{\
.RE
.\}
.sp

.PP
\fBExample\ \&4.\ \&Report all unused region_id ranges in the database between 1 and 1000.\fR
.PP

mged>\fBwhichid \-U 1\-1000\fR
.sp
.if n \{\
.RS 4
.\}
.nf
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
    
.fi
.if n \{\
.RE
.\}
.sp

.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
