1d.barscale(1)               GRASS GIS User's Manual              d.barscale(1)
2
3
4

NAME

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

KEYWORDS

9       display, cartography
10

SYNOPSIS

12       d.barscale
13       d.barscale --help
14       d.barscale   [-ftn]    [style=string]     [at=x,y]     [length=integer]
15       [units=string]    [label=string]     [segment=integer]     [color=name]
16       [bgcolor=name]        [text_position=string]        [width_scale=float]
17       [font=string]     [fontsize=float]     [path=name]     [charset=string]
18       [--help]  [--verbose]  [--quiet]  [--ui]
19
20   Flags:
21       -f
22           Use feet/miles instead of meters
23
24       -t
25           Draw the scale bar without text
26
27       -n
28           Display north-arrow symbol.
29
30       --help
31           Print usage summary
32
33       --verbose
34           Verbose module output
35
36       --quiet
37           Quiet module output
38
39       --ui
40           Force launching GUI dialog
41
42   Parameters:
43       style=string
44           Type of barscale to draw
45           Options:  classic, line, solid, hollow, full_checker, part_checker,
46           mixed_checker,  tail_checker,  up_ticks,  down_ticks,   both_ticks,
47           arrow_ends
48           Default: classic
49            classic: Classic style
50            line: Line style
51            solid: Solid style
52            hollow: Hollow style
53            full_checker: Full checker style
54            part_checker: Part checker style
55            mixed_checker: Mixed checker style
56            tail_checker: Tail checker style
57            up_ticks: Up ticks style
58            down_ticks: Down ticks style
59            both_ticks: Both ticks style
60            arrow_ends: Arrow ends style
61
62       at=x,y
63           Screen coordinates of the rectangle’s top-left corner
64           (0,0) is lower-left of the display frame
65           Options: 0-100
66           Default: 0.0,10.0
67
68       length=integer
69           Length of barscale in map units
70           Options: 0-
71           Default: 0
72
73       units=string
74           Barscale units to display
75           Options: meters,  kilometers,  feet,  miles
76
77       label=string
78           Custom label of unit
79
80       segment=integer
81           Number of segments
82           Options: 1-100
83           Default: 10
84
85       color=name
86           Bar scale and text color
87           Either a standard color name or R:G:B triplet
88           Default: black
89
90       bgcolor=name
91           Background color (drawn behind the bar)
92           Either a standard color name, R:G:B triplet, or "none"
93           Default: white
94
95       text_position=string
96           Text position
97           Options: under, over, left, right
98           Default: right
99
100       width_scale=float
101           Scale factor to change bar width
102           Options: 0.5-100
103           Default: 1
104
105       font=string
106           Font name
107
108       fontsize=float
109           Font size
110           Options: 1-360
111           Default: 12
112
113       path=name
114           Path to font file
115
116       charset=string
117           Text encoding (only applicable to TrueType fonts)
118

DESCRIPTION

120       d.barscale  displays  a  barscale  on the graphics monitor at the given
121       screen coordinates. If no  coordinates  are  given  it  will  draw  the
122       barscale in the bottom left of the display.
123
124       The  barscale  can drawn in a number of styles (see style parameter for
125       their previews).
126

NOTE

128       d.barscale will not work in Lat/Lon locations as the  horizontal  scale
129       distance changes with latitude.  Try d.grid instead.
130

SEE ALSO

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

AUTHOR

135       unknown, but from USACE/CERL.
136       Major rewrite for GRASS 7 by Hamish Bowman
137

SOURCE CODE

139       Available at: d.barscale source code (history)
140
141       Main  index | Display index | Topics index | Keywords index | Graphical
142       index | Full index
143
144       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
145
146
147
148GRASS 7.8.5                                                      d.barscale(1)