README
1Feb 2000 added cwidth, offset, coffset, lpos for vectors by Radim Blazek
2
3Jan 2000 added vector areas and legend label for vectors by Radim Blazek
4
51998
6Patch, which enables user to choose one vector category
7to print from a vector file (Janne Soimasuo, Finnland)
8 -> line_cat additions
9
10files: do_vector.c, ps_vector.c
11--------------------------
12** added #include <stdlib.h> 7/98 Richard Nairn
13
14--------------------------
15PROBLEM DESCRIPTION:
16 Did not plot grid and vecors correctly in lat-lon
17 label location also didn't work in lat-lon
18STATUS:
19 FIXED and coming out with the next update
20
21PROBLEM DESCRIPTION:
22The manual for ps.map says that fields width and hwidth
23specify the width of the line in pixels, which is not true:
24they were actually interpreted as width in user space PostScript
25coordinates: 1/72 of inch. I made the width double, added width options
26for outline and grid, and also now the width ni is isnterpreted as n inches.
27
28STATUS:
29 FIXED and coming out with the next update
30
31PROBLEM DESCRIPTION:
32Also in file outl_io.c o_write_line() is an exact copy of the
33write_ln() function in r.poly, which I fixed (GRASS930547) since
34it was giving segmentation faults.
35
36It looks like ps.map is doing exactly what r.poly does: creating
37a vector file with boundaries of raster areas given a raster file.
38Seems like a lot to do just to plot a map. If the user makes 10
39different plots with the same raster file using outline, then
40every time exact same vector file is created and deleted.
41
42Instead I want to draw little line segments between every pair of
43differing cells without worrying too much about topology.
44This will have one drawback: each vector line will be drawn as many
45little line segments, each with beginning and the end, instead of
46starting the PostScript path at each node and drawing a continuous line
47through all the points of vector line like it is done when drawing vector
48maps.
49Also I am going to add a line width parameter to outline command
50
51STATUS:
52 FIXED and coming out with the next update
53
54From anne@cast.uark.edu Mon Dec 20 16:40:49 1993
55
56FIXED BUGS:
57
58 1. removed the G_strip(buf); instructions in function comment.c
59 to allow leading and trailing spaces in comment file.
60
61 2. removed statements:
62 if (fontsize < 10) fontsize = 10;
63 if (fontsize > 50) fontsize = 50;
64 in function do_labels.c so as not to restrict the choice of font size.
65
66 3. increased the maximum number of pixels allowed on a page in function
67 map_setup.c :
68 limit = 300000000L;
69 if the total number of pixels is larger than "limit" then ps.map
70 reduces it to limit
71 This change allows us to print layers at their actual resolution.
72 For example: an AVHRR layer at 151 cells per inch.
73
74 NOTE: we are thinking about assigning different upper limits to different
75 Postscript devices, as an additional parameter in the ps.devices files.
76
77 4. changed function plfile.c so that it accepts a line width of 0
78 NOTE: it should also be changed to allow decimal point values.
79
80(I already changed it to decimal number, and made it accept 0 .Olga)
81
82 5. changed function ps_clrtbl.c so that category 0's label is read from the
83 cats file rather than replaced by "no data"
84
85PROBLEM DESCRIPTION:
86background none in labels did not work, the box was black
87The gridnumber size was set to zero if it was >50;
88Also I want to add linewidth for grid
89STATUS:
90 FIXED and coming out with the next update
91
92
93--------------------------------------------------------------------------
94DESCRIPTION:
95
96ps.map is called with the following arguments:
97
98 ps.map input=input_script [scale=xxxx] output=outputfile
99
100The scale is optional. If no scale is given here and no scale request is
101made in the input script, a scale equivalent to "1 panel" is used.
102
103The program ps.select should be run to select a printer configuration file
104prior to running ps.map. These files are located in the directory
105$GISBASE/etc/paint/ps.devices. The name of the file is the argument to
106ps.select. These files contain the following printer info:
107
108 level: 2
109 page width: 8.5
110 page height: 11.0
111 top margin: 0.5
112 bottom margin: 0.5
113 left margin: 0.25
114 right margin: 0.25
115 resolution: 75
116
117If ps.select is not run, the default values are as shown above, where page
118width and height are the paper dimensions (in inches) and the margins are
119the unprintable edges of the page. The level is the PostScript level and
120the resolution is the effective resolution in pixels per inch.
121
122All of the p.map requests except for "colormode", "defpat" and "setpat"
123have been implemented. Multiple panels are not supported at this time.
124The icons used in the point and sites requests are created with the ps.icon
125program (icons created with p.icon will not work).
126
127The following p.map requests have been modified in ps.map:
128
129 colortable (has the following additional sub-requests)
130 where x y (distance in inches from left and top edges of page - optional)
131 width tablewidth (maximum width of colortable in inches - optional)
132 cols table_columns (optional - defaullt = 1)
133 font fontname (optional - default = Helvetica)
134 fontsize fontsize (optional - default = 10)
135 color textcolor (optional - default = black)
136 end (required)
137
138 comments (has the following additional sub-requests)
139 where x y (positions the comments x and y inches from the left and top
140 edges of the page - optonal - default is immediately below the last
141 item printed, starting at the left edge of the map)
142 font fontname (optional - default = Helvetica)
143 fontsize fontsize (optional - default = 10)
144 color textcolor (optional - default = black)
145 end (required)
146
147 grid (has the following additional sub-requests)
148 font fontname (optional - default = Helvetica)
149 fontsize fontsize (optional - default = 10)
150 end (required)
151
152 labels (has the following additional sub-requests)
153 font fontname (optional - default = Helvetica)
154 end (required)
155
156 scale (except multiple panels are not yet implemented)
157
158 sites (has the following additional sub-request)
159 font fontname (optional - default = Helvetica. The size of the
160 font is proportional to the size of the icon. The default icon
161 size is 1.0, which is equivalent to a fontsize of 10.)
162
163 vector (except the stye sub-request uses the first color for
164 all non-zero characters in the line pattern)
165
166
167The following new script requests have been added:
168
169 greyrast (prints a raster map in shades of grey).
170
171 header
172 file filename (name of file containing header info - optional -
173 default is the standard header of pmap, except that it is
174 centered on the page)
175 font fontname (optional - default = Helvetica)
176 fontsize fontsize (optional - default = 10)
177 color textcolor (optional - default = black)
178 end (required)
179
180 maploc x y [width height] (positions the map x and y inches from
181 the left and top edges of the page. If the optional width and
182 height arguments are present, the map will be rescaled to fit.
183 If this request is not encountered, the map will be located
184 immediately below the header starting at the left margin.)
185
186 mapinfo
187 where x y (positions the information about the scale, the grid, and
188 the region x and y inches from the left and top edges of the page -
189 optonal - default is immediately below the map, starting at the
190 left edge of the map)
191 font fontname (optional - default = Helvetica)
192 fontsize fontsize (optional - default = 10)
193 color textcolor (optional - default = black)
194 end (required)
195
196 psfile filename (reads a file containing PostScript commands. This
197 request can appear up to 20 times in a ps.map script.)
198
199 vlegend
200 where x y (positions the vector legend x and y inches from the left
201 and top edges of the page - optonal - default is immediately below the
202 map_info, starting at the left edge of the map)
203 font fontname (optional - default = Helvetica)
204 fontsize fontsize (optional - default = 10)
205 end (required)
206
207 group <group> (prints an imagery group comprising R,G,B channels.)
208
209 rgb <red[@mapset]> <green[@mapset]> <blue[@mapset]> (prints an RGB
210 image formed from three separate layers, as for d.rgb.)
211