ColorTools - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : Packages : ColorTools : ColorTools/ExpandPalette

ColorTools

  

ExpandPalette

  

add matching colors to a palette

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

ExpandPalette(P)

Parameters

P

-

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

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

P:=RGB : 0 0.502 0.502,RGB : 0.545 0 0.545,RGB : 0.545 0.545 0

(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]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam