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

NAME

6       plmaptex - Draw text at points defined by Shapefile data in world coor‐
7       dinates
8

SYNOPSIS

10       plmaptex(mapform, name, dx, dy, just, text,  minx,  maxx,  miny,  maxy,
11       plotentry)
12

DESCRIPTION

14       As per plmapline(3plplot), however the items are plotted as text in the
15       same way as plptex(3plplot).
16
17       Redacted form: plmaptex(mapform, name, dx, dy, just, text, minx,  maxx,
18       miny, maxy, plotentry)
19
20       This function is used in example 19.
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       dx (PLFLT(3plplot), input)
38              Used to define the slope of the texts which is dy/dx.
39
40       dy (PLFLT(3plplot), input)
41              Used to define the slope of the texts which is dy/dx.
42
43       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
49       text (PLCHAR_VECTOR(3plplot), input)
50              A UTF-8 character string to be drawn.
51
52       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
60       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
65       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
73       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
78       plotentry (PLINT(3plplot), input)
79              An integer indicating which text string of the  Shapefile  (zero
80              indexed) will be drawn.
81
82

AUTHORS

84       Many    developers   (who   are   credited   at   http://plplot.source‐
85       forge.net/credits.php) have contributed to PLplot over  its  long  his‐
86       tory.
87

SEE ALSO

89       PLplot    documentation   at   http://plplot.sourceforge.net/documenta‐
90       tion.php.
91
92
93
94                                 August, 2017                PLMAPTEX(3plplot)