VariablePackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
This page is new in 8.2.


This variable has an effect only on the Windows platform.

When this variable is true, filling functions such as fill-ellipse and fill-polygon will fill an area with a color gradient for a highlighted or three-dimensional effect.

This technique varies the lightness of the color gradually from one side of the filled area to the other. The particular way that the lightness varies can be controlled with the variables *color-gradient-intensity*, *color-gradient-direction*, and *color-gradient-blend*.

The default value is nil. Typically you would bind this variable to true around a block of drawing code where gradient filling is desired. It is probably not a good idea to globally set this variable to true, because gradient filling is usually not desirable absolutely everywhere.

As a special case, erase-contents-box and erase-contents-box-x-y will bind this variable to nil to prevent default redisplay-window methods from clearing the background of windows with a gradient effect, even if this variable is globally true.

For gradient filling in chart and plot widgets, see body-gradient-filling, icon-gradient-filling, and bar-gradient-filling.

See *antialiasing* for another appearance-enhancing effects.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 8.2 release.
Created 2016.6.21.

Allegro CL version 8.2
This page is new in 8.2.