Raytracing Workbench/ro

Atelierul de Iluminare este folosit pentru a genera imagini fotorealiste ale modelelor dvs., făcându-le cu o randare externă. Atelierul de Iluminare funcționează împreună cu modulul templates, permițându-vă să creați un proiect Raytracing în care adăugați vederi ale obiectelor. Proiectul poate fi apoi exportat într-un fișier gata de redare sau poate fi redat direct.



În mod obișnuit, sunt susținute două tipuri de randare: povray și luxrender. Pentru a putea reda direct din FreeCAD, cel puțin unul dintre acestea randări trebuie instalat pe sistemul dvs., iar calea trebuie să fie configurată în preferințele FreeCAD Raytracing. Fără instalarea oricăror elemente de randare, totuși, puteți să exportați un fișier scenă care poate fi folosit ulterior în oricare dintre aceste tipuri de randare sau pe altă mașină.

Atelierul de iluminare funcționează împreună cu modulele templates, care reprezintă fișiere de scenă complete pentru randarea exteriorului dat, inclusiv luminile și eventual geometria suplimentară, cum ar fi planurile de la sol. Aceste fișiere de scenă conțin locașuri, în care FreeCAD va introduce poziția camerei, precum și informații despre geometrie și materiale ale fiecăruia dintre obiectele inserate în proiect. Acest fișier scena modificat este ceea ce este apoi exportat la randarele externe.

Flux de lucru tipic

 * 1) Creați sau deschideți un proiect FreeCAD, adăugați unele obiecte  Part-based (mesh-urile nu sunt acceptate în prezent)
 * 2) Creați un proiect Raytracing (cu luxrender sau povray)
 * 3) Selectați obiectele pe care doriți să le adăugați la proiectul raytracing și adăugați-le la proiect cu instrumentul "Inserați o piesă"
 * 4) Exportați sau afișați direct

Crearea manuală a unui fișier povray
Instrumentele utilitare descrise mai sus vă permit să exportați vizualizarea 3D curentă și întregul conținut al acestuia într-un fișier Povray. În primul rând, trebuie să încărcați sau să creați datele CAD și să poziționați orientarea 3D în orientarea dorită. Apoi alegeți "Utilities-> Export View ..." din meniul raytracing.



Vi se va solicita o locație pentru salvarea fișierului * .pov rezultat. După asta, poți să o deschizi Povray and render:



Ca de obicei, prin randare poți face poze mari și frumoase:



Ieșirea fișierelor de randare
Modulele Raytracing și RaytracingGui oferă mai multe metode pentru a scrie conținutul scenelor ca date povray sau luxrender. Cele mai utile sunt Raytracing.getPartAsPovray și Raytracing.getPartAsLux  pentru a reanda un obiect FreeCAD Part într-o definiție povray sau luxrender și RaytracingGui.povViewCamera  și RaytracinGui.luxViewCamera  pentru a obține punctul de vedere curent al FreeCAD în Fereastră 3D în format povray sau luxrender.

Iată cum se poate scrie un fișier povray din Python, presupunând că documentul conține un obiect "Box":

La fel și pentru luxrender:

Crearea unui obiect particularizat de randare
În afară de obiectele standard povray și luxrender care oferă o vizualizare a unui obiect Piesă existent și care pot fi inserate în proiecte povray și luxrender, există un al treilea obiect numit RaySegment, care poate fi inserat fie în proiecte povray, fie în proiecte luxrender. Acest obiect RaySegment nu este conectat la niciunul dintre obiectele FreeCAD și poate conține coduri personalizate sau coduri luxrender, pe care ați putea dori să le inserați în proiectul dvs. de raytracing. De asemenea, îl puteți utiliza, de exemplu, pentru a vă da obiectele FreeCAD într-un anumit mod, dacă nu sunteți mulțumit de modul standard. Puteți să o creați și să o utilizați astfel de pe consola python:

POVRay

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

Luxrender

 * http://www.luxrender.net/

viitoare posiblile randări de implementat

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

În prezent, există un nou Atelier Renderer în dezvoltare pentru a sprijini multiple back-end-uri precum Lux Renderer și Yafaray. Informațiile pentru utilizarea versiunii în dezvoltare pot fi vizualizate laRender_project

