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)
	0 Centered
	1 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
	2 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)
	0 centered
	1 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.