FAQ/fr

Cette page tente de répondre aux questions les plus fréquemment posées sur les forums FreeCAD.

Si vous avez un problème ou une question concernant FreeCAD, vérifiez ci dessous avant tout. Puis, si vous ne trouvez pas de réponse à votre question, allez voir et au besoin poster sur le forum de FreeCAD !

Quel est le moyen le plus facile, pour installer FreeCAD sur mon système ?
Vous utilisez Windows ou Mac OS, le plus simple, est de se diriger vers la page de téléchargement, où, vous trouverez plusieurs de packages pour Windows, Linux et les systèmes Mac OSX. Si vous êtes sur une distribution Debian, Fedora ou Ubuntu ou une autre distribution, FreeCAD est déjà inclus dans les dépôts de logiciels standard, et vous pouvez simplement l'installer avec le gestionnaire de logiciels.

Sur Ubuntu, l'équipe de FreeCAD maintient également son propre PPA repositories.

Que faire si je veux compiler FreeCAD moi-même ?
In contrast to most 3D CAD software, FreeCAD can run smoothly on the most modest computers - it's been known to run on Pentium IV and Intel Core2 Solo CPUs. If your computer is running a current operating system, chances are FreeCAD will run. The only prerequisite is that your graphics card or chipset must support OpenGL, preferably no older than v2.0. In case of problems, refer to the Troubleshooting section of this FAQ.

Multithreading
FreeCAD's underlying geometric modeling kernel (which is a third-party library called Open CASCADE Technology, or OCC for short) does not support multithreading at this time.

For Mac users
Only the MacIntel architecture is supported. There are no builds available for the PowerPC architecture.

Que faire si je veux compiler FreeCAD moi-même ?
Le code source de FreeCAD est toujours disponible dans le référentiel de code source du projet. Compiler FreeCAD, vous permet d'utiliser les fonctionnalités les plus récentes en cours de développement, mais nécessite un peu de connaissances en informatique, bien que la procédure soit assez simple. L'accès au code source est accessible ici, et nous avons des instructions détaillées pour la compilation sur Windows, Linux et Mac OSX.

FreeCAD me signale que certains modules ou applications sont manquants
FreeCAD a besoin de beaucoup d'outils pour fournir toutes ses fonctionnalités. Tous les composants requis sont habituellement regroupés au sein de votre installation de FreeCAD ou fournis par votre gestionnaire de paquets, donc, normalement, vous n'avez rien à craindre. Toutefois, si vous installez FreeCAD provenant de sources non officielles, ou compilez FreeCAD vous-même, quelques pièces qui ne sont pas essentielles à FreeCAD, peuvent être manquantes, et certaines fonctionnalités ne seront pas disponibles. Certains types de formats de fichiers spécifiques comme Collada ou DWG nécessitent également des composants supplémentaires, qui ne peuvent pas être regroupés dans FreeCAD et doivent être installés séparément par vous-même.

Tous ces composants et la manière appropriée pour les installer sont répertoriés sur la page Extra python modules.

FreeCAD ne démarre pas du tout
Il pourrait y avoir beaucoup de raisons pour que FreeCAD ne fonctionne pas, le plus probable est que certaines bibliothèques sont manquantes. Essayez de démarrer FreeCAD à partir d'un terminal (type FreeCAD dans un terminal) pour voir si un message d'erreur apparaît. Aussi, lisez le reste de cette FAQ car il peut vous donner plusieurs indices pour détecter la cause du problème.

Si rien n'y fait, rapportez ce type d'erreur sur le forum, il y aura sûrement quelqu'un qui pourra vous aider ...

Sur des anciens systèmes Windows XP, vous pouvez obtenir un message d'erreur comme celui-ci: '''The application can't start, because the side-by-side configuration is wrong. The reinstallation of the application may solve the problem'''. La raison de ce problème, est, soit les bibliothèques CRT d'exécution sont manquants sur votre système, ou la version installée est trop ancienne, parce-que FreeCAD est lié à une version plus récente.

Dans ce cas, vous devez installer le Package Microsoft Visual C + + Redistributable que vous trouverez chez Microsoft. Allez voir aussi les messages correspondants sur le forum.

