POV-Ray-Rendering Workbench: Difference between revisions

From FreeCAD Documentation
mNo edit summary
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu}}
<translate>
<translate>


<!--T:1-->
[[Image:POV-Ray-Rendering_workbench_icon.svg|thumb|128px|POV-Ray-Rendering Workbench icon]]
[[Image:POV-Ray-Rendering_workbench_icon.svg|thumb|128px|POV-Ray-Rendering Workbench icon]]


Line 9: Line 9:
<translate>
<translate>


==Introduction==
==Introduction== <!--T:2-->


<!--T:3-->
The POV-Ray-Rendering Workbench is an [[external workbenches|external workbench]] built to create renderings easily but also offers options for advanced users.
The POV-Ray-Rendering Workbench is an [[External_workbenches|external workbench]] built to make rendering easy but it also offers options for advanced users. The workbench uses the [http://www.povray.org/ POV-Ray] renderer.


</translate>
</translate>
Line 17: Line 18:
<translate>
<translate>


==Features==
==Features== <!--T:4-->


===Applying textures===
===Applying textures=== <!--T:5-->


<!--T:6-->
There are more than 100 predefined textures you can apply, but you can also define your own materials.
There are more than 100 predefined textures you can apply, but you can also define your own textures.


</translate>
</translate>
Line 27: Line 29:
<translate>
<translate>


====Thumbnails and live preview====
====Thumbnails and live preview==== <!--T:7-->


<!--T:8-->
You can check the appearance of the material/texture with the pre-rendered thumbnails of the textures. To see the impact of the selected texture options, you can use the live preview to render the chosen texture.
To see the impact of the selected texture options you can check the pre-rendered thumbnail or use the live preview to render the texture.


===Lighting===
===Lighting=== <!--T:9-->


<!--T:10-->
With the three light types: area light, point light and spot light, and their different options, you can create advanced lighting.
With the three light types: area light, point light and spot light, and their different options, you can create advanced lighting.


Line 39: Line 43:
<translate>
<translate>


====Indirect lighting (GI)====
====Indirect lighting (GI)==== <!--T:11-->


<!--T:12-->
The workbench has the option to enable indirect lighting to create more realistic images.
The workbench has the option to enable indirect lighting to create more realistic images.


</translate>
</translate>
[[File:POV-Ray-Rendering IndirectLighting.png|600px]]
[[File:POV-Ray-Rendering_IndirectLighting.png|600px]]
<translate>
<translate>


===HDRI environments===
===HDRI environments=== <!--T:13-->


<!--T:14-->
With support for HDRI environments, beautiful environments are simple to use.
With support for HDRI environments, beautiful environments are simple to use.


</translate>
</translate>
[[File:POV-Ray-Rendering HDRI.png|600px]]
[[File:POV-Ray-Rendering_HDRI.png|600px]]
<translate>
<translate>


===User inc file===
===User inc file=== <!--T:15-->


<!--T:16-->
The user has the option to use an extra file what offers the option to use ''all'' options of the renderer. For more details, checkout our wiki: [https://gitlab.com/usbhub/exporttopovray/-/blob/master/doc/PowerUser.md Power User]
Power users who want access to ''all'' options of the [http://www.povray.org/ POV-Ray] renderer can do so by creating a special file. For more details see the [https://gitlab.com/usbhub/exporttopovray/-/blob/master/doc/PowerUser.md Power User] page on our Wiki.


==Usage==
==Usage== <!--T:17-->


<!--T:18-->
It's a lot easier to watch this simple demo of the workbench instead of describing it:
Here is a simple demonstration of the workbench:


</translate>
</translate>
[[File:POV-Ray-Rendering Demo.gif]]
[[File:POV-Ray-Rendering_Demo.gif]]
<translate>
<translate>


<!--T:19-->
There are many more options on the other tabs, please explore them yourself, or you can visit our wiki: [https://gitlab.com/usbhub/exporttopovray/-/tree/master/doc Workbench Wiki]
There are many more options on the other tabs, please explore them yourself, or you can visit our Wiki: [https://gitlab.com/usbhub/exporttopovray/-/tree/master/doc Workbench Wiki]


==Installation==
==Installation== <!--T:20-->


<!--T:21-->
This workbench can be installed and updated from the [[Image:AddonManager.svg|24px]] [[Addon_Manager|Addon Manager]]. The POV-Ray renderer used by the workbench has to be installed separately. See [http://wiki.povray.org/content/HowTo:Install_POV Install POV].
This workbench can be installed and updated from the [[Image:AddonManager.svg|24px]] [[Std_AddonMgr|Addon Manager]]. The [http://www.povray.org/ POV-Ray] renderer used by the workbench has to be installed separately. For Windows users, the installer can be downloaded from the [https://www.povray.org/download/ POV-Ray Download Page], for Linux users it can usually be installed from the package manager. Look up the detailed instructions in the [https://wiki.povray.org/content/HowTo:Install_POV POV-Ray Wiki] if you're on a Mac.


<!--T:22-->
To complete the installation the path to the POV-Ray executable has to be defined in the workbench preferences:
To complete the installation the path to the POV-Ray executable has to be defined in the workbench preferences, usually these are the default paths:
* '''Windows:''' {{FileName|C:/Program Files/POV-Ray/v3.7/bin/pvengine64.exe}} (the {{FileName|v*.*}} folder may change depending on the POV-Ray version)
* '''Linux:''' {{FileName|/usr/bin/povray}}
* '''MacOS:''' Not available. If you have more information, please let us know.


</translate>
</translate>
[[File:POV-Ray-Rendering ExePath.png|600px]]
[[File:POV-Ray-Rendering_ExePath.png|600px]]
<translate>
<translate>


==Tools==
==Tools== <!--T:23-->


<!--T:24-->
Almost every setting, except the settings of the light objects, is done in the dialog, so there are not many commands:
* [[Image:POV-Ray-Rendering_OpenDialog.svg|32px]] OpenDialog: Opens the dialog where most of the work is done. Here you can apply textures, add HDRI environments, etc. and start the rendering.


<!--T:25-->
* [[Image:POV-Ray-Rendering_OpenDialog.svg|32px]] OpenDialog: Open the Dialog where you can apply textures, add HDRI environments, etc. and start the rendering
* [[Image:POV-Ray-Rendering_PointLight.svg|32px]] Point Light: Inserts a Point Light.


<!--T:26-->
* [[Image:POV-Ray-Rendering_PointLight.svg|32px]] Point Light: Insert a Point Light
* [[Image:POV-Ray-Rendering_AreaLight.svg|32px]] Area Light: Inserts an Area Light.


<!--T:27-->
* [[Image:POV-Ray-Rendering_AreaLight.svg|32px]] Area Light: Insert an Area Light
* [[Image:POV-Ray-Rendering_SpotLight.svg|32px]] Spot Light: Inserts a Spot Light.


==References== <!--T:28-->
* [[Image:POV-Ray-Rendering_SpotLight.svg|32px]] Spot Light: Insert a Spot Light

==References==


<!--T:29-->
* Authors:
* Authors:
** Usb Hub: https://gitlab.com/usbhub
** Usb Hub: https://gitlab.com/usbhub
Line 98: Line 115:
* Source code on GitHub: https://github.com/TheRaytracers/freecad-povray-render
* Source code on GitHub: https://github.com/TheRaytracers/freecad-povray-render


== Links to POV-Ray Workbench ==
== Links to POV-Ray Workbench == <!--T:30-->


<!--T:31-->
* Workbench Wiki: https://gitlab.com/usbhub/exporttopovray/-/tree/master/doc
* Workbench Wiki: https://gitlab.com/usbhub/exporttopovray/-/tree/master/doc
* FreeCAD Forum: https://forum.freecadweb.org/viewtopic.php?f=9&t=48629
* FreeCAD Forum: https://forum.freecadweb.org/viewtopic.php?f=9&t=48629
* Report bugs: Please report bugs at GitHub or FreeCAD Forum
* Report bugs: Please report bugs at GitHub or the FreeCAD Forum


== Other useful links ==
== Other useful links == <!--T:32-->


<!--T:33-->
* [[External_workbenches|External workbenches]]
* [[External_workbenches|External workbenches]]



Latest revision as of 10:39, 13 June 2023

Other languages:
POV-Ray-Rendering Workbench icon

Introduction

The POV-Ray-Rendering Workbench is an external workbench built to make rendering easy but it also offers options for advanced users. The workbench uses the POV-Ray renderer.

Features

Applying textures

There are more than 100 predefined textures you can apply, but you can also define your own textures.

Thumbnails and live preview

To see the impact of the selected texture options you can check the pre-rendered thumbnail or use the live preview to render the texture.

Lighting

With the three light types: area light, point light and spot light, and their different options, you can create advanced lighting.

Indirect lighting (GI)

The workbench has the option to enable indirect lighting to create more realistic images.

HDRI environments

With support for HDRI environments, beautiful environments are simple to use.

User inc file

Power users who want access to all options of the POV-Ray renderer can do so by creating a special file. For more details see the Power User page on our Wiki.

Usage

Here is a simple demonstration of the workbench:

There are many more options on the other tabs, please explore them yourself, or you can visit our Wiki: Workbench Wiki

Installation

This workbench can be installed and updated from the Addon Manager. The POV-Ray renderer used by the workbench has to be installed separately. For Windows users, the installer can be downloaded from the POV-Ray Download Page, for Linux users it can usually be installed from the package manager. Look up the detailed instructions in the POV-Ray Wiki if you're on a Mac.

To complete the installation the path to the POV-Ray executable has to be defined in the workbench preferences, usually these are the default paths:

  • Windows: C:/Program Files/POV-Ray/v3.7/bin/pvengine64.exe (the v*.* folder may change depending on the POV-Ray version)
  • Linux: /usr/bin/povray
  • MacOS: Not available. If you have more information, please let us know.

Tools

  • OpenDialog: Opens the dialog where most of the work is done. Here you can apply textures, add HDRI environments, etc. and start the rendering.
  • Point Light: Inserts a Point Light.
  • Area Light: Inserts an Area Light.
  • Spot Light: Inserts a Spot Light.

References

Links to POV-Ray Workbench

Other useful links