1PLMAPTEX(3plplot) PLplot API PLMAPTEX(3plplot)
2
6 plmaptex - Draw text at points defined by Shapefile data in world coor‐
7 dinates
8
10 plmaptex(mapform, name, dx, dy, just, text, minx, maxx, miny, maxy,
11 plotentry)
12
14 As per plmapline(3plplot), however the items are plotted as text in the
15 same way as plptex(3plplot).
16 Redacted form: plmaptex(mapform, name, dx, dy, just, text, minx, maxx,
18 miny, maxy, plotentry)
19 This function is used in example 19.
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 dx (PLFLT(3plplot), input)
38 Used to define the slope of the texts which is dy/dx.
39 dy (PLFLT(3plplot), input)
41 Used to define the slope of the texts which is dy/dx.
42 just (PLFLT(3plplot), input)
44 Set the justification of the text. The value given will be the
45 fraction of the distance along the string that sits at the given
46 point. 0.0 gives left aligned text, 0.5 gives centralized text
47 and 1.0 gives right aligned text.
48 text (PLCHAR_VECTOR(3plplot), input)
50 A UTF-8 character string to be drawn.
51 minx (PLFLT(3plplot), input)
53 The minimum x value to be plotted. This must be in the same
54 units as used by the Shapefile. You could use a very large nega‐
55 tive number to plot everything, but you can improve performance
56 by limiting the area drawn. The units must match those of the
57 Shapefile projection, which may be for example longitude or dis‐
58 tance. The value of minx must be less than the value of maxx.
59 maxx (PLFLT(3plplot), input)
61 The maximum x value to be plotted. You could use a very large
62 number to plot everything, but you can improve performance by
63 limiting the area drawn.
64 miny (PLFLT(3plplot), input)
66 The minimum y value to be plotted. This must be in the same
67 units as used by the Shapefile. You could use a very large nega‐
68 tive number to plot everything, but you can improve performance
69 by limiting the area drawn. The units must match those of the
70 Shapefile projection, which may be for example latitude or dis‐
71 tance. The value of miny must be less than the value of maxy.
72 maxy (PLFLT(3plplot), input)
74 The maximum y value to be plotted. You could use a very large
75 number to plot everything, but you can improve performance by
76 limiting the area drawn.
77 plotentry (PLINT(3plplot), input)
79 An integer indicating which text string of the Shapefile (zero
80 indexed) will be drawn.
81
84 Many developers (who are credited at http://plplot.org/credits.php)
85 have contributed to PLplot over its long history.
86
88 PLplot documentation at http://plplot.org/documentation.php.
89 February, 2019 PLMAPTEX(3plplot)