FreeCAD démarre normalement, mais toutes les icônes ne sont pas affichées, certaines d'entre elles sont remplacées par un 'X' noir
A l'heure actuelle, sur certains autres systèmes, vous pourriez avoir à compiler Pivy vous-même. Notez, bien que certains outils ne sont pas disponibles sans Pivy, le reste de FreeCAD fonctionne normalement.

J'ai des problèmes d'affichage, la vue 3D ne se comporte pas correctement, il y a des résidus, trainées quand je bouge/fait pivoter la vue, etc ..
FreeCAD dépend d'OpenGL pour l'affichage des contenus 3D, et nécessite donc un environnement de travail OpenGL. Sur certains systèmes, OpenGL n'est pas activé par défaut, et vous pourriez avoir besoin d'installer ou de mettre à jour vos pilotes graphiques.

Cela posait des problèmes qui se passaient le plus souvent sur les systèmes Linux ou sur les systèmes virtuels. Si vous êtes sur un système basé sur Linux, essayez les étapes suivantes :
 * Vérifier que votre ordinateur dispose d'une carte graphique capable d'afficher la 3D.
 * Tapez glxinfo dans la fenêtre d'un terminal, et de vérifiez si, sortie Direct Rendering est réglé sur oui, et que la version OpenGL/renderer correspond bien à votre carte graphique.
 * Installez d'autres logiciels basés sur OpenGL comme ([Blender] par exemple) et vérifiez s'il s'exécute et s'affiche correctement.

FreeCAD bloque au démarrage
Un crash pourrait indiquer un bug plus grave, ou un problème dans votre configuration.

La plupart des crash se produisent, à cause de l'une des deux raisons suivantes:

Les pilotes OpenGL ne sont pas installés, ou ne fonctionnent pas correctement
Il s'agit d'une cause de problème très fréquente. Les symptômes sont tout simplement que les accidents de FreeCAD au démarrage, ou chaque fois que vous ouvrez une vue 3D (par exemple en créant un nouveau document).

Essayez alors de savoir si votre puce graphique prend en charge OpenGL (la plupart des puces récentes sont compatibles), puis cherchez le bon pilote et installez le.

Une façon simple de vérifier si OpenGL est disponible, est d'essayer de lancer une autre application OpenGL tel que blender.

Une façon générale, pour obtenir plus d'informations sur les accidents de FreeCAD, lancez FreeCAD avec le paramètre écriture dans le journal.

Cela va créer le fichier FreeCAD.log dans $HOME/FreeCAD sur Linux et Mac OSX ou %APPDATA%\FreeCAD sur les systèmes Windows.

Dans quelques rares cas, vous devrez peut-être installer un driver graphique qui n'a rien à voir avec votre carte graphique. Nous avons eu un cas où l'ordinateur portable d'un utilisateur avait une puce graphique embarquée Intel mais certains pilotes ATI ont du être installés pour un bon fonctionnement de FreeCAD.

Certaines bibliothèques, nécessaires à FreeCAD, ne sont pas présentes sur ??votre système, ou n'ont pas été trouvées par FreeCAD
Il peut y avoir deux déclinaisons à ce problème : soit une bibliothèque est tout simplement absente, donc FreeCAD refusera de démarrer, ou, la bibliothèque est présente, mais il s'agit d'une version trop ancienne pour FreeCAD, si un accident se produit lorsque FreeCAD essaie d'utiliser une fonctionnalité manquante à partir de cette bibliothèque.

Un exemple fréquent, est celui où vous avez Qt3 et Qt4 installés sur votre système, FreeCAD peut détecter Qt4, mais si votre installation de Qt n'est pas correctement configurée, quelques morceaux de Qt3 pourraient encore être utilisés, et les accidents surviennent.

S'il vous plaît examinez la procédure, et assurez-vous que vous avez bien installé toutes les bibliothèques requises (sur la plupart des systèmes Linux cela se fait automatiquement), et vérifiez d'avoir installé la version minimale pour chacun des composants.

Si tout semble correct, décrivez le problème sur le forum ou sur le bug tracker.

