Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
This page is new in 8.1. Moderate update since 8.1 release.

icon-images

Arguments: icon-drawing-view

The functionality of this operator was changed when the plot-widget functionality was released in an update in Fall, 2008. The current description reflects those changes. You must have the update for this operator to work as described. See sys:update-allegro for information on getting updates.

Returns the value of the icon-images property of an icon-drawing-view. The value may be set at creation time by passing the icon-images initarg, or any time later by calling (setf icon-images).

The images that are used as icons for an icon-drawing-view in a chart-or-plot. The value should be a sequence (list or vector) where each element is either a pixmap, or the symbol name of a pixmap that has been cached by calling cache-pixmap, or else the name of one of the built-in non-pixmap icons. The default value is the list (:circle :square :triangle :diamond), which is a list of all of the non-pixmap icons except for :dot.

When a pixmap is used as an icon, it is drawn at its natural size and centered about the data point that it represents. Pixmap icons look better when they have masks so that they do not make a rectangular area of the graph totally opaque; see cg-pixmaps.htm for how to define pixmaps with masks.

When the name of a built-in non-pixmap icon is used as an icon, it should be one of the keyword symbols :circle, :square, :triangle, :diamond, or :dot. These icons are line drawings that can be scaled with the icon-sizes property, and are drawn according to the icon-line-widths, icons-filled, and icon-fill-colors properties.

If this property value is nil, then no icons are drawn. Otherwise, the first object in the chart-widget's sequence of chart-objects is drawn with the first icon, the second object with the second icon, and so on. If there are fewer icons in the list than there are chart-objects, then the drawing code will cycle back through the list of icons as needed.

This property is used only when the draw-icons property is true.

See chart-widget and also cg-chart-widget.htm.


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
This page is new in 8.1. Moderate update since 8.1 release.