Raytracing Module/fr

Le module Raytracing est utilisé pour générer des images photoréalistes de vos modèles en les interprétant avec un moteur de rendu externe. L'atelier de raytracing travaille avec modèles, de la même manière que le  Atelier de Dessin, en vous permettant de créer un projet de Raytracing dans lequel vous ajoutez des vues de vos objets. Le projet peut alors être exporté vers un fichier prêt-à-interpréter ou être interprété directement.



Actuellement, deux moteurs de rendu sont pris en charge: povray et LuxRender. Pour être en mesure d'interpréter directement à partir de FreeCAD, au moins un de ces moteurs de rendu doit être installé sur votre système, et son chemin doit être configuré dans les préférences FreeCAD Raytracing. Sans aucune moteur de rendu installé, cependant, vous êtes toujours en mesure d'exporter un fichier de scène qui peut être utilisé dans n' importe lequel de ces moteurs de rendu plus tard, ou sur une autre machine.

L'atelier raytracing travaille avec le module templates, qui sont des fichiers de scène complète pour le moteur de rendu externe, y compris les rayons et éventuellement les géométries supplémentaires tels que les plans au sol. Ces fichiers de scène contiennent des emplacements réservés, où FreeCAD insérera la position des caméras et d'informations géométriques des matériaux constituant chacun des objets que vous insérez dans le projet. Ce fichier étant mis à jour, la scène est ensuite exportée vers le moteur de rendu externe.

Travail typique

 * 1) Créez ou ouvrez un projet dans FreeCAD, ajouter quelques objets Part-based (le maillage n'est actuellement pas pris en charge)
 * 2) Créer un projet de Raytracing (luxrender ou povray)
 * 3) Sélectionnez les objets que vous souhaitez ajouter au projet raytracing et ajoutez-les au projet avec l'outil "Insert Part"
 * 4) Export ou de rendre directement

Création manuelle d'un fichier povray
Les outils utilitaires décrits ci-dessus vous permettent d'exporter l'affichage 3D actuel et tout son contenu dans un fichier Povray. Tout d'abord, vous devez charger ou créer vos données CAO et positionner l'orientation de la vue 3D que vous le souhaitez. Puis choisissez "Utilities->Export View..." dans le menu de raytracing.



Donnez un emplacement pour enregistrer le fichier *.pov. Après cela vous pouvez l'ouvrir dans Povray et obtenir le rendu :



Comme d'habitude dans un rendererer vous pouvez faire de grandes et belles photos :



Sortir des fichiers de rendu
Les modules Raytracing et RaytracingGui fournissent plusieurs méthodes pour écrire le contenu des scènes comme données povray ou LuxRender. Les plus utiles sont Raytracing.getPartAsPovray et Raytracing.getPartAsLux  pour interpréter un objet FreeCAD dans une définition de povray ou LuxRender et RaytracingGui.povViewCamera  et RaytracinGui.luxViewCamera  pour obtenir le point de vue actuel de la fenêtre 3D FreeCAD au format POV-Ray ou LuxRender.

Voici comment utiliser ces fonctions depuis l'interface Python :

Et le même pour luxrender

Création d'un rendu d' objet personnalisé
Un élément à partir des vues d'objets standards de povray et LuxRender  qui fournit une vue d'un objet partiel existant, et qui peut être inséré dans des projets de povray et LuxRender respectivement, un troisième objet existe, appelé RaySegment, qui peut être inséré dans des projets povray ou luxrender. Cet objet RaySegment n'est liée à aucun des objets FreeCAD, et peut contenir un code personnalisé povray ou LuxRender, que vous pourriez souhaiter insérer dans votre projet de raytracing. Vous pouvez également l'utiliser, par exemple, pour sortir de vos objets FreeCAD d'une certaine façon, si vous n'êtes pas satisfait de la façon standard. Vous pouvez le créer et l'utiliser comme ceci à partir de la console python:

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/

Actuellement, il y a un nouvel atelier de Rendu en développement à l'appui de plusieurs back-ends comme moteur de rendu de Lux Renderer et Yafaray. Des informations pour l'utilisation de la version en développement peuvent être consultées ici Render_project

Regardez ici pour l'état de développement du Module restituer Raytracing_project

Modèles
FreeCAD est livré avec une paire de modèles par défaut pour povray et luxrender, mais vous pouvez facilement créer votre propre modèle. Tout ce que vous devez faire est de créer un fichier de scène pour le moteur de rendu donné, puis avec un éditeur de texte, modifiez le manuellement pour insérer une balise spéciale que FreeCAD reconnaîtra et où il insérera son contenu (données de caméra et objets)

