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
can be used to open the 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
statement is recognized if the cursor is between the "
c" from a
color_map keyword and the closing "
If there is no
color_map statement below the cursor the editor opens with an empty color map.
color_map syntax types are supported:
The old syntax:
[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:
[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
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:
From left to right:
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:
- 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.
- 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
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
The complete code between the
color_map keyword and the
}" 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.