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

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

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

<refnamediv xml:id="name">
  <refname>push</refname>
  <refpurpose>Forces the effects of all transformation matrices that appear in
	any combinations in the trees from the specified <emphasis>objects</emphasis> down to the primitive 	shapes.
   </refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
  <cmdsynopsis sepchar=" ">
    <command>push</command>    
      <arg choice="opt" rep="norepeat"><replaceable>objects</replaceable></arg>
  </cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><info><title>DESCRIPTION</title></info>
  
  <para>Forces the effects of all transformation matrices that appear in
	any combinations in the trees from the specified <emphasis>objects</emphasis> down to the primitive 	shapes. This will change the parameters of the <emphasis>primitive shapes</emphasis> if any of the 	transformation matrices are not identity matrices. All the transformation matrices visited will be set to 	identity matrices. This command will fail, and no changes will be made, if any primitive shape referenced 	by the list of <emphasis>objects</emphasis> is positioned differently in two or more <emphasis>	combinations</emphasis>. The <command>xpush</command> command will perform a similar function, even if 	some shapes are multiply referenced.
   </para>
</refsection>

<refsection xml:id="examples"><info><title>EXAMPLES</title></info>
  
  <para>The example shows the use of the <command>push</command> command to push the effects of any 	transformation matrices in the trees headed by two specified objects down to the primitive shapes.
  </para>
 
  <example><info><title>Push the effects of any transformation matrices in trees headed by two specified objects down to the 	primitive shapes.</title></info>
    
    <para>
      <prompt>mged&gt;</prompt><userinput>push group1 regiona</userinput>
    </para>
    <para>Pushes the effects of any transformation matrices in the trees headed by <emphasis>group1</emphasis> 	and <emphasis>regiona</emphasis> down to the primitive shapes.
    </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>
