<!-- Converted by db4-upgrade version 1.0 -->

<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="ill">

<refmeta>
  <refentrytitle>ILL</refentrytitle>
  <manvolnum>nged</manvolnum>
  <refmiscinfo class="source">BRL-CAD</refmiscinfo>
  <refmiscinfo class="manual">BRL-CAD User Commands</refmiscinfo>
</refmeta>

<refnamediv xml:id="name">
  <refname>ill</refname>
  <refpurpose>Performs the function of selecting an object after entering <emphasis>solid</emphasis>
(i.e., primitive)<emphasis>illuminate</emphasis> or <emphasis>object illuminate</emphasis> mode.
   </refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
  <cmdsynopsis sepchar=" ">
    <command>ill</command>    
        <arg choice="req" rep="norepeat"><replaceable>obj_name</replaceable></arg>
  </cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><info><title>DESCRIPTION</title></info>
  
  <para>Performs the function of selecting an object after entering <emphasis>solid</emphasis>
	(i.e., primitive) <emphasis>illuminate</emphasis> or <emphasis>object illuminate</emphasis> mode.
	In <emphasis>solid illuminate</emphasis> mode, this command selects the specific shape for editing. In 	<emphasis>object illuminate</emphasis> 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 <emphasis>ill</emphasis> command will only succeed if the specified <emphasis>obj_name	</emphasis> is only referenced once in the displayed objects; otherwise a <emphasis>multiply referenced	</emphasis> message will be displayed. If the <command>ill</command> command fails, the user must resort 	to either using the mouse to make the selection, or using aip and M 1 0 0.  
  </para>
</refsection>

<refsection xml:id="examples"><info><title>EXAMPLES</title></info>
  
    <para>The example shows the use of the <command>ill</command> command to select a specified object for 	editing.
    </para>
  <example><info><title>Select an object for editing.</title></info>
   
    <variablelist>
      <varlistentry>
	   <term><prompt>mged&gt;</prompt> <userinput>ill shapea</userinput></term>
	   <listitem>
	     <para><emphasis>Shapea&gt;</emphasis> is selected for editing.
	      	     </para>
	   </listitem>
      </varlistentry>
    </variablelist>
  </example>
       
 </refsection>

<info><corpauthor>BRL-CAD Team</corpauthor></info>

<refsection xml:id="bug_reports"><info><title>BUG REPORTS</title></info>
  
  <para>
    Reports of bugs or problems should be submitted via electronic
    mail to &lt;devs@brlcad.org&gt;, or via the "cadbug.sh" script.
  </para>
</refsection>
</refentry>