Pentru a afla stadiul de dezvoltare al Render Module căutați aici Raytracing_project

Templates
FreeCAD vine cu câteva șabloane implicite pentru povray și luxrender, dar puteți a vi le crea cu ușurință propriile dvs. șabloane. Tot ce trebuie să faceți este să creați un fișier de scenă pentru randarea dată, apoi să îl editați manual cu un editor de text pentru a insera tag-uri speciale pe care FreeCAD le va recunoaște și unde va introduce conținutul lor (date despre camere și obiecte)

Povray
Fișierele de scenă povray (cu extensia .pov) pot fi create manual cu un editor de text (povray este făcut în principal pentru a fi folosit ca limbaj de scripting), dar și cu o gamă largă de aplicații 3D, cum ar fi [http: // www. blender.org blender]. Pe site-ul povray puteți găsi informații suplimentare și o listă de aplicații capabile să producă fișiere .pov.

Când aveți un fișier .pov gata, trebuie să îl deschideți cu un editor de text și să efectuați două operații:
 * 1) Scoateți informațiile despre cameră, deoarece FreeCAD va plasa propriile date despre cameră. Pentru a face acest lucru, localizați un bloc de text ca acesta: camera{...}, care descrie parametrii camerei și șterge (sau pune "//" în fața fiecărei linii pentru a le comenta ).
 * 2) Introduceți următoarea linie undeva: //RaytracingContent. Aici FreeCAD va introduce conținutul său (date despre camere și obiecte). Puteți, de exemplu, să puneți această linie la sfârșitul fișierului.

Rețineți că FreeCAD va adăuga și unele declarații pe care le puteți utiliza în șablon după eticheta //RaytracingContent. Acestea sunt:
 * cam_location: locația camerei
 * cam_look_at: locația punctului țintă al camerei
 * cam_sky: vectorul sus al camerei.
 * cam_angle: unghiul camerei

Dacă doriți, de exemplu, să plasați o lampă deasupra camerei, puteți utiliza aceasta:

Luxrender
Luxrender scene files (with extension.lxs) can either be single files, or a master .lxs file that includes world definition (.lxw), material definition (.lxm) and geometry definition (.lxo) files. You can work with both styles, but it is also easy to transform a group of 4 files in a single .lxs file, by copying the contents of each .lxw, .lxm and .lxo file and pasting it at the point where that file is inserted in the master .lxs file.

Luxrender scene files are hard to produce by hand, but are easy to produce with many 3D applications such as blender. On the luxrender website, you'll find more information and plugins for the main 3D applications out there.

If you will work with separated .lxw, .lxm and .lxo files, beware that the final .lxs exported by FreeCAD might be at a different location than the template file, and therefore these files might not be found by Luxrender at render time. In this case you should or copy these files to the location of your final file, or edit their paths in the exported .lxs file.

If you are exporting a scene file from blender, and wish to merge everything into one single file, you will need to perform one step before exporting: By default, the luxrender exporter in blender exports all mesh geometry as separate .ply files, instead of placing the mesh geometry directly inside the .lxo file. To change that behaviour, you need to select each of your meshes in blender, go to the "mesh" tab and set the option "export as" to "luxrender mesh" for each one of them.

After you have your scene file ready, to turn it into a FreeCAD template, you need to perform the following steps:
 * 1) Locate the camera position, a single line that begins with LookAt, and delete it (or place a "#" at the beginning of the line to comment it out)
 * 2) At that place, insert the following line: #RaytracingCamera
 * 3) At a desired point, for example just after the end of the materials definition, before the geometry information, or at the very end, just before the final WorldEnd line, insert the following line: #RaytracingContent. That is where FreeCAD will insert its own objects.

Note that in luxrender, the objects stored in a scene file can define transformation matrixes, that perform location, rotation or scaling operations. These matrixes can stack and affect everything that come after them, so, by placing your #RaytracingContent tag at the end of the file, you might see your FreeCAD objects affected by a transformation matrix placed earlier in the template. To make sure that this doesn't happen, place your #RaytracingContent</tt> tag before any other geometry object present in the template. FreeCAD itself won't define any of those transformation matrixes.

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

Links

 * Render project
 * Raytracing tutorial