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

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

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

<refnamediv xml:id="name">
  <refname>draw</refname>
  <refpurpose>Adds <emphasis>objects</emphasis>&gt; to the display list so that they will appear on the
 <emphasis>MGED</emphasis> display. The <command>e</command> command is a synonym for <command>draw</command>.
   </refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
  <cmdsynopsis sepchar=" ">
    <command>draw</command>    
    
    <arg choice="opt" rep="norepeat">-A <replaceable>attribute name/value pairs</replaceable></arg>
    <arg choice="opt" rep="norepeat">-s</arg>
    <arg choice="opt" rep="norepeat">-A -o<replaceable>attribute name/value pairs</replaceable></arg>
    <arg choice="opt" rep="norepeat">-C#/#/#</arg>
    <arg choice="opt" rep="norepeat"><replaceable>-m1</replaceable></arg>
    <arg choice="req" rep="norepeat"><replaceable>objects</replaceable></arg>

  </cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><info><title>DESCRIPTION</title></info>
  
  <para>Adds <emphasis>objects</emphasis>&gt; to the display list so that they will appear on the MGED display. The <command>e</command> command is a synonym for draw.
  </para>
<itemizedlist mark="bullet">
<listitem>
<para>
	The <emphasis>-C</emphasis> option provides the user a way to specify a color that overrides all other
	color specifications including combination colors and region-id-based colors.
</para>
</listitem>
<listitem>
<para>
	The <emphasis>-s</emphasis> option specifies that subtracted and intersected objects should be drawn
	with shape lines rather than dot-dash lines.
</para>
</listitem>
<listitem>
<para>
	The <emphasis>-A</emphasis> option specifies that the arguments provided to this command are attribute
	name/value pairs, and only objects having the specified attributes and values are
	to be displayed. The default (without <emphasis>-o</emphasis>) is that only objects having all the
	specified attribute name/value pairs will be displayed.
</para>
</listitem>
<listitem>
<para>
         The <emphasis>-m1</emphasis> option will display BOTs shaded if the display manager is OpenGL and the
         zbuffer and lighting is enabled. To enable these settings, from the MGED GUI, choose
         "Modes/Display Manager/OpenGL", "Misc/Z-buffer" and "Misc/Lighting". If the zbuffer and lighting is
         already enabled, toggle them off then back on to ensure they are enabled.
</para>
</listitem>
</itemizedlist>
</refsection>

<refsection xml:id="examples"><info><title>EXAMPLES</title></info>
  
  <para>The following examples show the use of the <command>draw</command> command to draw particular objects, 
	to specify color, to draw with shape lines rather than dot-dash lines, and to limit the objects to be drawn
 to those having specific attribute names and value pairs.
  </para>
  <example><info><title>Draw specific objects in the <emphasis>MGED</emphasis> display.</title></info>
    
    <variablelist>
      <varlistentry>
	   <term><prompt>mged&gt;</prompt> <userinput>draw object1 object2</userinput></term>
	   <listitem>
	     <para><emphasis>Object1</emphasis> and <emphasis>object2</emphasis> are drawn in the <emphasis>MGED</emphasis> display.
	     </para>
	   </listitem>
      </varlistentry>
    </variablelist>
  </example>
       
  <example><info><title>Specify the color used to draw the object.</title></info>
    
    <para>
      <prompt>mged&gt;</prompt><userinput>draw -C 255/255/255 object2</userinput>
    </para>
    <para>Object2 is drawn in white.
    </para>
  </example>

 <example><info><title>Limit the objects to be drawn to those having specific attribute names and value pairs.
 </title></info>
    
    <para>
      <prompt>mged&gt;</prompt><userinput>draw -A -o Comment {First comment} Comment {Second comment}</userinput>
    </para>
    <para>Objects having a Comment attribute with a value of either "First comment" or "Second comment" are drawn.
    </para>
  </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>
