Skip to content

Commit

Permalink
add man pages for ae2dir and viewdir
Browse files Browse the repository at this point in the history
  • Loading branch information
joshbaker22 authored Aug 14, 2023
1 parent b7235fa commit 3181090
Show file tree
Hide file tree
Showing 4 changed files with 122 additions and 1 deletion.
2 changes: 2 additions & 0 deletions doc/docbook/system/mann/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ set(mann_EN
Z.xml
adc.xml
ae.xml
ae2dir.xml
analyze.xml
animmate.xml
apropos.xml
Expand Down Expand Up @@ -229,6 +230,7 @@ set(mann_EN
vars.xml
vdraw.xml
view.xml
viewdir.xml
viewsize.xml
vnirt.xml
voxelize.xml
Expand Down
60 changes: 60 additions & 0 deletions doc/docbook/system/mann/ae2dir.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="viewdir">

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

<refnamediv xml:id="name">
<refname>viewdir</refname>
<refpurpose>Returns the direction vector using the provided azimuth and elevation (AE).
</refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
<cmdsynopsis sepchar=" ">
<command>viewdir</command>
<arg choice="opt" rep="norepeat">-i</arg>
<arg choice="req" rep="norepeat"><replaceable>azimuth</replaceable></arg>
<arg choice="req" rep="norepeat"><replaceable>elevation</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><title>DESCRIPTION</title>

<para>Returns the direction vector using the provided azimuth and elevation as input. The
<emphasis>-i</emphasis> option results in the angles supplied being interpreted as increments.
See also the <command>viewdir</command> and <command>qvrot</command> commands.

</para>
</refsection>

<refsection xml:id="examples"><title>EXAMPLES</title>

<para>The example shows the use of the <command>ae2dir</command> command to get the direction vector.

</para>
<example><title>Find the direction vector using the provided azimuth and elevation.</title>

<para>
<prompt>mged&gt; </prompt><userinput>ae2dir 35 25</userinput>
</para>
<para>Returns the direction vector using an azimuth of 35 and elevation of 25.
</para>
</example>

</refsection>

<refsection xml:id="author"><title>AUTHOR</title><para>BRL-CAD Team</para></refsection>

<refsection xml:id="bug_reports"><title>BUG REPORTS</title>

<para>
Reports of bugs or problems should be submitted via electronic
mail to <email>devs@brlcad.org</email>
</para>
</refsection>
</refentry>
5 changes: 4 additions & 1 deletion doc/docbook/system/mann/qvrot.xml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,10 @@
<refsection xml:id="description"><title>DESCRIPTION</title>

<para>Adjusts the current MGED viewing direction such that the eye
is positioned along the direction vector (<emphasis>dx dy dz</emphasis>) from the view center and is looking towards the view center. The <emphasis>angle</emphasis> (in degrees) allows for a twist about the viewing direction. The <command>ae</command> command provides a similar capability.
is positioned along the direction vector (<emphasis>dx dy dz</emphasis>) from the view center and is
looking towards the view center. The <emphasis>angle</emphasis> (in degrees) allows for a twist about the
viewing direction. The <command>ae</command> command provides a similar capability. See also the
<command>ae2dir</command> and <command>viewdir</command> commands.
</para>
</refsection>

Expand Down
56 changes: 56 additions & 0 deletions doc/docbook/system/mann/viewdir.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="viewdir">

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

<refnamediv xml:id="name">
<refname>viewdir</refname>
<refpurpose>Returns the direction vector using the current azimuth and elevation (AE).
</refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
<cmdsynopsis sepchar=" ">
<command>viewdir</command>
</cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><title>DESCRIPTION</title>

<para>Returns the direction vector using the current azimuth and elevation as input. See also the
<command>ae2dir</command> and <command>qvrot</command> commands.

</para>
</refsection>

<refsection xml:id="examples"><title>EXAMPLES</title>

<para>The example shows the use of the <command>viewdir</command> command to get the direction vector.

</para>
<example><title>Find the current direction vector.</title>

<para>
<prompt>mged&gt; </prompt><userinput>viewdir</userinput>
</para>
<para>Returns the direction vector using the current azimuth and elevation.
</para>
</example>

</refsection>

<refsection xml:id="author"><title>AUTHOR</title><para>BRL-CAD Team</para></refsection>

<refsection xml:id="bug_reports"><title>BUG REPORTS</title>

<para>
Reports of bugs or problems should be submitted via electronic
mail to <email>devs@brlcad.org</email>
</para>
</refsection>
</refentry>

0 comments on commit 3181090

Please sign in to comment.