Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
New since 8.1 release.

plot-values

Arguments: plot-widget

This functionality was added in an update released in the Fall of 2008. You must have that update to use this functionality. See sys:update-allegro for information on getting updates.

Returns the value of the plot-values property of a plot-widget. The value may be set at creation time by passing a plot-values initarg to make-instance, or any time later by calling (setf plot-values).

This property contains a set of values that are displayed in a plot-widget. This tree is normally built indirectly by successive calls to set-plot-value. Values are looked up here when the plot is being drawn, or when an application calls plot-value.

An application normally does not need to access this property directly, though it could build the value itself and call (setf plot-values) to set all of the plot's values at once. Here is an example of a form that would return a valid plot-values value:

(vector (vector (list :x 2 :y 3) (list :y 4 :x 9 :y-low 4.2)
                (list :x 3 :y 6.5 :icon-size 6)
                (list :x 1.3 :y 6.5 :x-low 1.1 :x-high 1.6)
                (list :x 1.3 :y 7.5) (list :x 1.3 :y 8.5)
                (list :x 3.3 :y 8.5) (list :x 12 :y 3))
        (vector (list :x 4.3 :y 8.5) (list :x 5.3 :y 8.5)
                (list :x 6.3 :y 6.5) (list :x 6.3 :y 4)))

The value is a vector where each element of the vector represents one chart object (see chart-objects). Each chart object element is itself a vector of points that will be plotted for that object. Each point is a property list whose keys can be any of the valid values for the value-type argument to set-plot-value.

To avoid building this vector of values at all, use a plot-value-returner function instead.


Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page is new in the 8.1 release.
Created 2007.4.30.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
New since 8.1 release.