Distance and Direction widget

(Added at v2.8)

The Distance and Direction widget allows you to draw lines, circles, ellipses, and range rings to visualize important information.

Configure the Distance and Direction widget

This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button Open this widget automatically when the app starts on the widget, which turns it dark green.

  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration properties dialog box.
  2. To replace the widget icon with your own, click the Change widget icon button.

    A file explorer window appears, allowing you to select a local image file to use as the widget icon.

  3. On the Show Tab column, use the check boxes to choose which tabs will display when the widget is deployed.
  4. For each Feedback Shape row, use the color picker in the Line Color column to set what color will be used to draw graphics.
  5. For each Feedback Shape row, use the text box in the Line Width column to set what line width will be used to draw graphics.
  6. Use the color picker in the Text Color column to set the color used to label graphics.
  7. Use the text box in the Text Size column to set the text size used to label graphics.

Use the Distance and Direction widget

You can use the Distance and Direction widget to create lines, circles, ellipses, or rings.

Change the input coordinate format

The Distance and Direction widget allows you to change the way coordinates are displayed in a text box on a dialog box.

  1. Click the Format Input button next to any coordinate text box to open the Set Coordinate Format String dialog box.
  2. Click the drop-down menu and choose a coordinate display format.
  3. Format the coordinate string by adding characters or spaces, or removing components of the string in the text box.
  4. Optionally check the box to add a + or - prefix to positive or negative numbers.
  5. Click Apply.

Create lines

You can create lines using the Distance and Direction widget given a distance and bearing, from known coordinates, or by interactively selecting points.

Create lines from distance and bearing

Create lines from a given distance and bearing.

  1. Click the Line tab.
  2. On the From drop-down menu, choose Distance and Bearing.
  3. Set a start point by entering coordinates in the Start Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Optionally use the Format Input button to open the Set Coordinate Format String dialog box.
  5. Enter a value for Length and set the units in the drop-down menu.
  6. Enter a value for Angle and set the units in the drop-down menu.
  7. Click OK.
  8. Optionally click Clear Graphics to remove the graphics from the map.

Create lines from coordinates

Use known coordinates to create geodesic lines.

  1. Click the Line tab.
  2. On the From drop-down menu, choose Points.
  3. Set a start point by entering coordinates in the Start Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Optionally use the Format Input button to open the Set Coordinate Format String dialog box.
  5. Set an end point by entering coordinates in the End Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  6. Optionally use the Format Input button to open the Set Coordinate Format String dialog box.
  7. Click OK.
  8. Optionally click Clear Graphics to remove the graphics from the map.

Create lines interactively

Interactively create geodesic lines on the map.

  1. Click the Line tab.
  2. On the From drop-down menu, choose Points.
  3. Check the Create Line Interactively check box.
  4. Click the Draw Line tool.
  5. Click a location on the map to designate the line starting point.
  6. Click a second point on the map to designate the line ending point.
  7. Optionally click Clear Graphics to remove the graphics from the map.

Create circles

You can create circles using the Distance and Direction widget from known coordinates, interactively, or from a given time and speed.

Create circles from known coordinates

Use known coordinates to create circles using radius or diameter lengths.

  1. Click the Circle tab.
  2. Click the Create Circle From drop-down menu and choose Radius or Diameter.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Circle tool to interactively select a point.
  4. Enter a distance in the Radius or Diameter text box and choose the desired units from the drop-down menu.
  5. Click OK.
  6. Optionally click Clear Graphics to remove the graphics from the map.

Create circles interactively

Interactively create circles by clicking the map.

  1. Click the Circle tab.
  2. Click the Create Circle From drop-down menu to choose a drawing method. Choose Radius or Diameter.
  3. Check the Create Circle Interactively check box.
  4. Click the Radius/Diameter units drop-down menu to set the distance units.
  5. Click the Draw Circle tool.
  6. Click a point on the map to designate the circle's center.
  7. Click a second point on the map to designate the circle's radius or diameter.
  8. Optionally click Clear Graphics to remove the graphics from the map.

Create circles using speed and time

