plmaptex.3plplot - Man Page

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.

Info

November, 2024 PLplot API