adc
nged
BRL-CAD
BRL-CAD User Commands

# adc

This command controls the angle/distance cursor.

          adc
          -i
          subcommand

## DESCRIPTION

This command controls the angle/distance cursor. The `adc` command with no arguments toggles the display of the angle/distance cursor (ADC). The -i option, if specified, causes the given value(s) to be treated as increments. Note that the -i 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:

`vars`

  Returns a list of all ADC variables and their values (i.e., var = val).

`draw [0|1]`

  Set or get the draw parameter.

`a1 [angle]`

  Set or get angle1 in degrees.

`a2 [angle]`

  Set or get angle2 in degrees.

`dist [distance]`

  Set or get radius (distance) of tick in local units.

`odist [distance]`

  Set or get radius (distance) of tick (+-2047).

`hv [position]`

  Set or get position (grid coordinates and local units).

`xyz [position]`

  Set or get position (model coordinates and local units).

`x [xpos]`

  Set or get horizontal position (+-2047).

`y [ypos]`

  Set or get vertical position (+-2047).

`dh distance`

  Add to horizontal position (grid coordinates and local units).

`dv distance`

  Add to vertical position (grid coordinates and local units).

`dx distance`

  Add to x position (model coordinates and local units).

`dy distance`

  Add to y position (model coordinates and local units).

`dz distance`

  Add to z position (model coordinates and local units).

`anchor_pos [0|1]`

  Anchor ADC to current position in model coordinates.

`anchor_a1 [0|1]`

  Anchor angle1 to go through anchorpoint_a1.

`anchor_a2 [0|1]`

  Anchor angle2 to go through anchorpoint_a2.

`anchor_dst [0|1]`

  Anchor tick distance to go through anchorpoint_dst.

`anchorpoint_a1[x y z]`

  Set or get anchor point for angle1 (model coordinates and local units).

`anchorpoint_a2 [x y z]`

  Set or get anchor point for angle2 (model coordinates and local units).

`anchorpoint_dst [x y z]`

  Set or get anchor point for tick distance (model coordinates and local units).

`reset`

  Reset all values to their defaults.

`help`

  Print the help message.

## EXAMPLES

The examples show the use of the `adc` command with no arguments, with i, and with subcommands.

mged> `adc`

  Toggle display of angle/distance cursor.

mged> `adc a1 37.5`

  Sets angle1 to 37.5 degrees.

mged> `adc a1 37.5`

  Gets angle1.

mged> `adc xyz 100 0 0`

  Moves ADC position to (100,0,0), model coordinates and local units.

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.