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

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

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

<refnamediv xml:id="name">
  <refname>press</refname>
  <refpurpose>Simulates the pressing of a button.
   </refpurpose>
</refnamediv>

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

<refsection xml:id="description"><info><title>DESCRIPTION</title></info>
  
  <para>Simulates the pressing of a button. All of these button actions
	can be run directly as a command. The <emphasis>button_label</emphasis> indicates which button to
	simulate. The available buttons are as follows:
   </para>
<itemizedlist mark="bullet">
<listitem>
<para>help -- Provides a list of the available <emphasis>button_labels</emphasis>.
</para>
</listitem>
<listitem>
<para>35,25 -- Switches to a view from an azimuth of 35° and an elevation of 25°.
</para>
</listitem>
<listitem>
<para>45,45 -- Switches to a view from an azimuth of 45° and an elevation of 45°.
</para>
</listitem>
<listitem>
<para>accept -- Simulates the <emphasis>accept</emphasis> button (accepts edits and writes the edited object to the database).
</para>
</listitem>
<listitem>
<para>reject -- Simulates the <emphasis>reject</emphasis> button (discards edits).
</para>
</listitem>
<listitem>
<para>reset -- Resets view to <emphasis>top</emphasis> and resizes such that all displayed objects are within
the view.
</para>
</listitem>
<listitem>
<para>save -- Remembers the current view aspect and size.
</para>
</listitem>
<listitem>
<para>restore -- Restores the most recently saved view.
</para>
</listitem>
<listitem>
<para>adc -- Toggles display of the adc.
</para>
</listitem>
<listitem>
<para>front -- Switches to view from the front (synonym for ae 0 0).
</para>
</listitem>
<listitem>
<para>left -- Switches to view from the left (synonym for ae 90 0).
</para>
</listitem>
<listitem>
<para>rear -- Switches to view from the rear (synonym for ae 180 0).
</para>
</listitem>
<listitem>
<para>right -- Switches to view from the right (synonym for ae 270 0).
</para>
</listitem>
<listitem>
<para>bottom -- Switches to view from the bottom (synonym for ae -90 -90).
</para>
</listitem>
<listitem>
<para>top -- Switches to view from the top (synonym for ae -90 90).
</para>
</listitem>
<listitem>
<para>oill -- Enters object illuminate mode.
</para>
</listitem>
<listitem>
<para>orot -- Enters object rotate mode (must already be in matrix edit mode).
</para>
</listitem>
<listitem>
<para>oscale -- Enters object scale mode (must already be in matrix edit mode).
</para>
</listitem>
<listitem>
<para>oxscale -- Enters object scale (x-direction only) mode (must already be in matrix
	edit mode).
</para>
</listitem>
<listitem>
<para>oyscale -- Enters object scale (y-direction only) mode (must already be in matrix
	edit mode).
</para>
</listitem>
<listitem>
<para>ozscale -- Enters object scale (z-direction only) mode (must already be in matrix
	edit mode).
</para>
</listitem>
<listitem>
<para>oxy -- Enters object translate mode (must already be in matrix edit mode).
</para>
</listitem>
<listitem>
<para>ox -- Enters object translate (horizontal only) mode (must already be in matrix edit
	mode).
</para>
</listitem>
<listitem>
<para>oy -- Enters object translate (vertical only) mode (must already be in matrix edit
	mode).
</para>
</listitem>
<listitem>
<para>sill -- Enters solid (i.e., primitive) illuminate mode.
</para>
</listitem>
<listitem>
<para>sedit -- (deprecated) Enters primitive edit mode.
</para>
</listitem>
<listitem>
<para>srot -- Enters solid (i.e., primitive) rotate mode (must be in primitive edit mode).
</para>
</listitem>
<listitem>
<para>sscale -- Enters solid (i.e., primitive) scale mode (must be in primitive edit mode).
</para>
</listitem>
<listitem>
<para>sxy -- Enters solid (i.e., primitive) translate mode (must be in primitive edit mode).
</para>
</listitem>
<listitem>
<para>zoomin -- Zooms in, synonym for zoom 2.
</para>
</listitem>
<listitem>
<para>zoomout -- Zooms out, synonym for zoom 0.5.</para>
</listitem>
<listitem>
<para>rate -- Toggles between rate and absolute mode for knobs and sliders.
</para>
</listitem>
<listitem>
<para>edit -- (deprecated) Toggles between edit and view modes for knobs and sliders
	(useful during editing to allow the knobs and sliders to be used for either editing
	operations (in edit mode) or to adjust the view without affecting the edited object
	(in view mode).
</para>
</listitem>
</itemizedlist> 

</refsection>

<refsection xml:id="examples"><info><title>EXAMPLES</title></info>
  
  <para>The example shows the use of the <command>press</command> command to view the object from the top 	direction.
  </para>
  <example><info><title>View from the top direction.</title></info>
    
    <para>
      <prompt>mged&gt;</prompt><userinput>press top</userinput>
    </para>
    <para>Switches to view from the top direction.
    </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>
