POV-Ray

=Description=

POV-Ray (The Persistence of Vision Raytracer) is one of the two renderers supported by the Raytracing workbench together with LuxRender. It is also supported by the new Render Workbench, together with LuxCoreRender, Appleseed, Blender Cycles and Intel Ospray Studio (experimental).

=Installation=

Stable Version
The latest stable version of POV-Ray to be provided with binaries is 3.7.0.0 (2013-11-06), the first to be free software, released under the AGPL3 (or later). The latest stable version of POV-Ray, released only as source code is 3.7.0.8 (2018-05-27).

Linux
Compiled binaries

If your distribution has it in the official repositories, you can install POV-Ray and all the relative dependencies through the package manager. Such distributions include: Arch Linux, Debian, Gentoo, openSUSE, Ubuntu.

Compiling from source

If your distributions does not have POV-Ray in the repositories, or you wish to, it is possible to compile POV-Ray from source. Download the source code of POV-Ray 3.7.0.8 from GitHub.

Configuring FreeCAD

After installing POV-Ray, launch FreeCAD, open the Preferences Editor, load the Raytracing Workbench, and go to the Raytracing Preferences.

Set the POV-Ray executable path to point to your installation of POV-Ray, usually it is /usr/bin/povray, and apply.

macOS
There is no official binary of POV-Ray 3.7 or newer for macOS, if you want to compile it from source, probably you are on your own.

The most recent available binaries are of the old closed source POV-Ray 3.6x.

Windows
The latest stable version of POV-Ray to have compiled Windows binaries is POV-Ray 3.7.0.0. Download it from GitHub, launch the installer and follow the proposed steps.

By default the destination folder is C:\Program Files\POV-Ray\v3.7, with documents and scenes in C:\Users\{your user}\Documents\POV-Ray\v3.7.

After installing POV-Ray, launch FreeCAD, open the Preferences Editor, load the Raytracing Workbench, and go to the Raytracing Preferences.

Set the POV-Ray executable path to point to your installation of POV-Ray, usually it is C:/Program Files/POV-Ray/v3.7/bin/pvengine64.exe, and apply.

Then, before trying to render something, start POV-Ray separately and set I/O restrictions according to POV-Ray documentation, otherwise rendering will not work properly (or will not work at all).

Development Version
Development seems to be halted, nonethless the latest experimental builds and source code are available. As it is experimental, you are adviced against using it in production environments.

Linux
There are no official POV-Ray development binaries, you should compile it from source. The latest release of the official development branch is POV-Ray v3.8.0-alpha.10064268.

The latest development releases (not part of the official development branch) are POV-Ray v3.8.0-x.freetype.3 and POV-Ray v3.8.0-x.10064738.

macOS
There hasn't been a macOS build of POV-Ray since the closed source 3.6x version. You can try to compile it from source, but be advised that it might not even be possible.

The latest release of the official development branch is POV-Ray v3.8.0-alpha.10064268.

The latest development releases (not part of the official development branch) are POV-Ray v3.8.0-x.freetype.3 and POV-Ray v3.8.0-x.10064738.

Windows
First of all you need to install POV-Ray 3.7, see the install instructions for the stable version. Then open POV-Ray install directory, by default C:\Program Files\POV-Ray\v3.7, and in the bin subdirectory rename the POV-Ray executable, so that you do not replace it. For example rename it to BAK-pvengine64.exe.

Then download the development build of POV-Ray you want to use. The latest release of the official development branch is POV-Ray v3.8.0-alpha.10064268-av69.

The latest development releases (not part of the official development branch) are POV-Ray v3.8.0-x.freetype.3-av693 and POV-Ray v3.8.0-x.10064738-av694.

Extract the downloaded archive (if you don't have a suitable software use 7-Zip) and copy the POV-Ray executable in the bin folder of your POV-Ray 3.7 installation.

Render Workbench
As of now there are no significant differences between the Raytracing Workbench and the Render Workbench in the part regarding the installation of the external software, so refer to the Raytracing Workbench section to install POV-Ray and to this section for the Render Workbench configuration..

First of all install the Render Workbench through the Addon Manager and restart FreeCAD.

Linux
After installing the Render Workbench and POV-Ray, launch FreeCAD, open the Preferences Editor, load the Render Workbench, and go to the Render Preferences.

Set the POV-Ray executable path to point to your installation of POV-Ray, usually it is /usr/bin/povray, and apply.

Windows
After installing the Render Workbench and POV-Ray, launch FreeCAD, open the Preferences Editor, load the Render Workbench, and go to the Render Preferences.

Set the POV-Ray executable path to point to your installation of POV-Ray, usually it is C:/Program Files/POV-Ray/v3.7/bin/pvengine64.exe, and apply.

Then, before trying to render something, start POV-Ray separately and set I/O restrictions according to POV-Ray documentation, otherwise rendering will not work properly (or will not work at all).