add.image: Adds an image to an existing plot.

In fields: Tools for Spatial Data

Adds an image to an existing plot.

Description

Adds an image to an existing plot. Simple arguments control the location and size.

Usage

add.image(xpos, ypos, z, adj.x = 0.5, adj.y = 0.5, 
image.width = 0.15, image.height = NULL, col = tim.colors(256), ...)

Arguments

xpos	X position of image in user coordinates
ypos	Y position of image in user coordinates
z	Matrix of intensities comprising the image.
adj.x	Location of image relative to x coordinate. Most common values are .5 (centered), 0 (right side of image at x) and 1 (left side of image at x). These are the same conventions that are used for adj in positioning text.
adj.y	Location of image relative to y coordinate. Same rules as adj.x
image.width	Width of image as a fraction of the plotting region in horizontal direction.
image.height	Height of image as a fraction of the plotting region in horizontal direction. If NULL height is scaled to make image pixels square.
col	Color table for image. Default is tim.colors.
...	Any other plotting arguments that are passed to the image function

See Also

image.plot, colorbar.plot, image, tim.colors

Examples

plot( 1:10, 1:10, type="n")
data( lennon)

add.image( 5,4,lennon, col=grey( (0:256)/256))
# reference lines 
xline( 5, col=2)
yline( 4,col=2) 

#
# add lennon right in the corner beyond the plotting region
# 

par(new=TRUE, plt=c(0,1,0,1), mar=c(0,0,0,0), usr=c(0,1,0,1))
add.image( 0,0, lennon, adj.x=0, adj.y=0) 

fields documentation built on June 28, 2024, 1:06 a.m.