NAME

       plmaptex - Draw text at points defined by Shapefile data in world coordinates

SYNOPSIS

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

DESCRIPTION

       As per plmapline(3plplot), however the items are plotted as text in the same way as plptex(3plplot).

       Redacted form: plmaptex(mapform, name, dx, dy, just, text, minx, maxx, miny, maxy, plotentry)

       This function is used in example 19.

ARGUMENTS

       mapform (PLMAPFORM_callback(3plplot), input)
              A  user  supplied  function  to  transform  the  coordinates  given  in  the shapefile into a plot
              coordinate system. By using this transform, we can change from a longitude, latitude coordinate to
              a polar stereographic project,  for  example.   Initially,  x[0]..[n-1]  are  the  longitudes  and
              y[0]..y[n-1]  are the corresponding latitudes.  After the call to mapform(), x[] and y[] should be
              replaced by the corresponding plot coordinates.  If  no  transform  is  desired,  mapform  can  be
              replaced by NULL.

       name (PLCHAR_VECTOR(3plplot), input)
              An  ascii  character  string specifying the file name of a set of Shapefile files without the file
              extension.

       dx (PLFLT(3plplot), input)
              Used to define the slope of the texts which is dy/dx.

       dy (PLFLT(3plplot), input)
              Used to define the slope of the texts which is dy/dx.

       just (PLFLT(3plplot), input)
              Set the justification of the text. The value given will be the fraction of the distance along  the
              string  that  sits at the given point. 0.0 gives left aligned text, 0.5 gives centralized text and
              1.0 gives right aligned text.

       text (PLCHAR_VECTOR(3plplot), input)
              A UTF-8 character string to be drawn.

       minx (PLFLT(3plplot), input)
              The minimum x value to be plotted. This must be in the same units as used by  the  Shapefile.  You
              could  use  a  very  large  negative number to plot everything, but you can improve performance by
              limiting the area drawn. The units must match those of the Shapefile projection, which may be  for
              example longitude or distance. The value of minx must be less than the value of maxx.

       maxx (PLFLT(3plplot), input)
              The  maximum  x value to be plotted. You could use a very large number to plot everything, but you
              can improve performance by limiting the area drawn.

       miny (PLFLT(3plplot), input)
              The minimum y value to be plotted. This must be in the same units as used by  the  Shapefile.  You
              could  use  a  very  large  negative number to plot everything, but you can improve performance by
              limiting the area drawn. The units must match those of the Shapefile projection, which may be  for
              example latitude or distance. The value of miny must be less than the value of maxy.

       maxy (PLFLT(3plplot), input)
              The  maximum  y value to be plotted. You could use a very large number to plot everything, but you
              can improve performance by limiting the area drawn.

       plotentry (PLINT(3plplot), input)
              An integer indicating which text string of the Shapefile (zero indexed) will be drawn.

AUTHORS

       Many developers (who are credited at http://plplot.org/credits.php) have contributed to PLplot  over  its
       long history.

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                                  October, 2024                                PLMAPTEX(3plplot)