color.saturation Function (For GPL Graphic Elements)

Note: If you are modifying the saturation for a guide, refer to color.saturation Function (For GPL Guides) .

Syntax

color.saturation(<algebra>)

or 

color.saturation(color.saturation."saturation value")

or 

color.saturation(<statistic function>)

<algebra>. Graph algebra, using one variable or a blend of variables. Each variable value results in a different level of color saturation.

"saturation value". A value between 0 and 1 that indicates the saturation level. A value of 1 indicates full saturation, while a value of 0 indicates no saturation (gray).

<statistic function>. A statistic function.

Description

Controls the color saturation of the graphic elements. To specify the color saturation explicitly for the fill or border of the graphic element, you can append .interior or .exterior to the function. Using color.saturation without a qualifier implies color.saturation.interior.

Examples

Figure 1. Example: Using the values of a variable to control color saturation
ELEMENT: point(position(x*y), color.saturation(z), color(color.blue))
Figure 2. Example: Using a statistical function to control color
ELEMENT: interval(position(summary.mean(jobcat*salary)), 
         color.saturation(summary.count()))

Statistic Functions

See GPL Functions .