POV-Ray-Rendering Workbench: Difference between revisions

From FreeCAD Documentation
m (Added {{UnfinishedDocu{{#translation:}}}})
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu}}
{{UnfinishedDocu{{#translation:}}}}
<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 10:
<translate>
<translate>


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


<!--T:3-->
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 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 19:
<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 textures.
There are more than 100 predefined textures you can apply, but you can also define your own textures.


Line 27: Line 30:
<translate>
<translate>


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


<!--T:8-->
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.
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 44:
<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.


Line 47: Line 53:
<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.


Line 55: Line 62:
<translate>
<translate>


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


<!--T:16-->
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 [https://gitlab.com/usbhub/exporttopovray/-/blob/master/doc/PowerUser.md Power User] page on our Wiki.
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-->
Here is a simple demonstration of the workbench:
Here is a simple demonstration of the workbench:


Line 67: Line 76:
<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. See [http://wiki.povray.org/content/HowTo:Install_POV Install POV].


<!--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:


Line 79: Line 91:
<translate>
<translate>


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


<!--T:24-->
* [[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.
* [[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_PointLight.svg|32px]] Point Light: Inserts a Point Light.
* [[Image:POV-Ray-Rendering_PointLight.svg|32px]] Point Light: Inserts a Point Light.


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


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


==References==
==References== <!--T:28-->


<!--T:29-->
* Authors:
* Authors:
** Usb Hub: https://gitlab.com/usbhub
** Usb Hub: https://gitlab.com/usbhub
Line 96: Line 113:
* 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]]



Revision as of 20:10, 25 January 2022

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

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. See Install POV.

To complete the installation the path to the POV-Ray executable has to be defined in the workbench preferences:

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