Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version

plot-values

Arguments: plot-widget

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-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version