GRASS logo

NAME

d.barscale - Displays a barscale on the graphics monitor.

KEYWORDS

display, cartography

SYNOPSIS

d.barscale
d.barscale --help
d.barscale [-ftn] [style=string] [at=x,y] [length=integer] [units=string] [label=string] [segment=integer] [color=name] [bgcolor=name] [text_position=string] [width_scale=float] [font=string] [fontsize=float] [path=name] [charset=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

-f
Use feet/miles instead of meters
-t
Draw the scale bar without text
-n
Display north-arrow symbol.
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

style=string
Type of barscale to draw
Options: classic, line, solid, hollow, full_checker, part_checker, mixed_checker, tail_checker, up_ticks, down_ticks, both_ticks, arrow_ends
Default: classic
classic classic: Classic style
line line: Line style
solid solid: Solid style
hollow hollow: Hollow style
full_checker full_checker: Full checker style
part_checker part_checker: Part checker style
mixed_checker mixed_checker: Mixed checker style
tail_checker tail_checker: Tail checker style
up_ticks up_ticks: Up ticks style
down_ticks down_ticks: Down ticks style
both_ticks both_ticks: Both ticks style
arrow_ends arrow_ends: Arrow ends style
at=x,y
Screen coordinates of the rectangle's top-left corner
(0,0) is lower-left of the display frame
Options: 0-100
Default: 0.0,10.0
length=integer
Length of barscale in map units
Options: 0-
Default: 0
units=string
Barscale units to display
Options: meters, kilometers, feet, miles
label=string
Custom label of unit
segment=integer
Number of segments
Options: 1-100
Default: 10
color=name
Bar scale and text color
Either a standard color name or R:G:B triplet
Default: black
bgcolor=name
Background color (drawn behind the bar)
Either a standard color name, R:G:B triplet, or "none"
Default: white
text_position=string
Text position
Options: under, over, left, right
Default: right
width_scale=float
Scale factor to change bar width
Options: 0.5-100
Default: 1
font=string
Font name
fontsize=float
Font size
Options: 1-360
Default: 12
path=name
Path to font file
charset=string
Text encoding (only applicable to TrueType fonts)

Table of contents

DESCRIPTION

d.barscale displays a barscale on the graphics monitor at the given screen coordinates. If no coordinates are given it will draw the barscale in the bottom left of the display.

The barscale can drawn in a number of styles (see style parameter for their previews).

NOTE

d.barscale will not work with Lat/Lon coordinate reference system as the horizontal scale distance changes with latitude. Try d.grid instead.

SEE ALSO

d.graph, d.grid, d.legend, d.northarrow, g.region

AUTHORS

Unknown, from USACE/CERL.
Major rewrite for GRASS 7 by Hamish Bowman

SOURCE CODE

Available at: d.barscale source code (history)

Latest change: Wednesday Apr 17 11:38:48 2024 in commit: af7aa6982f1bc0f006e95221291b5ca125abd1e6


Main index | Display index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.4.1dev Reference Manual