'\" t
.\"     Title: adc
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "ADC" "nged" "04/13/2022" "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"
adc \- This command controls the angle/distance cursor\&.
.SH "SYNOPSIS"
.HP \w'\fBadc\fR\ 'u
\fBadc\fR [\-i] \fIsubcommand\fR
.SH "DESCRIPTION"
.PP
This command controls the angle/distance cursor\&. The
\fBadc\fR
command with no arguments toggles the display of the angle/distance cursor (ADC)\&. The
\fI\-i\fR
option, if specified, causes the given value(s) to be treated as increments\&. Note that the
\fI\-i\fR
option is ignored when getting values or when used with subcommands where this option makes no sense\&. You can also control the position, angles, and radius of the ADC using a knob or the knob command\&. This command accepts the following subcommands:
.PP
\fBvars\fR
.RS 4
Returns a list of all ADC variables and their values (i\&.e\&., var = val)\&.
.RE
.PP
\fBdraw [0|1]\fR
.RS 4
Set or get the draw parameter\&.
.RE
.PP
\fBa1 [angle]\fR
.RS 4
Set or get angle1 in degrees\&.
.RE
.PP
\fBa2 [angle]\fR
.RS 4
Set or get angle2 in degrees\&.
.RE
.PP
\fBdist [distance]\fR
.RS 4
Set or get radius (distance) of tick in local units\&.
.RE
.PP
\fBodist [distance]\fR
.RS 4
Set or get radius (distance) of tick (+\-2047)\&.
.RE
.PP
\fBhv [position]\fR
.RS 4
Set or get position (grid coordinates and local units)\&.
.RE
.PP
\fBxyz [position]\fR
.RS 4
Set or get position (model coordinates and local units)\&.
.RE
.PP
\fBx [xpos]\fR
.RS 4
Set or get horizontal position (+\-2047)\&.
.RE
.PP
\fBy [ypos]\fR
.RS 4
Set or get vertical position (+\-2047)\&.
.RE
.PP
\fBdh \fR\fB\fIdistance\fR\fR
.RS 4
Add to horizontal position (grid coordinates and local units)\&.
.RE
.PP
\fBdv \fR\fB\fIdistance\fR\fR
.RS 4
Add to vertical position (grid coordinates and local units)\&.
.RE
.PP
\fBdx \fR\fB\fIdistance\fR\fR
.RS 4
Add to
\fIx\fR
position (model coordinates and local units)\&.
.RE
.PP
\fBdy \fR\fB\fIdistance\fR\fR
.RS 4
Add to
\fIy\fR
position (model coordinates and local units)\&.
.RE
.PP
\fBdz \fR\fB\fIdistance\fR\fR
.RS 4
Add to
\fIz\fR
position (model coordinates and local units)\&.
.RE
.PP
\fBanchor_pos [0|1]\fR
.RS 4
Anchor ADC to current position in model coordinates\&.
.RE
.PP
\fBanchor_a1 [0|1]\fR
.RS 4
Anchor angle1 to go through anchorpoint_a1\&.
.RE
.PP
\fBanchor_a2 [0|1]\fR
.RS 4
Anchor angle2 to go through anchorpoint_a2\&.
.RE
.PP
\fBanchor_dst [0|1]\fR
.RS 4
Anchor tick distance to go through anchorpoint_dst\&.
.RE
.PP
\fBanchorpoint_a1[x y z]\fR
.RS 4
Set or get anchor point for angle1 (model coordinates and local units)\&.
.RE
.PP
\fBanchorpoint_a2 [x y z]\fR
.RS 4
Set or get anchor point for angle2 (model coordinates and local units)\&.
.RE
.PP
\fBanchorpoint_dst [x y z]\fR
.RS 4
Set or get anchor point for tick distance (model coordinates and local units)\&.
.RE
.PP
\fBreset\fR
.RS 4
Reset all values to their defaults\&.
.RE
.PP
\fBhelp\fR
.RS 4
Print the help message\&.
.RE
.SH "EXAMPLES"
.PP
The examples show the use of the
\fBadc\fR
command with no arguments, with
\fIi\fR, and with subcommands\&.
.PP
\fBExample\ \&1.\ \&\fR
.PP
mged> \fBadc\fR
.RS 4
Toggle display of angle/distance cursor\&.
.RE
.PP
\fBExample\ \&2.\ \&\fR
.PP
mged> \fBadc a1 37\&.5\fR
.RS 4
Sets angle1 to 37\&.5 degrees\&.
.RE
.PP
\fBExample\ \&3.\ \&\fR
.PP
mged> \fBadc a1 37\&.5\fR
.RS 4
Gets angle1\&.
.RE
.PP
\fBExample\ \&4.\ \&\fR
.PP
mged> \fBadc xyz 100 0 0\fR
.RS 4
Moves ADC position to (100,0,0), model coordinates and local units\&.
.RE
.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
