AccuDraw Shortcuts

AccuDrawShortcuts provides a variety of means for controlling AccuDraw that applications may wish to make available through keyboard shortcuts. Some of the more common and recommended shortcuts are described below.

• AccuDraw Shortcuts
  • General
  • Compass Origin and Mode
  • Locks and Indexing
  • Compass Orientation
  • Auxiliary Coordinate Systems (ACS)

General

• AccuDrawShortcuts.sessionToggle - Enable/Disable AccuDraw for the current session.
  • Use to add a UI control that lets the user turn AccuDraw on/off.
• AccuDrawShortcuts.suspendToggle - Suspend/Unsuspend AccuDraw for the next data point.
  • Useful when you want to prevent AccuDraw from adjusting the next data point.
• AccuDrawShortcuts.requestInputFocus - Move focus from Home to AccuDraw.
  • A Tentative point (middle mouse button click) will also move focus to AccuDraw and is focus independent.

Compass Origin and Mode

• AccuDrawShortcuts.setOrigin - Activate and position the AccuDraw compass.
  • Enables AccuDraw if not currently active. Use before the first data point to start drawing at an offset location.
  • When either an AccuSnap or Tentative snap is active, the compass origin is set to snap location (adjusted for any locks).
  • When NOT already enabled, AccuDraw is enabled at its location from the last data point.
  • When already enabled, the compass origin is set to the current point.

• AccuDrawShortcuts.changeCompassMode - Switch input mode between Polar and Rectangular.

Locks and Indexing

• AccuDrawShortcuts.lockDistance - Change mode to Polar, toggle Distance lock, if locked focus Distance field.
• AccuDrawShortcuts.lockAngle - Change mode to Polar, toggle Angle lock. if locked focus Angle field.
• AccuDrawShortcuts.lockX - Change mode to Rectangular, toggle X lock, if locked focus Y otherwise focus closest axis.
• AccuDrawShortcuts.lockY - Change mode to Rectangular. toggle Y lock, if locked focus X otherwise focus closest axis.
• AccuDrawShortcuts.lockZ - Toggle Z lock, if locked focus Z.
• AccuDrawShortcuts.lockIndex - If axis and/or distance indexing active, lock corresponding fields. If axis and/or distance indexing inactive, disable for the next data point.

• AccuDrawShortcuts.lockSmart - Toggle axis or angle locks based on cursor position.

Compass Orientation

• AccuDrawShortcuts.setStandardRotation - Set compass orientation to a standard rotation.
  • Only Top and View are valid if the view is 2d.

NOTE: When ToolAdmin.acsContextLock is true, standard rotations are relative to the view's ACS and not design coordinates. This makes it easier to work in rotated coordinate systems.

• AccuDrawShortcuts.rotate90 - Rotate the compass 90° about the supplied axis.

  • Present as three separate shortcuts, ex. "RX", "RY", and "RZ".
  • Only rotation about Z (axis number 2) is valid if the view is 2d.

• AccuDrawShortcuts.rotateCycle - Cycle between Top, Front, and Side orientations (3d only).

• AccuDrawShortcuts.rotateAxes - Set X axis rotation from a point.

  • When AccuSnap or Tentative snap is active, no further input is required. When not snapped there is a prompt to identify a point.

• AccuDrawShortcuts.rotateToElement - Set compass orientation from a snapped element.

Uses the information from AccuSnap or Tentative snap, such as surface normal and edge tangent to try to fully define the compass orientation.

• AccuDrawShortcuts.rotatePerpendicular - Rotate compass perpendicular to snapped element.

Auxiliary Coordinate Systems (ACS)

• AccuDrawShortcuts.rotateToACS - Set compass orientation to match the view's ACS.
• AccuDrawShortcuts.defineACSByPoints - Define a new view ACS from points.
• AccuDrawShortcuts.defineACSByElement - Define a new view ACS from a snapped element.