Raytracing Module/it

Introduzione
Il modulo Raytracing viene utilizzato per generare immagini fotorealistiche dei modelli elaborandole con un renderer esterno.

Il modulo Raytracing lavora con dei modelli, che sono dei file della scena completati per un dato renderer esterno, comprese le luci e eventuali geometrie aggiuntive, come i piani di appoggio. Questi file di scena contengono dei segnaposto, dove FreeCAD inserisce le informazioni per la posizione della fotocamera, la geometria e il materiale di ogni oggetto del progetto. Questo file di scena modificato è il file che viene poi esportato verso il renderer esterno.

Attualmente sono supportati due renderizzatori: povray e luxrender. Per poter eseguire il rendering direttamente da FreeCAD, sul sistema deve essere installato almeno uno di questi renderer, e deve essere configurato il suo percorso nelle preferenze di FreeCAD per Raytracing. Senza alcun renderer installato, si può comunque esportare un file della scena e utilizzarlo successivamente in uno di questi renderer, o su una macchina diversa.

Attualmente vi è un nuovo Ambiente Renderer in fase di sviluppo per supportare diversi back-end, come Lux Renderer e YafaRay. Le informazioni per l'utilizzo della versione di sviluppo possono essere visionate nel progetto Render.



Project tools
These are the main tools for exporting your 3D work to external renderers.
 * [[Image:Raytracing_New.png|32px]] New PovRay project: Insert new PovRay project in the document
 * [[Image:Raytracing_Lux.png|32px]] New LuxRender project: Insert new LuxRender project in the document
 * [[Image:Raytracing_InsertPart.png|32px]] Insert part: Insert a view of a Part in a raytracing project
 * [[Image:Raytracing_ResetCamera.png|32px]] Reset camera: Matches the camera position of a raytracing project to the current view
 * [[Image:Raytracing_ExportProject.png|32px]] Export project: Exports a raytracing project to a scene file for rendering in an external renderer
 * [[Image:Raytracing_Render.png|32px]] Render: Renders a raytracing project with an external renderer

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:Std_DlgParameter.png|32px]] Preferences: Preferences available in for the Raytracing tools.

Flusso di lavoro tipico

 * 1) Creare o aprire un progetto di FreeCAD, aggiungere alcuni oggetti basati sul modulo Part (i mesh non sono ancora supportati)
 * 2) Creare un progetto Raytracing (luxrender o povray)
 * 3) Selezionare gli oggetti che si desidera aggiungere al progetto raytracing e aggiungerli con lo strumento "Inserisci Parte"
 * 4) Esportare o elaborare direttamente

Creare manualmente un file povray
Gli strumenti di utilità descritti prima consentono di esportare la corrente vista 3D e tutto il suo contenuto in un file Povray. In primo luogo, è necessario caricare un documento o crearne uno e poi orientare la vista 3D come si desidera. Dopo, scegliere Esporta la vista ... nel menu di Raytracing.



Nella finestra di dialogo Esporta pagina, selezionare la destinazione per salvare il file *.pov. Successivamente aprire il file in Povray e generare la renderizzazione:

Come è noto, le applicazioni di renderizzazione possono produrre immagini di grandi dimensioni e ottima qualità:

Script
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/

Render per future implementazioni

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

Esportare in Kerkythea
Sebbene l'esportazione diretta nel formato XML di Kerkythea non sia ancora supportata, è possibile esportare gli oggetti come file Mesh (.obj) e poi importarli in Kerkythea.
 * se si utilizza Kerkythea per Linux, ricordarsi di installare il pacchetto WINE (necessario per far funzionare Kerkythea in Linux)
 * è possibile convertire i modelli in mesh con l'aiuto dell'ambiente Mesh e poi esportare questi mesh, come file .obj
 * 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.)


 * è possibile utilizzare "make compound" e poi "make single copy" oppure è possibile fondere i solidi in un gruppo prima di convertirli in mesh
 * ricordatevi di impostare in Kerkythea un fattore di importazione di 0.001 per obj-modeler, in quanto Kerkythea si aspetta che il file obj sia in m (ma l'unità standard in FreeCAD è il 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


 * se si importano più oggetti in Kerkythea è possibile utilizzare la funzione "File> Unisci" di Kerkythea

Links

 * Progetto Render
 * Tutorial di Raytracing
 * Raytracing tutorial (forum link)