addStipples {PBSmapping}

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, ...)

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.

Value

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