Editing Ramp New (section)

== Color and range interpretation ==

=== Number of colors and values ===

* Obvious case: Same number of values and colors (''len(range) == len(color)'')
* Color palettes: Only first and last value are used as the palette boundaries, with linear interpolation in between
* Less colors than values: The last color will be repeated to fill up the color array
* More colors than values: '''This behavior is deprecated and will change in PyMOL 1.8.'''. If '''N''' is the number of values, then:
** One extra color: Last color (''color[N]'') will be used for ''values > range[N-1]''
** Two extra colors: ''color[N]'' will be used for ''values < range[0]'' and ''color[N+1]'' will be used for ''values > range[N-1]''
** More than two extra colors: Like with two extra colors, but ''color[N+2:]'' will be ignored
** '''Recommended practice: Instead of providing out-of-bounds colors with the last two colors, put them in the beginning and end of the color list and repeat the first and last values in the range list.''' Example with white out-of-bounds coloring: ''range=[0, 0, 10, 10], color=[white, red, blue, white]''
** '''Planned change in PyMOL 1.8:''' With two values and more than two colors, colors will be evenly spaced between the two values (like  color palettes)

=== Supported special colors ===

With proximity ramps, in addition to regular named colors (like "blue"), the following special colors are supported:

* atomic: color of closest atom in proximity object
* default: alias for atomic
* object: color of proximity object
* <name of another ramp>: recursive ramp coloring