addStipples function

Add Stipples to an Existing Plot

Add stipples to an existing plot.

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

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.

Details

This function locates stipples based on the PolySet

polys and does not stipple degenerate lines.

Returns

PolyData consisting of the PolyProps used to create the plot.

Author(s)

Nicholas M. Boers, Staff Software Engineer

Jobber, Edmonton AB

Last modified Rd: 2013-04-10

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)
})