ExpandPalette - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


ColorTools

  

ExpandPalette

  

add matching colors to a palette

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

ExpandPalette(P, opts)

Parameters

P

-

list of colors in formats recognized by ColorTools, or a Palette created with ColorTools[Palette]

opts

-

(optional) equation(s) of the form option=value where option is one of number, space, avoid, maxdistance, metric, or maxluma

Options

• 

number = posint

  

number of new colors to return (the default is 1)

• 

space = string

  

the color space of the output. By default it is determined from the input.

• 

avoid = list

  

a list of colors that output colors should be far away from, but should not be used to generate candidate new colors

• 

maxdistance = float

  

an upperbound on the distance of candidate colors from the input colors

• 

metric = {name,string}

  

the metric passed to ColorTools[Distance] for calculating the distance from candidate colors to input colors.

• 

maxluma = float

  

an upperbound on the brightness of candidate colors.  A value of 0.75 is reasonable to make sure plot lines in the colors show up well on white backgrounds.

Description

• 

The ExpandPalette command computes additional colors that can be added to a palette. Colors are selected to match well with at least one input color but not be too close to any of the input colors.  The ColorTools commands Lighten, Saturate, Darken, Desaturate, NeutralSpread, and HueSplit are used to generate candidate colors.  The colors are then filtered based on the options to remove undesirable colors.  Then a greedy method is used to select the desired number of candidates that are perceptually far away from the input colors.

Examples

withColorTools:

ExpandPaletteGetPaletteMapleV,number=2

RGB : 0.137 0.488 0.557,RGB : 0 0.625 1

(1)

PExpandPaletteDarkRed,Green,Navy,number=3

PRGB : 0.269 0.361 0.563,RGB : 0.0121 0.233 0.00623,RGB : 0.0686 0.314 0.91

(2)

SwatchesDarkRed,Green,Navy,P,rows=2

Compatibility

• 

The ColorTools[ExpandPalette] command was introduced in Maple 16.

• 

For more information on Maple 16 changes, see Updates in Maple 16.

See Also

ColorTools

ColorTools/ColorSpaces

ColorTools[Color]

ColorTools[Palette]