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.

                                          February, 2023                        PLMAPTEX(3plplot)