1PLMAPSTRING(3plplot) PLplot API PLMAPSTRING(3plplot)
2
6 plmapstring - Plot all or a subset of Shapefile data using strings or
7 points in world coordinates
8
10 plmapstring(mapform, name, string, minx, maxx, miny, maxy, plotentries,
11 nplotentries)
12
14 As per plmapline(3plplot), however the items are plotted as strings or
15 points in the same way as plstring(3plplot).
16 Redacted form: plmapstring(mapform, name, string, minx, maxx, miny,
18 maxy, plotentries)
19 This function is not used in any examples.
21
23 mapform (PLMAPFORM_callback(3plplot), input)
24 A user supplied function to transform the coordinates given in
25 the shapefile into a plot coordinate system. By using this
26 transform, we can change from a longitude, latitude coordinate
27 to a polar stereographic project, for example. Initially,
28 x[0]..[n-1] are the longitudes and y[0]..y[n-1] are the corre‐
29 sponding latitudes. After the call to mapform(), x[] and y[]
30 should be replaced by the corresponding plot coordinates. If no
31 transform is desired, mapform can be replaced by NULL.
32 name (PLCHAR_VECTOR(3plplot), input)
34 An ascii character string specifying the file name of a set of
35 Shapefile files without the file extension.
36 string (PLCHAR_VECTOR(3plplot), input)
38 A UTF-8 character string to be drawn.
39 minx (PLFLT(3plplot), input)
41 The minimum x value to be plotted. This must be in the same
42 units as used by the Shapefile. You could use a very large nega‐
43 tive number to plot everything, but you can improve performance
44 by limiting the area drawn. The units must match those of the
45 Shapefile projection, which may be for example longitude or dis‐
46 tance. The value of minx must be less than the value of maxx.
47 maxx (PLFLT(3plplot), input)
49 The maximum x value to be plotted. You could use a very large
50 number to plot everything, but you can improve performance by
51 limiting the area drawn.
52 miny (PLFLT(3plplot), input)
54 The minimum y value to be plotted. This must be in the same
55 units as used by the Shapefile. You could use a very large nega‐
56 tive number to plot everything, but you can improve performance
57 by limiting the area drawn. The units must match those of the
58 Shapefile projection, which may be for example latitude or dis‐
59 tance. The value of miny must be less than the value of maxy.
60 maxy (PLFLT(3plplot), input)
62 The maximum y value to be plotted. You could use a very large
63 number to plot everything, but you can improve performance by
64 limiting the area drawn.
65 plotentries (PLINT_VECTOR(3plplot), input)
67 A vector containing the zero-based indices of the Shapefile ele‐
68 ments which will be drawn. Setting plotentries to NULL will plot
69 all elements of the Shapefile.
70 nplotentries (PLINT(3plplot), input)
72 The number of items in plotentries. Ignored if plotentries is
73 NULL.
74
77 Many developers (who are credited at http://plplot.org/credits.php)
78 have contributed to PLplot over its long history.
79
81 PLplot documentation at http://plplot.org/documentation.php.
82 February, 2022 PLMAPSTRING(3plplot)