POV-Ray-Rendering Workbench: Difference between revisions

Latest revision as of 10:39, 13 June 2023

Other languages:

English
français
polski

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

Authors:
- Usb Hub: https://gitlab.com/usbhub
- DerUhrmacher: https://gitlab.com/DerUhrmacher
Source code on GitHub: https://github.com/TheRaytracers/freecad-povray-render

Links to POV-Ray Workbench

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

Other useful links

External workbenches

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
+<languages/>
-{{UnfinishedDocu}}
+<translate>
+<!--T:1-->
-[[Image:POV-Ray-Rendering_workbench_icon.svg|thumb|128px|POV-Ray-Rendering External workbench icon]]
+[[Image:POV-Ray-Rendering_workbench_icon.svg|thumb|128px|POV-Ray-Rendering Workbench icon]]
-==Introduction==
+</translate>
 {{TOCright}}
+<translate>
+==Introduction== <!--T:2-->
-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.
+<!--T:3-->
-[[File:POV-Ray-Rendering Example.png]]
+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>
-==Features==
+[[File:POV-Ray-Rendering_Example.png|600px]]
+<translate>
+==Features== <!--T:4-->
-===Applying Textures===
-There are more than 100 predefined textures you can apply easily or define your own materials.
+===Applying textures=== <!--T:5-->
-[[File:POV-Ray-Rendering Textures.png]]
+<!--T:6-->
-====Thumbnails and Live Preview====
+There are more than 100 predefined textures you can apply, but you can also define your own textures.
-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.
+</translate>
-===Lightning===
+[[File:POV-Ray-Rendering_Textures.png|600px]]
-With the three light types area light, point light, spot light and their different options, you can create advanced lightnings to create the convenient atmosphere of the picture.
+<translate>
+====Thumbnails and live preview==== <!--T:7-->
-[[File:POV-Ray-Rendering Lights.png]]
+<!--T:8-->
-====Indirect Lightning (GI)====
+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.
-The workbench has the option to enable indirect lightning to create more realistic images.
+===Lighting=== <!--T:9-->
-[[File:POV-Ray-Rendering IndirectLightning.png]]
+<!--T:10-->
-===HDRI Environments===
+With the three light types: area light, point light and spot light, and their different options, you can create advanced lighting.
-With the support for HDRI environments, beautiful environments are simple to use:
+</translate>
-[[File:POV-Ray-Rendering HDRI.png]]
+[[File:POV-Ray-Rendering_Lights.png|600px]]
+<translate>
+====Indirect lighting (GI)==== <!--T:11-->
-===User Inc File===
-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]
+<!--T:12-->
-==Usage==
+The workbench has the option to enable indirect lighting to create more realistic images.
-It's a lot easier to watch this simple demo of the workbench instead of describing it:
+</translate>
-[[File:POV-Ray-Rendering Demo.gif]]
+[[File:POV-Ray-Rendering_IndirectLighting.png|600px]]
+<translate>
+===HDRI environments=== <!--T:13-->
-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]
+<!--T:14-->
-==Installation==
+With support for HDRI environments, beautiful environments are simple to use.
+</translate>
-This workbench can be easily installed and updated from the [[Image:AddonManager.svg|24px]] [[Addon Manager]] available in {{VersionPlus|0/17}} '''(not working already, has to be installed manually as described here: [https://github.com/TheRaytracers/freecad-povray-render#installation README - Installation])'''. This workbench is part of FreeCAD's [[External_workbenches|External workbenches]].
+[[File:POV-Ray-Rendering_HDRI.png|600px]]
-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
+<translate>
+===User inc file=== <!--T:15-->
-Finally the path to the POV-Ray installation has to be defined in the workbench settings:
+<!--T:16-->
-[[File:POV-Ray-Rendering ExePath.png]]
+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== <!--T:17-->
-==Tools==
-Almost every setting, except the settings of the light objects, is done in the dialog, so there are not many commands:
+<!--T:18-->
-* [[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
+Here is a simple demonstration of the workbench:
-* [[Image:POV-Ray-Rendering_PointLight.svg|32px]] [[POV-Ray-Rendering_Dialog|Point Light]]: Insert a Point Light
-* [[Image:POV-Ray-Rendering_AreaLight.svg|32px]] [[POV-Ray-Rendering_Dialog|Area Light]]: Insert an Area Light
-* [[Image:POV-Ray-Rendering_SpotLight.svg|32px]] [[POV-Ray-Rendering_Dialog|Spot Light]]: Insert a Spot Light
+</translate>
-==References==
+[[File:POV-Ray-Rendering_Demo.gif]]
-* Authors
+<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]
+==Installation== <!--T:20-->
+<!--T:21-->
+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, 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>
+[[File:POV-Ray-Rendering_ExePath.png|600px]]
+<translate>
+==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.
+<!--T:25-->
+* [[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.
+<!--T:27-->
+* [[Image:POV-Ray-Rendering_SpotLight.svg|32px]] Spot Light: Inserts a Spot Light.
+==References== <!--T:28-->
+<!--T:29-->
+* Authors:
 ** Usb Hub: https://gitlab.com/usbhub
 ** DerUhrmacher: https://gitlab.com/DerUhrmacher
 * 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
-* FreeCAD Wiki: XXX
 * 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 == <!--T:32-->
+<!--T:33-->
-== Other useful links ==
+* [[External_workbenches|External workbenches]]
-* [[External workbenches]]: A list of external Addon workbenches available to use in FreeCAD via the [[Addon Manager]]
-* [[Template:DevWorkbenches|DevWorkbenches]]: List of workbenches in development.
+</translate>
-[[Category:Addons]]
+{{Userdocnavi{{#translation:}}}}
+[[Category:Addons{{#translation:}}]]
+[[Category:External Workbenches{{#translation:}}]]