PovClipse tutorial Part 3: rendering

This third part of the tutorial deals with setting up and using render configurations.

Configuring PovClipse

First of all you have to configure PovClipse by telling it where to find Povray's "pvengine" or MegaPOV's "mpengine" executable.

  • Open PovClipse Preference page using the menu: "Window" -> "Preferences" -> "PovClipse":
    PovClipse Preference page

    Enter or select the "pvengine" executable using the "Browse" button.

  • Click on the "Apply" or "OK" button to store the preference page.

Creating a new render configuration

  • Open the render configuration dialog using the PovClipse launcher:

    Expand the launcher using the little black triangle and select "Render":
    PovClipse launcher

    The Render Configuration dialog opens. Right-click on the Item "Render Configurations" and select "New":
    Render Configuration Dialog

  • Use "tutorial" as the render configuration's name.

  • Make sure you have "Povray" selected as the renderer to be used.

  • Select our "tutorial.pov" scene file using the "Browse" button at the right side of the "POV file:" field.

    Notice that the content of the "Image file:" field automatically changes. The default is to use the same folder and file name the POV file has, just the file extension changes.

  • If you want to can switch to the "File" tab and play around with the antialiasing settings:
    Render Configuration Dialog

  • Click on the "Apply" button to store the render configuration (and let the Render configuration dialog open) or use the "OK" button to store the render configuration, close the dialog and render the scene.

Render configuration templates

Create a template

Please note the "Save as template" button. This is one of the ways to create render configuration templates.

Click on the button. A dialog pops up asking for the name of the template to be used. The name of the render configuration followed by "Template" us used as preset:
Template name input dialog
Confirm the dialog using the "OK" button.

The created template is shown at the template tree: Tutorial template

Note: Templates do not have settings for the input scene file and the image output file!

You will find that the template is an exact copy of the "tutorial" render configuration (beside the input SDL and image output file).

Another way to create a template is to right-click on the "tutorial" configuration within the render configuration tree and select "Save as template".

Create a render configuration from a template

Right click on the "tutorial Template" within the "Render configuration templates" tree and select "Create configuration".

A dialog pops up asking for the name of the render configuration to be created. Enter a name and press the "OK" button.
A new configuration appears in the "Render configurations" tree, being an exact copy of the template with no settings for the Povray input and image output file.

Render the file

  • If you open now the PovClipse launcher you will find our "Tutorial" render configuration:
    Launcher with Tutorial configuration

  • Select it and Povray launches. If not, check your PovClipse Preference Page if your "Povray executable" setting is correct!

  • During the rendering the PovClipse Render View shows the output generated by Povray.

    You can use the "Show XXX Console" settings at the PovClipse Preference Page to enable or disable specific output consoles.

  • The next time you click on the Povray symbol at the PovClipse launcher Launcher Povray is started using your "Tutorial" render configuration. To be specific, clicking on the Povray Symbol starts Povray using the last used render configuration. This means you do not have to select a specific render configuration if you want to render using the very same configuration as the last time.


If there are dirty editors (changed but not saved) a popup dialog asks whether to save all dirty editors or not:
Autosave question
Confirming the dialog using the "Yes" button saves ALL dirty editors, regardless whether they are PovClipse editors or not.
Confirming the dialog with the "No" button or using the "X" will not save the dirty editors prior to starting the rendering process.

Please note the two checkboxes:

  • Do not ask me anymore remembers your choice for the duration of the Eclipse session. If you restart Eclipse you will be asked again.
  • Make choice permanent stores your choice at the PovClipse preferences. Even if you restart Eclipse you will not be asked anymore. You can deactivate this behavior using the PovClipse preferences.

Hosted by SourceForge.net Logo