Raytracing tutorial: Difference between revisions

From FreeCAD Documentation
m (minor for translation)
m (png to svg)
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>


<!--T:1-->
<!--T:1-->
{{TutorialInfo
{{TutorialInfo
|Class= Raytracing
|Topic= Raytracing
|Level= Beginner
|Level= Beginner
|Time= 10 minutes + Render time
|Time= 10 minutes + Render time
Line 11: Line 12:
}}
}}


=== Introduction === <!--T:2-->
== Introduction == <!--T:2-->
This tutorial is meant to introduce the reader to the basic workflow of the Raytracing Workbench, as well as most of the tools that are available to create a rendered image.
This tutorial is meant to introduce the reader to the basic workflow of the Raytracing Workbench, as well as most of the tools that are available to create a rendered image.


</translate>
<!--T:3-->
[[Image:Raytracing_tutorial_result.png|480px]]
[[Image:Raytracing_tutorial_result.png|480px]]
<translate>

=== Requirements === <!--T:4-->
== Requirements == <!--T:4-->
* FreeCAD version 0.16 or above
* FreeCAD version 0.16 or above
* [http://www.povray.org/ POV-Ray] and/or [http://www.luxrender.net/ LuxRender] is installed on the system
* [http://www.povray.org/ POV-Ray] and/or [http://www.luxrender.net/ LuxRender] is installed on the system
* In the case of POV-Ray, it's not enough to have just the binary executable in place, but it also '''''requires''''' the installation of '''''supporting files''''', and in Ubuntu these are provided by the Recommends-flagged package [https://packages.ubuntu.com/search?keywords=povray-includes povray-includes]. Potential issues have also been seen with Linux installations requiring local configuration files to be manually created in a user's home folder, as discussed [https://forum.freecadweb.org/viewtopic.php?f=3&t=27548&start=10#p224576 here].
* In the case of POV-Ray, installation of [https://github.com/psicofil/Macros_FreeCAD psicofil's macro] is recommended
* In the case of POV-Ray, installation of [https://github.com/psicofil/Macros_FreeCAD psicofil's macro] is recommended
* The reader has the basic knowledge to use the Part and PartDesign Workbenches
* The reader has the basic knowledge to use the Part and PartDesign Workbenches


=== Procedure === <!--T:5-->
== Procedure == <!--T:5-->


==== Modeling ==== <!--T:6-->
=== Modeling === <!--T:6-->
In this example a Cube is used as the study object, but models created in the Part or PartDesign Workbenches can be used instead.
In this example a Cube is used as the study object, but models created in the Part or PartDesign Workbenches can be used instead.


Line 34: Line 36:


<!--T:8-->
<!--T:8-->
Now we have a model with which to work with.
Now we have a model with which to work.


==== Preparing for the render ==== <!--T:9-->
=== Preparing for the render === <!--T:9-->
# Switch to the Raytracing Workbench
# Switch to the Raytracing Workbench
# Change your View to '''Perspective'''. Go to '''View''' menu and select '''Perspective'''.
# Change your View to '''Perspective'''. Go to '''View''' menu and select '''Perspective'''.
Line 42: Line 44:
# Set the size of the rendered image. Go to the '''Edit''' menu and select '''Preferences'''. Click on '''Raytracing''' and set the desired image size.
# Set the size of the rendered image. Go to the '''Edit''' menu and select '''Preferences'''. Click on '''Raytracing''' and set the desired image size.


===== POV-Ray ===== <!--T:10-->
==== POV-Ray ==== <!--T:10-->
# Select [[Image:Raytracing_New.png|32px]] [[Raytracing_New|New PovRay project]]. From the dropdown menu pick '''RadiosityNormal'''
# Select [[Image:Raytrace_New.svg|32px]] [[Raytracing_New|New PovRay project]]. From the dropdown menu pick '''RadiosityNormal'''


===== LuxRender ===== <!--T:11-->
==== LuxRender ==== <!--T:11-->
# Select [[Image:Raytracing_Lux.png|32px]] [[Raytracing_Lux|New LuxRender project]]. From the dropdown menu pick '''LuxClassic'''
# Select [[Image:Raytrace_Lux.svg|32px]] [[Raytracing_Lux|New LuxRender project]]. From the dropdown menu pick '''LuxClassic'''


==== Setting the camera position ==== <!--T:12-->
=== Setting the camera position === <!--T:12-->
# Position the '''3D View''' to the desired location and distance from the model. In this case we will use the '''Axonometric View'''.
# Position the '''3D View''' to the desired location and distance from the model. In this case we will use the '''Axonometric View'''.
# Select the '''Project Folder''' from the '''Tree View'''
# Select the '''Project Folder''' from the '''Tree View'''
# Select [[Image:Raytracing_ResetCamera.png|32px]] [[Raytracing_ResetCamera|Reset camera]]
# Select [[Image:Raytrace_ResetCamera.svg|32px]] [[Raytracing_ResetCamera|Reset camera]]


==== Importing the model ==== <!--T:13-->
=== Importing the model === <!--T:13-->
# Select the model to render.
# Select the model to render.
# Select [[Image:Raytracing_InsertPart.png|32px]] [[Raytracing_InsertPart|Insert part]]
# Select [[Image:Raytrace_NewPartSegment.svg|32px]] [[Raytracing_InsertPart|Insert part]]


==== Running the Renderer ==== <!--T:14-->
=== Running the Renderer === <!--T:14-->
# Select [[Image:Raytracing_Render.png|32px]] [[Raytracing_Render|Render]].
# Select [[Image:Raytrace_Render.svg|32px]] [[Raytracing_Render|Render]].
# Set the path to which the image will be stored.
# Set the path to which the image will be stored.
# Wait for the rendering to finish. This may take a while.
# Wait for the rendering to finish. This may take a while.


==== Viewing the results ==== <!--T:15-->
=== Viewing the results === <!--T:15-->
FreeCAD will immediately open the image after the render is finished.
FreeCAD will immediately open the image after the render is finished.


<!--T:16-->
<!--T:16-->
We are now finished with the basic workflow for the [[Raytracing Module]].
We are now finished with the basic workflow for the [[Raytracing Module|Raytracing Module]].


[[Category:User Documentation]]
[[Category:Tutorials]]

</translate>
</translate>
{{Tutorials navi{{#translation:}}}}
{{clear}}
{{Raytracing Tools navi{{#translation:}}}}
<languages/>
{{Userdocnavi{{#translation:}}}}

Revision as of 21:53, 26 February 2020

Tutorial
Topic
Raytracing
Level
Beginner
Time to complete
10 minutes + Render time
Authors
Drei
FreeCAD version
0.16 or above
Example files
See also
None

Introduction

This tutorial is meant to introduce the reader to the basic workflow of the Raytracing Workbench, as well as most of the tools that are available to create a rendered image.

Requirements

  • FreeCAD version 0.16 or above
  • POV-Ray and/or LuxRender is installed on the system
  • In the case of POV-Ray, it's not enough to have just the binary executable in place, but it also requires the installation of supporting files, and in Ubuntu these are provided by the Recommends-flagged package povray-includes. Potential issues have also been seen with Linux installations requiring local configuration files to be manually created in a user's home folder, as discussed here.
  • In the case of POV-Ray, installation of psicofil's macro is recommended
  • The reader has the basic knowledge to use the Part and PartDesign Workbenches

Procedure

Modeling

In this example a Cube is used as the study object, but models created in the Part or PartDesign Workbenches can be used instead.

  1. Create a new document
  2. Activate the Part Workbench
  3. Create a Cube. You are free to change its properties in any way.

Now we have a model with which to work.

Preparing for the render

  1. Switch to the Raytracing Workbench
  2. Change your View to Perspective. Go to View menu and select Perspective.
  3. Set the location for the renderer. Go to the Edit menu and select Preferences. Click on Raytracing and set the location to the executable.
  4. Set the size of the rendered image. Go to the Edit menu and select Preferences. Click on Raytracing and set the desired image size.

POV-Ray

  1. Select New PovRay project. From the dropdown menu pick RadiosityNormal

LuxRender

  1. Select New LuxRender project. From the dropdown menu pick LuxClassic

Setting the camera position

  1. Position the 3D View to the desired location and distance from the model. In this case we will use the Axonometric View.
  2. Select the Project Folder from the Tree View
  3. Select Reset camera

Importing the model

  1. Select the model to render.
  2. Select Insert part

Running the Renderer

  1. Select Render.
  2. Set the path to which the image will be stored.
  3. Wait for the rendering to finish. This may take a while.

Viewing the results

FreeCAD will immediately open the image after the render is finished.

We are now finished with the basic workflow for the Raytracing Module. Template:Tutorials navi