'\" t
.\"     Title: AE
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "AE" "nged" "08/28/2023" "BRL\-CAD" "BRL\-CAD User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ae \- Sets the view orientation for the \fImged\fR display by rotating the eye position about the center of the viewing cube\&.
.SH "SYNOPSIS"
.HP \w'\fBae\fR\ 'u
\fBae\fR [\-i] {\fIazimuth\fR} {\fIelevation\fR} [\fItwist\fR]
.SH "DESCRIPTION"
.PP
Set the view orientation for the
\fImged\fR
display by rotating the eye position about the center of the viewing cube\&. The eye position is determined by the supplied azimuth and elevation angles (degrees)\&. The
\fIazimuth\fR
angle is measured in the
\fIxy\fR
plane with the positive
\fIx\fR
direction corresponding to an azimuth of 0\(de\&. Positive azimuth angles are measured counter\-clockwise about the positive
\fIz\fR
axis\&. Elevation angles are measured from the
\fIxy\fR
plane with +90\(de corresponding to the positive
\fIz\fR
direction and \-90 corresponding to the negative
\fIz\fR
direction\&. If an optional
\fItwist\fR
angle is included, the view will be rotated about the viewing direction by the specified
\fItwist\fR
angle\&. The
\fI\-i\fR
option results in the angles supplied being interpreted as increments\&.
.SH "EXAMPLES"
.PP
The examples show how to change views by entering azimuth and elevation angles, adding a twist angle, and having the angles supplied being treated as increments\&.
.PP
\fBExample\ \&1.\ \&Top view\fR
.PP

mged>\fBae \-90 90\fR
.PP
\fBExample\ \&2.\ \&Right-hand side view\fR
.PP

mged>\fBae 270 0\fR
.PP
The view is from the right\-hand side\&.
.PP
\fBExample\ \&3.\ \&View from a specific azimuth and elevation with a twist angle.\fR
.PP

mged>\fBae 35 25 10\fR
.PP
The view is from azimuth 35, elevation 25, with a view rotated by 10 degrees\&.
.PP
\fBExample\ \&4.\ \&The azimuth and elevation angles supplied are treated as increments.\fR
.PP

mged>\fBae \-i 0 0 5\fR
.PP
Rotates the current view through 5 degrees about the viewing direction\&.
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
