BARV (draw an annotated vertical scale bar)

This command draws a ticked and annotated vertical scale bar at the edges of the currently defined data window.

Command Syntax:

BARV side,offs,asep,tick,sub_tick,att

label,dec,offs,just,angle,att,ht wd,sp,slant,font 

title,tref,dx,dy,just,angle,att,ht,wd,sp,slant,font 

Command Parameters: 

side

Side of window to draw vertical scale bar

  • -1    Draw bar on left side of window (Default).
  • 1     Draw bar on right side of window.
  • offs

    Offset from window edge in map units. The default is no offset

    asep

    Separation between tick marks in world coordinates. The default is chosen based on window dimensions.

    tick

    Size of major tick marks in map units. The default is 0.15 cm.

    sub_tick

    Sub-ticks are placed at sub_tick divisions between major ticks. If sub-tick is 1 (the default), no sub-ticks are added. A sub_tick value of 2 adds a single sub_tick half-way between each asep major tick.

    att

    Attribute used to draw the scale bar.

    Sub-Command Parameters Line 1:

    This line controls the annotation of the scale bar. If the bar is annotated, only the major ticks are labelled. 

    label

    Label annotation of scale bar

    0    Do not annotate the bar.

    1    Annotate the bar (default)

    dec

    Decimal places

    -3, -4, etc.   Exponential with (0, 1, etc.) decimal places (values

                         equal to or less than –3)

    -2                 Full precision (Default).

    -1                 Integer.

    0, 1 etc.       Number of decimal places (values equal to or greater

                         than zero)

    offs

    Annotation offset from the bar. Default: 1.5 times the tick size.

    just

    Text alignment

    -1    left justified (Default for side = 1)

        Centered

        right justified (default for side = -1)

    angle

    The angle in degrees counter-clockwise from the X-axis at which to annotate the axis

    att

    Annotation attribute.

    height

    Annotation height.

    width

    Annotation width.

    space

    Annotation spacing.

    slant

    Character slant (Default 0)

    font

    Text font.

    Sub-Command Parameters Line 2: (this line can be repeated)

    This line controls the title of the scale bar. 

    title

    Scale bar title enclosed in double quotes (" ").

    treff

    Title location

    1     title plotted under the bar

        title plotted centered on left or right edge of the bar, depending

            on side. (Default)

    3     title plotted above the bar

    dx

    X location relative to the bar at which to plot the title next. The default X location is based on the treff option.

    dy

    Y location relative to the bottom of the bar at which to next plot the title. The default Y location is based on the treff option.

    just

    Title alignment

    -1    left justified (default for side = 1)

        centered

        right justified (default for side = -1)

    att

    Attribute for plotting title.

    height

    Title height.

    width

    Title width.

    space

    Title spacing.

    slant

    Title slant (Default 0)

    font

    Text font.

    Example
    PAGE ,1,40,24 /DEFINE A PLOTTING PAGE

    WIND 1,5,15,35,23 /DEFINE A DATA WINDOW

    WDEF 0,50000,1000,55000 /MAP WINDOW TO X,Y BUFFERS

    RECT 12 /DRAW A BOX AROUND WINDOW

    BARV –1 /DRAW A BAR ON THE LEFT EDGE

    BARV 1 /DRAW A BAR ON THE RIGHT EDGE

    1 /DEFAULT ANNOTATE BAR 

    "MAG" /ADD TITLE TO RIGHT BAR 

    This control file will define a page with a 30 x 8 cm window. World coordinates are mapped to the window and these coordinates are annotated on the left and right edges of the window.

  • This command is part of the MAPPLOT GX.