Mathematica 9 is now available

SEARCH MATHEMATICA 8 DOCUMENTATION

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

Mathematica > Visualization and Graphics > Graphics Options & Styling > Colors >

Mathematica > Data Manipulation > Image Processing & Analysis > Color Processing > Colors >

Mathematica > Visualization and Graphics > Symbolic Graphics Language > Graphics Directives > Colors >

ColorFunction

ColorFunction
is an option for graphics functions which specifies a function to apply to determine colors of elements.

MORE INFORMATION

With ColorFunction->func, the arguments supplied to func are as follows:

	Raster	a
	Plot, ListLinePlot, ListLogPlot, etc.	x, y
	ParametricPlot	x, y, u or x, y, u, v
	RegionPlot	x, y
	ArrayPlot, ReliefPlot	a
	ContourPlot and ListContourPlot	f contour levels
	DensityPlot and ListDensityPlot	f
	ContourPlot3D, ListContourPlot3D	x, y, z, f
	Plot3D, ListPlot3D, ListSurfacePlot3D, and ListPointPlot3D	x, y, z
	ParametricPlot3D	x, y, z, u or x, y, z, u, v
	RegionPlot3D	x, y, z

With the usual default setting ColorFunctionScaling->True, all arguments supplied to func are scaled to lie in the range 0 to 1.

With ColorFunctionScaling->False original unscaled values are used.

ColorFunction->"name" is equivalent to ColorFunction->(ColorData["name"][#i]&) where the slot used is as follows: Plot, ListPlot, etc.: #2 (); ArrayPlot, ReliefPlot: #1 (); ContourPlot, DensityPlot, etc.: #1 (); ContourPlot3D, etc.: #4 (); Plot3D, etc.: #3 ().

The list of possible color function names is given by ColorData["Gradients"].

The function specified by ColorFunction must return color directives such as RGBColor and Hue or named colors such as Red and Blue.

It can also return Opacity, as well as Glow and Specularity.

Combinations of directives can be specified using Directive[g₁, g₂, ...].

In 3D graphics, ColorFunction by default specifies diffuse colors for surfaces.

If an explicit setting is given for ColorRules, MeshShading or ContourShading, it is used in preference to the setting for ColorFunction.

Basic Examples (4)

Color the surface by height:

Use predefined gradients:

Color a curve:

Color a matrix:

Color the surface by height:

Use predefined gradients:

Color a curve:

Color a matrix:

Applications (1)

Define a one-dimensional color function:

Properties & Relations (1)

Use predefined color gradients from ColorData:

ColorFunctionScaling MeshShading PlotStyle NormalsFunction Blend ColorData

Density and Contour Plots

Chart Styling & Layout

Colors

Graphics Options & Styling

Image Processing & Analysis

Plotting Options

Vector Visualization

New in 6.0: Graphics & Visualization Options

Demonstrations with ColorFunction (Wolfram Demonstrations Project)

New in 2 | Last modified in 6

Ask a question about this page | Suggest an improvement | Leave a message for the team