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 file di progetto che definiscono una scena per il modello 3D. È possibile posizionare luci e geometrie come i piani terra e contiene anche i segnaposto per la posizione della telecamera e per le informazioni sul materiale degli oggetti nella scena. Il progetto può quindi essere esportato in un file pronto per il rendering o essere eseguito direttamente in FreeCAD.

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. Per lo stato di sviluppo del modulo Render, vedere il Progetto Raytracing.



Flusso di lavoro tipico

 * 1) Creare o aprire un progetto di FreeCAD, aggiungere alcuni oggetti solidi sul modulo Part o PartDesign-based; 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



Strumenti di progetto
Questi sono gli strumenti principali per esportare il proprio lavoro 3D su renderer esterni.
 * [[Image:Raytracing_New.png|32px]] Nuovo progetto PovRay: inserisce un nuovo progetto PovRay nel documento.
 * [[Image:Raytracing_Lux.png|32px]] Nuovo progetto LuxRender: inserisce un nuovo progetto LuxRender nel documento.
 * [[Image:Raytracing_InsertPart.png|32px]] Inserisci parte: inserisce una vista di una parte in un progetto di raytracing.
 * [[Image:Raytracing_ResetCamera.png|32px]] Reset camera: abbina la posizione della telecamera di un progetto di raytracing alla vista corrente.
 * [[Image:Raytracing_ExportProject.png|32px]] Esporta progetto...: esporta un progetto di raytracing in un file di scena per il rendering in un renderer esterno.
 * [[Image:Raytracing_Render.png|32px]] Render: esegue il rendering di un progetto raytracing con un renderer esterno.

Utilità
Questi sono degli strumenti di supporto per eseguire manualmente azioni specifiche.
 * [[Image:Raytracing_Export.png|32px]] Esporta la vista in PovRay...: scrive la vista 3D attiva con la fotocamera e tutto il suo contenuto in un file PovRay.
 * [[Image:Raytracing_Camera.png|32px]] Esporta la camera in PovRay...: esporta la posizione della telecamera della vista 3D attiva in un file in formato POV-Ray.
 * [[Image:Raytracing_Part.png|32px]] Esporta la parte in PovRay...: scrive la Parte selezionata (oggetto) come un file POV-Ray.

Preferenze

 * [[Image:Preferences-raytracing.svg|32px]] Preferenze: preferenze disponibili per gli strumenti Raytracing.

Tutorials

 * Basic Raytracing tutorial
 * Intermediate Raytracing tutorial

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 Utilità → 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
Vedere Esempio di API Raytracing per informazioni sulla scrittura di scene a livello di codice.

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

Development

 * Progetto Render