'\" t
.\"     Title: WHICHAIR
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "WHICHAIR" "nged" "08/28/2023" "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"
whichair \- Reports information relating to usag of air codes on regions\&.
.SH "SYNOPSIS"
.HP \w'\fBwhichair\fR\ 'u
\fBwhichair\fR [\fIoptions\ \&.\&.\&.\fR] {\fIair_codes\fR}
.SH "DESCRIPTION"
.PP
Reports information about the usage of the
\fIair_codes\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
aircodes rather than the regions using various aircodes\&.
.PP
The
\fBeac\fR
command will perform a similar search, but will draw the qualifying regions in the MGED display rather than listing them\&.
.SH "OPTIONS"
.PP
\fB\-U\fR
.RS 4
Report unused aircode 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
\fIm35\&.g\fR
included with BRL\-CAD\&.
.PP
\fBExample\ \&1.\ \&Report all regions using air codes between 7 and 10.\fR
.PP

mged>\fBwhichair 7\-10\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Region[s] with air code 7:
   r11
   r13
   r15
Region[s] with air code 8:
   r25
   r27
   r29
   r31
   r33
   r35
    
.fi
.if n \{\
.RE
.\}
.sp

.PP
\fBExample\ \&2.\ \&Report all unused aircode ranges in the database between 1 and 10.\fR
.PP

mged>\fBwhichair \-U 1\-10\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Unused air codes:
   1\-3
   5
   9\-10
    
.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
