d.barscale(1)

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 style
    line: Line style
    solid: Solid style
    hollow: Hollow style
    full_checker: Full checker style
    part_checker: Part checker style
    mixed_checker: Mixed checker style
    tail_checker: Tail checker style
    up_ticks: Up ticks style
    down_ticks: Down ticks style
    both_ticks: Both ticks style
    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)

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: Thursday May 08 14:17:52 2025 in commit: 3caa352f78f86a51ca463a6f1ba7ffe3db9771df

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

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual