makeImageDF: Maps R x and y point coordinates to pixil coordinates for tool-tip interactivity

Description

NOT CALLED BY USER. The makeImageDF function is utilized by makeImap to map a set of R x and y coordinates to their corresponding pixil x and y coordinates. It also sets up data.frames of tool-tip information for display purpses

Usage

makeImageDF(Splot,
            xy.type,
            xlim, ylim,
            x.pos,y.pos,
            boundingPt,
            x.labels=NA,
            y.labels=NA,
            xy.labels=NA,
            x.links=NA,
            y.links=NA,
            xy.links=NA,
            asLinks=NA,
            x.images=NA,
            y.images=NA,
            xy.images=NA)

Arguments

Splot

An Object of the class Splot

xy.type

Indication of how the xpos and ypos values should be treated.Current options are "image.midpoint","image.boundaries", or "image.box".See details or vignette.

xlim

x limit of figure

ylim

y limit of figure

x.pos

numeric vector of x values for interactive points

y.pos

numeric vector of y values for interactive points

boundingPt

List with up.left and low.right pixil coordinates of the desired interactive figure's plotting region, as determined by automapPts

x.labels

data frame of n x m which contains values relating to the xpos. n should be the length of the xpos argument if xy.type is "image.midpoints" and length of xpos - 1 if xy.type is "image.boundaries" or "image.box". m columns contains information

y.labels

data frame of n x m which contains values relating to the yvec. n should be the length of the ypos argument if xy.type is "image.midpoints" and length of ypos - 1 if xy.type is "image.boundaries" or "image.box". m columns contains information

xy.labels

list of matricies. All matricies should be of n x m where n is the length of y and m is the length of x when xy.type is "image.midpoint". All matricies should be of n x m where n is the length of y -1 and m is the length of x - 1 when xy.type

x.links

data frame of n x m which contains web addresses for links relating to the xpos. n should be the length of the xpos argument if xy.type is "image.midpoints" and length of xpos - 1 if xy.type is "image.boundaries" or "image.box". m columns con

y.links

data frame of n x m which contains web addresses for links relating to the ypos. n should be the length of the ypos argument if xy.type is "image.midpoints" and length of ypos - 1 if xy.type is "image.boundaries" or "image.box". m columns con

xy.links

asLinks

contains complete web address for points that should be treated as hyperlinks. May be a data.frame or matrix of n x m where n is the length of ypos and m is the length of xpos, a vector of length xpos indicating xpos specific links that will b

x.images

data frame of n x m which contains paths to images relating to the xpos. n should be the length of the xpos argument if xy.type is "image.midpoints" and length of xpos - 1 if xy.type is "image.boundaries" or "image.box". m columns contains inform

y.images

data frame of n x m which contains paths to images relating to the ypos. n should be the length of the ypos argument if xy.type is "image.midpoints" and length of ypos - 1 if xy.type is "image.boundaries" or "image.box". m columns contains informat

xy.images

Value

List containing objects with interactive information.

Details

This function uses the x and y limits of the R plots and the boundaries of the figure to convert plot points to pixil coordinates. image.box will make rectangular regions for an image interactive based on the given xpos and ypos boundaries. image.midpoints and image.boundaries will make the center of the regions of an image interactive based on the given xpos and ypos. image.midpoints assumes the xpos and ypos are the actual locations. image.boundaries assumes the xpos and ypos are the boundary cuts and calculates the midpoints. The data matricies are checked for proper lengths and returned as a MapObj.

Examples

Run this code

# not called by user