The Information Overlaid Toolkit: ; Referance Manual Edition 2.2, for Information Overlaid Version 2.3; 25th October 2002
Prev	Chapter 13. ? The Plotting Library	Next

`ii_plotting.js`

? Graph Layout Control Variables

The following variables control the appearance of the graph.

plotting_scale_margin_percent = percent: Percentage added to the range of the data as a margin so that points are not put on the axis or on the edge of the plot.
plotting_x_axis_offset = pixels: Number of pixels from bottom of the applet where the X axis should be placed.
plotting_y_axis_offset = pixels: Number of pixels from left of the applet where the Y axis should be placed.
plotting_top_offset = pixels: Number of pixels from top of applet where the plot shoudl stop.
plotting_right_offset = pixels: Number of pixels from the right of the applet where the plot should end.
plotting_axis_label_font = fontdesc: Font to use for labels on the axes. Default Dialog/bold/14.
plotting_axis_label_font_height = pixels: The height to assume for the axis label font. Default 16. You can increase or decrease thsi to change the space between lines.
plotting_font = fontdesc: Font to use for things other than the axis labels. Default sans/plain/20.
plotting_font_height = pixels: Height to presume for the labels other than the axis labels.
plotting_label_fields = [fieldnumbers]: A list of field numbers whose values should be used to create the label for a marker. Default is [] which means no labels.
plotting_sort_categories = trueorfalse: Whether to sort the values of category type axes.
plotting_image = index: The number of the marker image to use to plot points.

And these control the internal behaviour and so how it might interact with other things using the applet.

plotting_point_class = name: Marker class into which all plotted points are put.
plotting_label_class = name: Marker class into which labels on the graph are put.
plotting_name_fields = [fieldnumbers]: List of field numbers whose values should be used to construct the name of the markers as they are plotted. If null (the default) a name is made up.

Here are the actual plotting functions.

axis = plotting_make_axis(objects, col, type, convert, size): Calculate the details of an axis. Objects is an array of arrays giving the data which will be plotted. Col is the index into a row at which to find the data for this axis. Type is the type of axis. Convert, if non-null, is a function which will be called on each value to get the actual value to be plotted. For example it might scale numeric data or convert postcodes to all capitals. Size is the size of the area over which the data will be plotted. If size is width or height the size will be calculated from the size of the applet and the offsets defined by the layout variables above.
plotting_plot_data(xaxis, yaxis, zaxis): Plots the data on the applet. Xaxis and yaxis are axes returned from previous calls to plotting_make_axis for the X and Y axes. If given, zaxis is used to select which image to use for each point as if it were an axis.
plotting_plot_axies(XName, xaxis, YName, yaxis, ZName, zaxis): Plot and label the axes. The *Name parameters are the names to be written on the axes. As with plotting_plot_data, the parameters relating to the Z axis can be omitted.

The following callbacks can be defined to tailor the action of the library.

index = plotting_image_selector(values): If defined, this is called when the library needs to decide which marker image to use to plot a point. Values is the list of values from a row of the data array.

Prev	Home	Next
? The Plotting Library	Up	? Cross Browser Compatability