ChartDirector 6.0 (Perl Edition)

Layer.getImageCoor


Usage

getImageCoor(dataSet, dataItem [, offsetX, offsetY ])

Description

Gets the image map coordinates of a data point as represented in the layer as HTML image map attributes.

The image map coordinates will be in the following format:

shape="[shape]" cords="[x1],[y1],[x2],[y2] ..."

This format is specially designed so that it can easily be incorporated into HTML image maps.

This method should be called only after creating the chart image (eg. using BaseChart.makeChart or BaseChart.makeChart2). The image map cannot be determined without creating the chart image first.

Arguments

ArgumentDefaultDescription
dataSet(Mandatory)The data set index of the data point. The first data set is 0; the nth data set is (n - 1).
dataItem(Mandatory)The data point index of the data point. The first data point is 0; the nth data point is (n - 1).
offsetX0An offset to be added to all x coordinates in the image map. This is useful if the current image will be shifted and inserted into another image. In this case, the image map will need to be shifted by the same offset.
offsetY0An offset to be added to all y coordinates in the image map. See offsetX above for description.

Return Value

A text string representing the coordinates of the data point as represented in the layer in HTML image map attribute format.