Povray
Les fichiers de scène povray (ont une extension .pov) peuvent être créés manuellement avec un éditeur de texte (povray est fait principalement pour être utilisé comme un langage de script), mais aussi avec un large éventail d'applications 3D, comme blender. Sur le site de povray vous trouverez plus d'informations et une liste des applications capables de produire des fichiers .pov.

Lorsque vous avez un fichier .pov prêt à l'emplois, vous devez l'ouvrir avec un éditeur de texte et faire deux opérations :


 * 1) Supprimer les informations de la caméra, parce que FreeCAD placera ses propres données de caméra. Pour ce faire, recherchez un bloc de texte comme ceci : camera { ... }, qui décrit les paramètres de la caméra le supprimer (ou mettre "/ /" devant chaque ligne pour commenter les sorties).
 * 2) Insérer la ligne suivante quelque part : //RaytracingContent. C'est l'endroit où FreeCAD va insérer son contenu (données de caméra et objets). Vous pouvez, par exemple, mettez cette ligne à la fin du fichier.

Notez que FreeCAD ajoutera également certaines déclarations, que vous pourrez utiliser dans votre modèle, après la balise //RaytracingContent.

Ce sont :


 * cam_location: l'emplacement de la caméra
 * cam_look_at : l'emplacement et le point de cible de la caméera
 * cam_sky    : le vecteur supérieur de la caméra.
 * cam_angle  : l'angle de la caméra

Si par exemple vous voulez placer une lampe au-dessus de la caméra, vous pouvez utiliser ceci :

Luxrender
Les fichiers LuxRender (avec extension .lxs) peuvent être des fichiers uniques, ou un fichier maître .lxs qui comprend la définition de l'ensemble (.lxw), définition de la matière (.lxm) et les fichiers de définition de géométrie (.lxo). Vous pouvez travailler avec les deux styles, mais il est également facile de transformer un groupe de 4 fichiers dans un fichier unique .lxs, en copiant le contenu des fichiers .lxw, .lxm et .lxo fichier et les coller à l'endroit où ces fichiers sont inséré dans le fichier maître .lxs.

Les fichiers LuxRender sont difficiles à produire manuellement, mais sont faciles à construire avec de nombreuses applications 3D tels que blender. Sur le site luxrender website, vous trouverez là plus d'informations et de plugins pour les principales applications 3D.

Si vous voulez travailler avec les fichiers .lxw, .lxm et .lxo séparément, prenez garde que le fichier .lxs final exporté par FreeCAD pourrait être à un autre emplacement que le fichier modèle, et donc ces fichiers pourraient être introuvable par Luxrender au temps de rendu. Dans ce cas vous devriez copier ces fichiers à l'emplacement de votre fichier final ou modifier leurs chemins dans le fichier exporté .lxs.

Si vous exportez un fichier scène de blender et désirez tout fusionner en un seul fichier, vous devez effectuer une étape avant de l'exporter : par défaut, l'exportateur de luxrender dans blender exporte toutes les géométries de maillage en tant que fichiers distincts .ply, au lieu de placer la géométrie de maille directement dans le fichier .lxo. Pour modifier ce comportement, vous devez sélectionner chacune de vos mailles dans blender, allez dans l'onglet "mesh" et définissez l'option "export as "luxrender mesh" pour chacun d'entre eux.

Quand votre fichier scène est prêt, pour le transformer en un modèle FreeCAD, vous devez effectuer les étapes suivantes:
 * 1) Localiser la position de la caméra, une seule ligne qui commence par  LookAt , et le supprimer (ou placer un "#" au début de la ligne d'en commentaire)
 * 2) à cet endroit, insérez la ligne suivante:  #RaytracingCamera 
 * 3) à un point désiré, par exemple juste après la fin les définitions matériaux, avant les informations de géométrie, ou tout à la fin, juste avant la dernière ligne  WorldEnd  , insérer la ligne suivante:  #RaytracingContent . C'est là que FreeCAD va insérer ses propres objets.

Notez que les objets luxrender, sont stockés dans un fichier de scène pouvant définir des matrices de transformation, qui affectent l'emplacement, la rotation ou la mise à l'échelle des opérations. Ces matrices peuvent empiler tout ce qui vient après, donc, en plaçant votre balise de #RaytracingContent à la fin du fichier, vous pourriez voir vos objets FreeCAD affectés par une matrice de transformation placée plus haut dans le modèle. Pour vous assurer que cela n'arrive pas, placez votre balise de #RaytracingContent</tt> avant tout autre objet géométrique présent dans le modèle. FreeCAD ne définit aucune de ces matrices de transformation.

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