Si vous êtes sur un système Linux, il est facile de tracer le débogage, qui a pour résultat de fournir des informations très utiles sur l'accident pour les développeurs :
 * dans un terminal, tapez : gdb FreeCAD (en supposant que le paquet gdb soit installé)
 * l'intérieur de gdb, tapez exécuter
 * après le crash, tapez bt pour en obtenir la trace, et, vous pouvez l'inclure dans votre rapport de bogue.

FreeCAD freezes after startup
When starting FreeCAD the GUI appears almost immediately but the GUI is frozen and the cpu is about 99%. This can happen on the KDE desktop when using the Oxygen theme. That's a bug in the Oxygen theme and choosing another theme should fix this issue.

FreeCAD crashes on creating a new document or opening a file
If FreeCAD crashes when it creates a new 3D view, try launching FreeCAD from a terminal. If a message error appears when the crash occurs, mentioning "Assertion Failed" and a component name beginning with "So" (SoBase, SoFieldContainer, etc...), the chances are very high, especially if you are on linux, that FreeCAD tries to use two different versions of the coin library, which causes the crash. To verify if that is indeed the problem, try the following: If there is any difference, either FreeCAD or SoQt must be recompiled (better to recompile the one that uses the oldest Coin version). The normal behavior is to try to contact the persons responsible for packaging either SoQt or FreeCAD and kindly ask them to consider recompiling. If you want to undertake that step for yourself, and it is not possible to recompile SoQt because it breaks other applications on your system, you can force FreeCAD to compile with the required Coin version with ./configure --with-coin=DIR. But you have to make sure that the correct devel package to this Coin version is installed.
 * Locate the FreeCAD executable (usually in /usr/lib/FreeCAD/bin)
 * Run the command 'ldd FreeCAD' from a terminal
 * Note down the version of the libCoin.so library that FreeCAD is using (for example libCoin.so.60)
 * Locate the libSoQt.so library (usually in /usr/lib)
 * run 'ldd libSoQt.so' and check if it links to the same coin version as FreeCAD

FreeCAD crashes after Edit -> Alignment
A segmentation fault happens at vbo_save_playback_vertex_list. This means that the implementation of VBO of the graphic driver is bad. In order to avoid to cache OpenGL calls you can try to set the environment variable IV_SEPARATOR_MAX_CACHES=0 and restart FreeCAD.

I have trouble running FreeCAD on Mac OSX
The Mac platform is less easy to support than Windows or Linux, since none of the core developers owns one. The OSX packages are compiled by volunteering FreeCAD users, and they might sometimes not work correctly on your machine, depending on your system. Your best chance is probably to head to the forums, look for Mac OSX-related threads, and discuss your problem there or see if someone else encountered a solution.

I cannot change numeric values in FreeCAD's properties panels


You most likely have bad windows regional settings set-up. Please check if you have same symbol for decimal separator and digit grouping symbol in your regional settings. If you do, adapt your system settings to use the different character for digit grouping symbol and decimal separator. Note that it is not mandatory to have dot as decimal separator. It is mandatory to use different symbols in this two settings.

Is FreeCAD really free? Even for commercial use?
FreeCAD is open-source software, and is free not only to use, for yourself or for doing commercial work, but also to distribute, modify, or even use in a closed-source application. To review, you are free to do (almost) anything you want with it. See the license page for more details.

How do I rotate the 3D view?
FreeCAD has four different navigation modes available, that can be set in the preferences settings dialog or changed by right-clicking in the 3D view. For full details about the modes, see the Mouse Model page. For the default mode ("CAD Navigation"), the commands are as follows,

What can I do with FreeCAD? Where do I start?
Head to the Getting started page for a quick description of the tools you can use. There is also a new Tutorials section containing a few resources. The User hub section contains more detailed information about the different workbenches of FreeCAD. Note that since FreeCAD is relatively new, its user interface is still very bare and doesn't feature many tools. But much more advanced functionality is already available to you from python scripting.

Is there documentation for newcomers? How can I learn to use FreeCAD?
There is at the moment still little documentation for beginners, unfortunately, but the Tutorials section contains some pages to help you getting started.

