POV-Ray-Rendering Workbench: Difference between revisions

Revision as of 20:10, 25 January 2022

Other languages:

English
français
polski

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.

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

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{{#translation:}}}}
 <translate>
-{{UnfinishedDocu}}
+<!--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}}. 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. 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:
+</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 ==
+== Other useful links == <!--T:32-->
+<!--T:33-->
 * [[External_workbenches|External workbenches]]
 </translate>
+{{Userdocnavi{{#translation:}}}}
-[[Category:Addons]]
+[[Category:Addons{{#translation:}}]]
+[[Category:External Workbenches{{#translation:}}]]