PovClipse color map editor

The PovClipse editor features special dialog allowing editing color_map statements in a visible way.

If the cursor is placed on a valid color_map statement, either the popup menu or the shortcut Ctrl+Shift+M can be used to open the color map editor:
Color map editor

Note: If the color_map statement is not valid the dialog does NOT open!

The color map editor is initialized with the values from the color_map statement below the cursor. The color_map statement is recognized if the cursor is between the "c" from a color_map keyword and the closing "}" brace.

If there is no color_map statement below the cursor the editor opens with an empty color map.

Both color_map syntax types are supported:
The old syntax:

color_map {
    [0.0 0.1  color rgb   <0.1, 0.2, 0.3             >
              color rgbf  <0.2, 0.4, 0.6, 0.2        >]
    [0.1 0.5  color rgbf  <0.2, 0.4, 0.6, 0.2        >
              color rgbt  <1.0, 0.0, 0.0      , 0.330>]
    [0.5 0.7  color rgbt  <1.0, 0.0, 0.0      , 0.330>
              color rgbft <0.0, 1.0, 0.0, 0.36, 0.345>]
    [0.7 1.0  color rgbft <0.0, 1.0, 0.0, 0.36, 0.345>
              color rgb   <0.0, 1.0, 0.0             >]

The new syntax:

color_map {
    [0.0 color rgb  <0.102, 0.2, 0.302             >]
    [0.1 color rgbf <0.200, 0.4, 0.600, 0.20       >]
    [0.5 color rgbt <1.000, 0.0, 0.000      , 0.330>]
    [0.7 color rgbft<0.000, 1.0, 0.000, 0.36, 0.345>]
    [1.0 color rgb  <0.000, 1.0, 0.000             >]

Please note that these two statements are identical!

Please note that only supported color syntax is color vector one ([color | colour] rgb[f|t|ft] <VECTOR>)!
This means that neither declared colors (color White) nor color keyword groups (color red 0.4 blue 3.0 filter 0.34) are supported!

Even if a statement using the old syntax was fetched into the editor, when applying the changes to your code the new syntax is used, thus the color map editor can be used to transform an old-styled color_map statement into a new-styled one.

The radio buttons in the "Dialog size" group can be used to make the editor bigger if there is too less space in order to display all entries in a useful manner.

Each of the color map entries has some areas being sensible to mouse operations: Color map editor sensible areas
From left to right:

  • Position slider area I
(red box)
  • Position value area
(blue box)
  • Position slider area II
(yellow box)
  • Color area
(green box)

Add and delete map entries


Right-click somewhere near the map bar to show up the popup-menu. Select "Add color" to generate a new entry. A Dialog is shown allowing the specification of all color properties. The position value being shown initially is calculated using the vertical position of your right-click bringing up the popup menu.
Select "OK" to create a new entry at the specified position or "Cancel" to discard the new entry.
Every new entry is generated having a BLACK color and NOT using filter or transmit values.


Bring up the popup menu by right-click either on the yellow marked areas for the position and value, or between (including) the position arrows. If you hit an entry, the "Delete color at [POSITION]" menu item is enabled.
Select it to remove the map entry.

Editing an entry


There are 2 ways to change an entries position:

  1. Enter by hand: click on the yellow marked Position value area or Color area (see above). The color editor dialog shows up, being extended with a position field, allowing to change the position value.
  2. Sliding the entry: left-click either on a Position slider area I or Position slider area II(see above) and move the mouse up or down while holding the button pressed.


Click on an entries' Position value area or Color area (see above) to bring up the Color editor. Change the color, filter, transmit and position values as desired.

Accepting the changes

The scene code is only changed if the color map editor dialog is closed using the "OK" button.
The complete code between the color_map keyword and the closing "}" brace is replaced.
If a new color_map statement was generated the actual text selection is replaced.
If the color editor dialog is closed using other means the scene code is NOT touched!
The new code is generated in a beautified manner, allowing to read the scene code in an easy manner.

Please note that the code is always generated using the newer color_map statement style, even if an old-styled statement was read.

Hosted by SourceForge.net Logo