addStipples: Add Stipples to an Existing Plot

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/PBSmapping.r

Description

Add stipples to an existing plot.

Usage

1
2
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, Associate Professor – Computer Science
MacEwan University, Edmonton AB
Last modified Rd: 2013-04-10

See Also

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

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
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)
})

PBSmapping documentation built on Jan. 15, 2021, 3:41 p.m.