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:
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:
From left to right:
| (red box) |
| (blue box) |
| (yellow box) |
| (green box) |
Add and delete map entries
Adding
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.
Deleting
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
Position
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.
Color
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
|