PBSmapping (version 2.74.1)

addStipples: Add Stipples to an Existing Plot

Description

Add stipples to an existing plot.

Usage

addStipples (polys, xlim=NULL, ylim=NULL, polyProps=NULL,
   side=1, density=1, distance=4, ...)

Value

PolyData consisting of the PolyProps used to create the plot.

Arguments

polys

PolySet that provides the stipple boundaries (required).

xlim

range of X-coordinates.

ylim

range of Y-coordinates.

polyProps

PolyData specifying which polygons to stipple and their properties. par parameters passed as direct arguments supersede these data.

side

one of -1, 0, or 1, corresponding to outside, both sides, or inside, respectively.

density

density of points, relative to the default.

distance

distance to offset points, measured as a percentage of the absolute difference in xlim.

...

additional par parameters for the points function.

Author

Nicholas M. Boers, Staff Software Engineer
Jobber, Edmonton AB
Last modified Rd: 2013-04-10

Details

This function locates stipples based on the PolySet polys and does not stipple degenerate lines.

See Also

addPoints, addPolys, plotMap, plotPoints, plotPolys, points, PolySet.

Examples

local(envir=.PBSmapEnv,expr={
  oldpar = par(no.readonly=TRUE)
  #--- load the data (if using R)
  if (!is.null(version$language) && (version$language=="R"))
    data(nepacLL,envir=.PBSmapEnv)
  #--- plot a map
  plotMap(nepacLL,xlim=c(-128.66,-122.83),ylim=c(48.00,51.16))
  #--- add stippling
  addStipples(nepacLL,col="purple",pch=20,cex=0.25,distance=2)
  par(oldpar)
})