`plmapstring`: Plot all or a subset of Shapefile data using strings or points in world coordinates
Prev | Chapter 17. The Common API for PLplot | Next

#### `plmapstring`: Plot all or a subset of Shapefile data using strings or points in world coordinates

`plmapstring (` | mapform ,
| name ,
| string ,
| minx ,
| maxx ,
| miny ,
| maxy ,
| plotentries ,
| nplotentries `)`;

As per `plmapline`, however the items are plotted as strings or points in the same way as `plstring`.

`mapform` (``PLMAPFORM_callback``, 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``, input)

  An ascii character string specifying the file name of a set of Shapefile files without the file extension.

`string` (``PLCHAR_VECTOR``, input)

  A UTF-8 character string to be drawn.

`minx` (``PLFLT``, 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``, 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``, 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``, 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.

`plotentries` (``PLINT_VECTOR``, input)

  A vector containing the zero-based indices of the Shapefile elements which will be drawn. Setting `plotentries` to NULL will plot all elements of the Shapefile.

`nplotentries` (``PLINT``, input)

  The number of items in `plotentries`. Ignored if `plotentries` is NULL.

Redacted form: `plmapstring(mapform, name, string, minx, maxx, miny, maxy, plotentries)`

This function is not used in any examples.

Prev | Up | Next
`plmapline`: Plot all or a subset of Shapefile data using lines in world coordinates | Home | `plmaptex`: Draw text at points defined by Shapefile data in world coordinates