Preferences

The preferences used by PovClipse are spitted into 2 parts:

  • General settings defined by "global" properties using the standard eclipse property pages.
  • Project related settings defined using the project property page.

General preferences

PovClipse has a preference page of it's own. It is integrated into the standard eclipse preferences: "Menu" -> "Window" -> "Preferences" -> "PovClipse"

PovClipse preferences

Renderer tab

PovClipse Preference page
  • Povray Executeable: the full path to the Povray executable. Use the "Browse" button to select the file.

    Note: If this setting is not correct, the Povray launcher will not work work if Povray is chosen as renderer!

  • Povray library: the full path to the Povray include folder. Use the "Browse" button to select the folder.

    Note: If this setting is not correct, Povray will not find the standard include files like colors.inc!

    Note: This setting defaults to [Povray Executeable directory]/../include, which is correct for windows systems. However, Povray installations in Unix or Mac may differ from that. In this case you can use this preference to set the correct library path.

  • MegaPOV Executeable: the full path to the MegaPOV executable. Use the "Browse" button to select the file.

    Note: If this setting is not correct, the Povray launcher will not work if MegaPOV is chosen as renderer!

  • MegaPOV library: the full path to the MegaPOV include folder. Use the "Browse" button to select the folder.

    Note: If this setting is not correct, MegaPOV will not find the standard include files like mechsim.inc!

    Note: This setting defaults to [MegaPOV Executeable directory]/../include, which is correct for windows systems. However, MegaPOV installations in Unix or Mac may differ from that. In this case you can use this preference to set the correct library path.

Consoles tab

PovClipse consoles preference
  • Show XXX console: these settings controls which Povray output consoles will appear in the Render view.

    Please note that the "Fatal" console can not be deactivated!

  • Warning level: select your desired warning level, defaults to "All Warnings"

Startup actions tab

PovClipse startup preference

Startup actions: This group specifies whether PovClipse shall look for newer versions on startup or not.

  • Check for newer version for all Plugins: if this check box is enabled PovClipse checks for all plugins on startup if there is a newer than the installed version available. The other options below are ignored.
    If this check box is not selected the other options below are enabled, allowing to specify for each plugin individually whether an update check shall be performed or not.
  • PovClipse Enable it to check for newer PovClipse versions on startup.
  • Povray documentation Enable it to check for newer versions of the Povray offline documentation plugin on startup.
  • MegaPOV documentation Enable it to check for newer versions of the MegaPOV offline documentation plugin on startup.

If a newer version is found a dialog box is shown at startup giving an upgrade hint:
Update
The checkbox "Do not check for newer versions..." can be used to prevent PovClipse from performing the update verification. If set once the examination can be reactivated using the checkboxes above.

Render actions tab

This tab is used for setting the rendering related preferences.

Auto save

Render actions tab

If there are "dirty" editors (having unsaved changes) they can be saved automatically if a render process is stated.

  • Save dirty editors: If there are dirty editors they will be saved automatically prior to starting the rendering process.

    Note: All dirty editors are saved, regardless if they are PovClipse editors or not.

  • Ask at every startup: If checked a Dialog pops up asking if the dirty editors shall be saved or not.
    If this checkbox is not selected the setting of "Save dirty editors" applies.

    Auto save

    • Do not ask me anymore: The decision whether to save all dirty editors or not is remembered as long as the current Eclipse session lasts. If Eclipse is restarted the question pops up again. In the meanwhile your "auto save" decision is applied.
    • Make choice permanent: The decision whether to save all dirty editors or not is stored using the PovClipse preference setting "Save dirty editors" (see above).

View activation

Specify which view shall be automatically activated when a render process finishes:

  • Render Message View (Default)
  • Render Jobs View
  • Do not change the active view

Editor preferences

The PovClipse editor preferences are grouped using tabs.

Syntax highlighting

PovClipse Editor preference page

The colors used by the editor syntax highlighting are configured using this preference page.

Click on the colored field right to the lables to bring up a color selection dialog.

Here some keyword examples for each coloring group:

  • Comments: either the one-line // or the multi-line /* ... */ syntax.
  • Strings: everything between " or '
  • Numbers: numerical expressions: integer, float...
  • < > Brackets: < and >
  • {} Braces: { and }
  • Declared names: the name of declared variables and objects
  • Macro names: the name of macros and their usage
  • Macro parameter: the macro interface parameter and their usage
  • Common keywords: aa_level, angle, density_file, inverse ...
  • Color keywords: blue, gray, quick_color, rgbft ...
  • Gradient keywords: x, y and z
  • Math keywords: abs, max, sin, floor ...
  • Modifier keywords: brightness, hollow, scale, translate ...
  • Object keywords: blob, cylinder, sphere, plane ...
  • Texture keywords: agate, irid, material_map, pattern ...
  • Default: everything else.

Typing

PovClipse Editor preference page

Auto typing

All auto-typing features can be turned off and on individually.

  • Brace completion: inserts '}' when typing '{'
  • Bracket completion: inserts ']' when typing '['
  • Angle Bracket completion: inserts '>' when typing '<'
  • Quote completion: inserts '"' when typing '"'

Code Assistant

If the code assistant finds only a single completion proposal the flag "Automatic 1 hit takeover" indicates wheater the completion proposal shall be used automatically or not.

Syntax checking

PovClipse Editor preference page

Errors

The different syntax error checks can be enabled or disabled individually:

  • Check includes: If a #include statement references to a not existing file an error is displayed.
  • Keyword and variable check: If an unknown word is found an error is displayed. A word is considered unknown if it is not a Povray keyword, declared variable, declared object or a macro name.

Warnings

The different syntax warning checks can be enabled or disabled individually:

  • Warn undocumented macros: If a macro statement does not have documentation, a warning message is displayed. Macro documentation is important as the macro information hover displays the macro documentation.

Performance

PovClipse Editor preference page

Caching

Various caches can be configured using this preference page:

  • Document parser cache
    • Force document parser cache update time (seconds):
      The per document parser cache is alive for this number of seconds.
      If the cache is too old the document is parsed again and a new cache is created.

      The per document parser cache contains the list of include files as well as all declared variables and macro names.

      The value 0 (zero) deactivates the cache completely
      Reasonable values are 0 (zero) and something in the range between 60 and 3600 (1 to 60 minutes).

      Please note that only documents being ***NOT*** opened in an Eclipse editor are using this cache!

  • Open document list cache
    • List of open editors update time (seconds):
      The list of documents being opened by an Eclipse Editor is alive for this number of seconds.
      If the list is too old it is build again.
      The value 0 (zero) deactivates the caching of the list completely, it is rebuild every time it's needed.
      Reasonable values are 0 and something between 5 and 600 (5 seconds to 10 minutes)

Sound preferences

PovClipse Sounds preference page

PovClipse plays sounds on specific system events. If and which sounds are to be played can be configured on this page. Select the sound to be played when the shown system event occurs from the dropdown box. The entry "No sound" turns the sound for the event off. You can use the "Play" button to hear the sound.


Hosted by SourceForge.net Logo