oracular (3) plmaptex.3plplot.gz

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.

                                                  August, 2024                                 PLMAPTEX(3plplot)