How do I extrude stuff into solids? I don't get the right result
The theory is simple: Lines (or wires), when extruded, form faces. Faces, when extruded, form solids. If you extrude something and the result is not a solid, then the something was not a face. If you have lines and you want to extrude a solid from them, you must first select lines that form a closed perimeter (select several objects by pressing CTRL), join them into a wire (Upgrade tool), then make a face from that wire (Upgrade tool again). There you are, if all went well you can now extrude it to a solid.

Now, there can be many little twists that make you obtain the wrong result. The best way to make sure is to check what's inside the object you are extruding. Objects contents can be easily explored with python. Assuming for example you have an object called "Wire", you could type this into the python console:

The above code retrieves the shape from an object, shows the faces and wires your object has (if any), and, if there are wires, prints if those wires are closed. If you don't have any face, you won't get a solid. If there is no closed wire, it won't become a face. If you are interested, there is more info about what you can check with python on the part scripting page. If you cannot join several lines into a wire, the most probable cause is that their endpoints don't meet, there must be small gaps between (some of) them. There, I'm afraid, my experience tells me the quickest way would be to redraw a wire on top of them...

My boolean operations fail, or give weird results
The Open CASCADE geometric modeling kernel used in FreeCAD for Part geometry, although probably the best open-source geometry kernel available, has its flaws and limitations. Indeed the boolean operations (fusion, subtraction, intersection) are not its best features, and often give strange results. This is a current limitation we have no way to solve at once, so your best path is to try obtaining the desired result by modeling another way. For example, problems with primitives such as cylinder can often be solved by using an extruded circle instead. Coplanar surfaces between parts can cause trouble, as well as surface tangency. As a general rule, if a shape doesn't work, try remodeling it a different way. In 99% of the cases at the end you will manage to obtain the result you want.

FreeCAD is such a great program! How can I help?
There are a lot of different ways to help, even if you are not a programmer. Here are a couple of things you can do:
 * Give some feedback to the FreeCAD developers: It is always useful to know what people think, what they found good, what they miss, etc. Drop a note on the forum giving your opinion or make a request on our issue tracker!
 * Help with writing documentation: The documentation we have here on this site is sometime very limited. If you discovered something that is not well documented, add your knowledge there!
 * Help others newcomers: Hang around the forum, and help new people to solve basic questions, like how do I install, how do I add a cube, etc...
 * Translate the documentation in your own language
 * Translate FreeCAD in your own language
 * Write Tutorials, or record video tutorials: Tutorials are a very easy way for newcomers to learn a new software. If you did some nice stuff, why not show other people how to do it?
 * Contribute with assets and examples: We still miss good example files in FreeCAD. If you created something good, share it with us!
 * Submit bugs: It is very important to have all the possible bugs fixed. If you find one, report it as clearly as possible, so we can understand exactly what's happening.
 * Try to do some python coding: You never programmed before but you want to try? Python is easy. Read our introduction to python... But beware, you might get addicted quickly!
 * See the Help FreeCAD page for more details on how to contribute.

How can I get edit permission on the wiki?
See the Work on the documentation page paragraph for more details on how to contribute.

Does FreeCAD participate to the Google Summer of Code?
No. We are too few developers at the moment, and it would take us way too much time to do the admin work and monitor the students, we prefer to spend that time writing code instead.

I want to start translating the wiki in my own language. What do I do?
This wiki is hosting a lot of contents. The most up-to-date and interesting material is gathered in the manual.

See the Translate the documentation page paragraph for more details on how to translate the wiki.

Do I have to pay something to use FreeCAD?
No. FreeCAD is totally free to use, to download, to redistribute, or to modify. It is open-source software, published under the terms of 2 free software licenses (GPL and LGPL), which guarantee you those freedoms, and, even more important, guarantee you that these freedoms will never be taken from you.

Can I Reuse any part of the FreeCAD artwork or pieces of the website?
Sure. All the artwork (icons, banners, etc...) of FreeCAD is LGPL, same as the FreeCAD code. Help yourself on the Artwork page. The website is a standard mediawiki site, all graphic elements can freely be reused, and if you are curious about how to tweak the mediawiki software like we did, look for the special Common css and js pages.

Can I reuse pieces of FreeCAD in another application?
Yes, with a few minor considerations because some parts of the code are LGPL while others are GPL, and the fact that the third-parties used by FreeCAD may have other conditions as well. More details on the license page.