Raytracing Module/pt-br

Introdução
A Bancada de Trabalho Raytracing é usada para gerar imagens fotorrealistas de seus modelos, processando-os com um renderizador externo.

A bancada Raytracing trabalha com templates, que são arquivos de projeto que definem uma cena para seu modelo 3D. Você pode colocar luzes e geometrias, como planos de base, e também contém espaços reservados para a posição da câmera e para as informações do material dos objetos na cena. O projeto pode ser exportado para um arquivo pronto para renderização ou renderizado diretamente no FreeCAD.

Atualmente, dois renderizadores são suportados: povray e luxrender. Para poder renderizar a partir do FreeCAD, pelo menos um desses programas deve ser instalado e configurado em seu sistema. No entanto, se nenhum renderizador estiver instalado, você ainda poderá exportar um arquivo de projeto para ser renderizado em outro momento.

Uma nova bancada Render está em desenvolvimento para suportar múltiplos back-ends como o Lux Renderer e o Yafaray. Informações para usar a versão de desenvolvimento podem ser visualizadas em Render project. Para o status de desenvolvimento do Módulo Render, procure no projeto Raytracing project.



Fluxo de trabalho típico

 * 1) Crie ou abra um projeto do FreeCAD, adicione alguns objetos sólidos ( Part-based ou  PartDesign-based); malhas atualmente não são suportadas.
 * 2) Crie um projeto de Raytracing (povray ou luxrender).
 * 3) Selecione os objetos que você deseja adicionar ao projeto Raytracing e adicione-os.
 * 4) Exportar o arquivo do projeto ou renderizá-lo diretamente.



Ferramentas de Projeto
Essas são as principais ferramentas para exportar o seu trabalho 3D para os renderizadores externos:
 * [[Image:Raytracing_New.png|32px]] Novo Projeto PovRay: Insere um novo projeto PovRay no documento.
 * [[Image:Raytracing_Lux.png|32px]] Novo Projeto LuxRender: Insere um novo projeto LuxRender in no documento.
 * [[Image:Raytracing_InsertPart.png|32px]] Inserir Peça: Insere uma vista de uma Peça em um projeto do Raytracing.
 * [[Image:Raytracing_ResetCamera.png|32px]] Redefinir camera: Corresponde a posição da câmera de um projeto Raytracing à visão atual.
 * [[Image:Raytracing_ExportProject.png|32px]] Exportar projeto: Exporta um projeto raytracing para o arquivo de cena para renderizar em um renderizador externo.
 * [[Image:Raytracing_Render.png|32px]] Renderizador: Renderiza um projeto raytracing com um renderizador externo.

Utilities
These are helper tools to perform specific tasks manually.
 * [[Image:Raytracing_Export.png|32px]] Export view to povray: Write the active 3D view with camera and all its content to a povray file
 * [[Image:Raytracing_Camera.png|32px]] Export camera to povray: Export the camera position of the active 3D view in POV-Ray format to a file
 * [[Image:Raytracing_Part.png|32px]] Export part to povray: Write the selected Part (object) as a povray file

Preferences

 * [[Image:Preferences-raytracing.svg|32px]] Preferences: Preferences available in for the Raytracing tools.

Tutorials

 * Basic Raytracing tutorial
 * Intermediate Raytracing tutorial

Creating a povray file manually
The utility tools described above allow you to export the current 3D view and all of its content to a Povray file. First, you must load or create your CAD data and position the 3D View orientation as you wish. Then choose "Utilities → Export View..." from the raytracing menu.



You will be asked for a location to save the resulting *.pov file. After that you can open it in Povray and render:

As usual in a renderer you can make big and nice pictures:

Scripting
See the Raytracing API example for information on writing scenes programmatically.

POVRay

 * http://www.spiritone.com/~english/cyclopedia/
 * http://www.povray.org/
 * http://en.wikipedia.org/wiki/POV-Ray

Luxrender

 * http://www.luxrender.net/

Future possible renderers to implement

 * http://www.yafaray.org/
 * http://www.mitsuba-renderer.org/
 * http://www.kerkythea.net/
 * http://www.artofillusion.org/

Exporting to Kerkythea
Although direct export to the Kerkythea XML-File-Format is not supported yet, you can export your Objects as Mesh-Files (.obj) and then import them in Kerkythea.
 * if using Kerkythea for Linux, remember to install the WINE-Package (needed by Kerkythea for Linux to run)
 * you can convert your models with the help of the mesh workbench to meshes and then export these meshes as .obj-files
 * If your mesh-export resulted in errors (flip of normals, holes ...) you may try your luck with netfabb studio basic
 * Free for personal use, available for Windows, Linux and Mac OSX.
 * It has standard repair tools which will repair you model in most cases.


 * another good program for mesh analysing/repairing is Meshlab
 * Open Source, available for Windows, Linux and Mac OSX.
 * It has standard repair tools which will repair you model in most cases (fill holes, re-orient normals, etc.)


 * you can use "make compound" and then "make single copy" or you can fuse solids to group them before converting to meshes
 * remember to set in Kerkythea an import-factor of 0.001 for obj-modeler, since Kerkythea expects the obj-file to be in m (but standard units-scheme in FreeCAD is mm)
 * Within WIndows 7 64-bit Kerkythea does not seem to be able to save these settings.
 * So remember to do that each time you start Kerkythea


 * if importing multiple objects in Kerkythea you can use the "File → Merge" command in Kerkythea

Development

 * Render project