1PLMAPSTRING(3plplot)              PLplot API              PLMAPSTRING(3plplot)
2
3
4

NAME

6       plmapstring  -  Plot all or a subset of Shapefile data using strings or
7       points in world coordinates
8

SYNOPSIS

10       plmapstring(mapform, name, string, minx, maxx, miny, maxy, plotentries,
11       nplotentries)
12

DESCRIPTION

14       As  per plmapline(3plplot), however the items are plotted as strings or
15       points in the same way as plstring(3plplot).
16
17       Redacted form: plmapstring(mapform, name,  string,  minx,  maxx,  miny,
18       maxy, plotentries)
19
20       This function is not used in any examples.
21

ARGUMENTS

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
33       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
37       string (PLCHAR_VECTOR(3plplot), input)
38              A UTF-8 character string to be drawn.
39
40       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
48       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
53       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
61       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
66       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
71       nplotentries (PLINT(3plplot), input)
72              The  number  of items in plotentries.  Ignored if plotentries is
73              NULL.
74
75

AUTHORS

77       Many   developers   (who   are   credited   at    http://plplot.source‐
78       forge.net/credits.php)  have  contributed  to PLplot over its long his‐
79       tory.
80

SEE ALSO

82       PLplot   documentation   at    http://plplot.sourceforge.net/documenta‐
83       tion.php.
84
85
86
87                                 August, 2017             PLMAPSTRING(3plplot)