'\" t
.\"     Title: ILL
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "ILL" "nged" "08/28/2023" "BRL\-CAD" "BRL\-CAD User 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"
ill \- Performs the function of selecting an object after entering \fIsolid\fR (i\&.e\&., primitive)\fIilluminate\fR or \fIobject illuminate\fR mode\&.
.SH "SYNOPSIS"
.HP \w'\fBill\fR\ 'u
\fBill\fR {\fIobj_name\fR}
.SH "DESCRIPTION"
.PP
Performs the function of selecting an object after entering
\fIsolid\fR
(i\&.e\&., primitive)
\fIilluminate\fR
or
\fIobject illuminate\fR
mode\&. In
\fIsolid illuminate\fR
mode, this command selects the specific shape for editing\&. In
\fIobject illuminate\fR
mode, this command selects the leaf object for the object path, then the user may use the mouse to select where along the object path the editing should be applied\&. In both modes,the
\fIill\fR
command will only succeed if the specified
\fIobj_name \fR
is only referenced once in the displayed objects; otherwise a
\fImultiply referenced \fR
message will be displayed\&. If the
\fBill\fR
command fails, the user must resort to either using the mouse to make the selection, or using aip and M 1 0 0\&.
.SH "EXAMPLES"
.PP
The example shows the use of the
\fBill\fR
command to select a specified object for editing\&.
.PP
\fBExample\ \&1.\ \&Select an object for editing.\fR
.PP
mged> \fBill shapea\fR
.RS 4
\fIShapea>\fR
is selected for editing\&.
.RE
.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