Create a circle to identify potential locations for moving objects using a center point, time, and speed.

  1. Click the Circle tab.
  2. Click the Create Circle From drop-down menu and choose Radius or Diameter.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Circle tool to interactively select a point.
  4. Expand the Distance Calculator dialog box to enter the other options.
  5. Enter a value for Time and set the units in the drop-down menu.
  6. Enter a value for Rate and set the units in the drop-down menu.
  7. Click OK.
  8. Optionally click Clear Graphics to remove the graphics from the map.

Create ellipses

The Distance and Direction widget can create ellipses either from known coordinates or interactively.

Create ellipses from known coordinates

You can use known coordinates to create ellipses.

  1. Click the Ellipse tab.
  2. Click the Ellipse Type drop-down menu to choose either Semi or Full.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Ellipse tool to interactively select a point.
  4. Enter values for the Major and Minor axes in the Axis section and choose a value from the Units drop-down menu.
  5. Enter a value for Orientation Angle and set the units in the drop-down menu.
  6. Click OK.
  7. Optionally click Clear Graphics to remove the graphics from the map.

Create ellipses interactively

Interactively create ellipses by clicking the map.

  1. Click the Ellipse tab.
  2. Click the Ellipse Type drop-down menu. Choose Semi or Full.
  3. Check the Create Ellipse Interactively check box.
  4. Click the Unit drop-down menu in the Axis section to change the axis units.
  5. Click the Draw Ellipse tool.
  6. Click a point on the map to designate the ellipse center.
  7. Drag the mouse and click the map to designate the ellipse major axis length and orientation.
  8. Drag and click the map to designate the ellipse minor axis length.
  9. Optionally click Clear Graphics to remove the graphics from the map.

Create rings

The Distance and Direction widget can create range rings either from known coordinates and ring intervals or interactively.

Create range rings using a fixed ring number and distance

Create range rings using a set ring number and distance with the Distance and Direction widget.

  1. Click the Rings tab.
  2. From the Type drop-down menu, choose Fixed.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Type a value in the Number of Rings text box.
  5. Type a value in the Distance Between Rings text box and set the desired units using the drop-down menu.
  6. Type a value in the Number of Radials text box.
  7. Click OK.
  8. Optionally click Clear Graphics to remove the graphics from the map.

Create range rings interactively

Interactively create range rings by clicking the map.

  1. Click the Rings tab.
  2. From the Type drop-down menu, choose Interactive.
  3. Use the Distance Units drop-down menu to set the units.
  4. Type a value in the Number of Radials text box.
  5. Click the Add Point tool.
  6. Click the map to designate a center point.
  7. Drag the mouse and click the map to designate the first ring.
  8. Add additional rings as needed.
  9. Double-click the map to complete the range rings.
  10. Optionally click Clear Graphics to remove the graphics from the map.

Create range rings by distance from an origin

Create range rings based on an origin and distance from the origin.

  1. Click the Rings tab.
  2. From the Type drop-down menu, choose Origin.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Use the Distance Units drop-down menu to set the units.
  5. Enter a value in the Distances text box to set how far the first ring will be from the origin point.
  6. Click the plus sign to add another value, and continue to add values as necessary.
  7. Optionally hover over a value and click the delete button to delete that value.
  8. Type a value in the Number of Radials text box.
  9. Click OK.
  10. Optionally click Clear Graphics to remove the graphics from the map.

Create range rings by distance between rings

Create range rings based on an origin and distance from the previous ring.

  1. Click the Rings tab.
  2. From the Type drop-down menu, choose Cumulative.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Use the Distance Units drop-down menu to set the units.
  5. Enter a value in the Distances text box to set how far the first ring will be from the origin point.
  6. Click the plus sign to add another value, and continue to add values as necessary.
  7. Optionally hover over a value and click the delete button to delete that value.
  8. Optionally hover over a value and click the up or down arrow to reorder the values.
  9. Type a value in the Number of Radials text box.
  10. Click OK.
  11. Optionally click Clear Graphics to remove the graphics from the map.