>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  DISTANCE_SCALE






      Plot a distance scale in graphics screen.


Calling Sequence

      distance_scale, ix0,iy0


      ix0,iy0 = Axis reference point in device coordinates. in

Keyword Parameters


        U1=u1 Main units for scale (like Miles, Km, ...). Required.
        U2=u2 Optional secondary units (like Km).
          Main units are below scale, secondary above.
          Only the following units are allowed:
          nmiles (nautical miles), miles (statute miles),
          kms (kilometers), meters, yards, feet.
        SCALE=scl Scaling between units and pixels. Required.
          May give as u1/pixel, u2/pixel, pixels/u1, or pixels/u2.
          Ex: SCALE='10 miles/pixel', SCALE='23.5 pixels/km', ...
        LENGTH=len Length of scale in any allowed units or pixels.
          Ex: '200 miles', '300 km', '100 pixels'=default.
          If no units are given pixels are assumed.
        ALIGN=aln Alignment of axis with reference point.
          Fraction of way reference point is from axis start to
          axis end. Like align in xyouts.
        TALIGN=taln. Axis units label placement. 3 values only:
          0: units are on left of axis, .5: units at midaxis,
          1: units are on right of axis, -1 for no units.
        TICKLENGTH=tk Ticklength in pixels (def=8).
        TSPACE=tspac Labeled tick spacing in pixels (def=50).
        CHARSIZE=csz Character size (def=1).
        ORIENTATION=ang Angle of scale, deg CCW (def=0).
        COLOR=clr Color of scale and labels (def=!.color).
        THICKNESS=thk Thickness of scale (def=!p.thick).


Common Blocks



Modification History

      R. Sterner, 2002 Feb 04
      R. Sterner, 2002 Feb 10 --- Moved labels closer to axis.
      R. Sterner, 2003 Apr 23 --- Smaller units label offset.
      R. Sterner, 2010 May 04 --- Converted arrays from () to [].
  Copyright (C) 2002, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.

© 2020 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us