POV-Ray-Rendering Workbench: Difference between revisions

From FreeCAD Documentation
(Wiki code...)
m (Added {{UnfinishedDocu{{#translation:}}}})
(22 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]] which is built to create renderings easily but also offering advanced 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>
[[File:POV-Ray-Rendering_Example.png]]
[[File:POV-Ray-Rendering_Example.png|600px]]
<translate>
<translate>


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


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


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


</translate>
</translate>
[[File:POV-Ray-Rendering_Textures.png]]
[[File:POV-Ray-Rendering_Textures.png|600px]]
<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. If you want to see the impact of changed options of the texture, you can use the live preview that renders the chosen texture and the options to fine tune the material.
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, spot light and their different options, you can create advanced lightings to create the convenient atmosphere of the picture.
With the three light types: area light, point light and spot light, and their different options, you can create advanced lighting.


</translate>
</translate>
[[File:POV-Ray-Rendering_Lights.png]]
[[File:POV-Ray-Rendering_Lights.png|600px]]
<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]]
[[File:POV-Ray-Rendering_IndirectLighting.png|600px]]
<translate>
<translate>


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


<!--T:14-->
With the 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]]
[[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 in the other tabs you can explore by yourself, or look into 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 easily installed and updated from the [[Image:AddonManager.svg|24px]] [[Addon Manager]] available in {{VersionPlus|0/17}}. This workbench is part of FreeCAD's [[External_workbenches|External workbenches]].
After the workbench is installed, the renderer in the background, POV-Ray, must be installed. How to do this is described here: http://wiki.povray.org/content/HowTo: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-->
Finally the path to the POV-Ray installation has to be defined in the workbench settings:
To complete the installation the path to the POV-Ray executable has to be defined in the workbench preferences:


</translate>
</translate>
[[File:POV-Ray-Rendering ExePath.png]]
[[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]] [[POV-Ray-Rendering_Dialog|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]] [[POV-Ray-Rendering_Dialog|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]] [[POV-Ray-Rendering_Dialog|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]] [[POV-Ray-Rendering_Dialog|Spot Light]]: Insert a Spot Light

==References==


<!--T:29-->
* Authors:
* Authors:
** Usb Hub: https://gitlab.com/usbhub
** Usb Hub: https://gitlab.com/usbhub
Line 99: 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 Wiki: XXX
* 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