1g.gui.psmap(1)              GRASS GIS User's Manual             g.gui.psmap(1)
2
3
4

NAME

6       g.gui.psmap  - Tool for creating hardcopy map outputs.
7

KEYWORDS

9       general, GUI, printing
10

SYNOPSIS

12       g.gui.psmap
13       g.gui.psmap --help
14       g.gui.psmap  [file=name]   [--help]  [--verbose]  [--quiet]  [--ui]
15
16   Flags:
17       --help
18           Print usage summary
19
20       --verbose
21           Verbose module output
22
23       --quiet
24           Quiet module output
25
26       --ui
27           Force launching GUI dialog
28
29   Parameters:
30       file=name
31           File containing mapping instructions to load
32           See ps.map manual for details
33

DESCRIPTION

35       wxGUI  Cartographic  Composer also called wx.psmap is a wxGUI extension
36       which allows the user to create  interactively  hardcopy  map  outputs.
37       This  tool  generates ps.map configuration file and then runs ps.map to
38       create PostScript output. There are two modes - Draft mode for map com‐
39       posing  and  Preview  mode (requires Python Imaging Library) to see how
40       the result will look like. In draft mode map features (like  legend  or
41       scalebar) are represented by a colored rectangle with a label.
42
43       Possible output files:
44
45           ·   ps.map instructions file
46
47           ·   PostScript/EPS file
48
49           ·   PDF (using ps2pdf)
50
51       Cartographic  Composer  enables  to  load  in  saved instructions file.
52       Loading instruction files created  by  Cartographic  Composer  is  more
53       robust, as opposed to loading files created manually.
54
55       Currently supported ps.map instructions:
56
57           ·   paper
58
59           ·   maploc
60
61           ·   scale
62
63           ·   border
64
65           ·   raster
66
67           ·   colortable
68
69           ·   vpoints
70
71           ·   vlines
72
73           ·   vareas
74
75           ·   vlegend
76
77           ·   text
78
79           ·   scalebar
80
81           ·   mapinfo
82
83           ·   point
84
85           ·   line
86
87           ·   rectangle
88
89           ·   labels
90
91   CARTOGRAPHIC COMPOSER TOOLBAR
92             Generate instructions file
93           Generates and saves text file with mapping instructions.
94
95             Load instructions file
96           Load text file with mapping instructions.
97
98             Page setup
99           Specify paper size, margins and orientation.
100
101             Pointer
102           Select  object  on  the  paper  by  clicking, drag the cursor while
103           pressing the left mouse button to move it or  resize  object  (cur‐
104           rently only map frame) by clicking on a small black box in its bot‐
105           tom right corner. Double click to show object properties dialog
106
107             Pan
108           Drag the pan cursor while pressing the left mouse  button  to  move
109           your view.
110
111             Zoom in
112           Interactive  zooming with the mouse in both draft and preview mode.
113           Drawing a box or just a left click with the mouse and zoom-in  cur‐
114           sor  causes  the display to zoom in so that the area defined by the
115           box fills the display.
116
117             Zoom out
118           Interactive zooming with the mouse in both draft and preview  mode.
119           Drawing a box or just a left click with the mouse and zoom-out cur‐
120           sor causes the display to zoom  out  so  that  the  area  displayed
121           shrinks to fill the area defined by the box.
122
123             Zoom to page
124           Zoom to display the entire page
125
126             Map frame
127           Click  and  drag to place map frame. If map frame is already drawn,
128           open a dialog to set its properties.
129
130             Raster map
131           Shows a dialog to add or change the raster map.
132
133             Vector map
134           Shows a dialog to add or change current vector maps and their prop‐
135           erties:
136
137       Data selection
138           Select data to draw:
139
140       Feature type
141           Select  which  data  type to draw. In case of point data, points or
142           centroids can be drawn, in case of line data, lines or boundaries.
143
144       Layer selection
145           Select layer and limit data by a SQL query or  chose  only  certain
146           categories.
147
148       Mask
149           Whether to use mask or not.
150
151       Colors
152           Color settings:
153
154       Outline
155           Select outline color and width in points. In case of lines, outline
156           means highlighting.
157
158       Fill
159           Select fill color, one color for all vector elements or color  from
160           rgb column.
161
162       Size and style
163           Sets size, style, symbols, pattern; depends on data type:
164
165       Symbology
166           Available  for point data. Choose symbol or EPS file to draw points
167           with.
168
169       Line style
170           Available for line data. Select line style (solid, dashed, ...) and
171           the look of the ends of the line (butt, round, ...)
172
173       Pattern
174           Available  for  areas. Choose pattern file and set the width of the
175           pattern.
176
177       Size
178           Available for point data. Choose size (number of times larger  than
179           the  size in the icon file) as a single value or take the size from
180           a map table column.
181
182       Rotation
183           Available for point data. Rotate symbols counterclockwise with  the
184           given value or with the value from a map table column
185
186       Width
187           Available for line data. Set line width in points or take the value
188           from a map table column.
189
190             Add overlays
191           Add overlays: vector labels, grid (not yet implemented)
192
193                 Add labels
194           Add vector labels created beforehand by v.label module.
195
196             Add map elements
197           Add map elements: legend, scalebar, map info, text
198
199                 Add legend
200           Add raster or vector legend or edit their properties.
201
202                 Add map info
203           Add information about region, grid and scale or edit map info prop‐
204           erties.
205
206                 Add scalebar
207           Add scalebar or edit its properties.
208
209                 Add text
210           Add text label.
211
212             Remove selected element
213           Select an object and remove it. Pressing Delete key does the same.
214
215             Show preview
216           Generates output and switches to Preview mode to see the result. Be
217           patient, it can take a while.
218
219             Generate hardcopy map output in PS
220           Generates hardcopy map output in PostScript/EPS file.
221
222             Generate hardcopy map output in PDF
223           Generates hardcopy map output in PDF using ps2pdf.
224

SEE ALSO

226        wxGUI
227       wxGUI components
228
229       See also wiki page.
230

AUTHOR

232       Anna Kratochvilova, Czech Technical University in Prague, Czech  Repub‐
233       lic (bachelor’s final project 2011, mentor: Martin Landa)
234

SOURCE CODE

236       Available at: wxGUI Cartographic Composer source code (history)
237
238       Main  index  |  GUI  index  | Topics index | Keywords index | Graphical
239       index | Full index
240
241       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
242
243
244
245GRASS 7.8.5                                                     g.gui.psmap(1)
Impressum