Frequently asked questions/it

In questa pagina sono riunite le domande più frequenti che sono state poste nel forum di FreeCAD. Probabilmente le soluzioni ai problemi e le risposte alle domande relative a FreeCAD si trovano già in questa pagina. Se non è così è possibile utilizzare il forum di FreeCAD!

Il modo più facile per installare FreeCAD
Se sei su Windows o macOS, il modo più semplice è andare al Download, dove troverai diversi pacchetti pronti per l'installazione. Se sei su Debian, Fedora o Ubuntu e alcune altre distribuzioni, FreeCAD è già incluso nei repository software standard e puoi semplicemente installarlo con il software manager. Su Ubuntu, il team di FreeCAD mantiene anche il proprio repository PPA. Per ulteriori dettagli sull'installazione, fare riferimento alla pagina di installazione del proprio sistema operativo (Windows, Linux o Mac).

Quali sono i prerequisiti per eseguire FreeCAD?
Contrariamente alla maggior parte dei software di CAD 3D, FreeCAD può essere eseguito senza problemi anche su computer modesti - it's been known to run on Pentium IV and Intel Core2 Solo CPUs. Se nel computer è installato un sistema operativo corrente, è probabile che FreeCAD venga eseguito. L'unico prerequisito è che la scheda grafica o il chipset supporti OpenGL, preferibilmente non più vecchio della versione v2.0. In caso di problemi, consultare la sezione Risoluzione dei problemi di queste FAQ.

Multithreading
Il kernel di modellazione geometrica sottostante di FreeCAD, la libreria di terze parti OpenCASCADE Technology (OCCT), ha solo un supporto multi-threading parziale in questo momento. Vedere la pagina multithreading per maggiori dettagli.

Per gli utenti Mac
È supportata solo l'architettura MacIntel. Non sono disponibili build per l'architettura PowerPC.

E se voglio compilare FreeCAD?
Il codice sorgente di FreeCAD è sempre disponibile nel repository del codice sorgente del progetto. La compilazione di FreeCAD in proprio consente di utilizzare le funzionalità più recenti in fase di sviluppo, ma richiede un po' di conoscenza del computer, sebbene la procedura sia abbastanza semplice. L'accesso al codice sorgente è spiegato qui e abbiamo istruzioni dettagliate per la compilazione su Windows, Linux e macOS.

FreeCAD dice che mancano dei moduli o delle applicazioni
FreeCAD dipende da molte cose per offrire tutte le sue funzionalità. Tutti i componenti principali richiesti sono solitamente raggruppati all'interno dell'installazione di FreeCAD o forniti dal gestore dei pacchetti, quindi normalmente non hai nulla di cui preoccuparti. Se hai installato FreeCAD da fonti non ufficiali, tuttavia, o hai compilato FreeCAD da solo, potrebbe mancare qualche pezzo, che non è fondamentale per FreeCAD stesso, ma potrebbe causare la non disponibilità di alcune funzionalità. Alcuni formati di file specifici come Collada o DWG richiedono anche componenti aggiuntivi, che non possono essere raggruppati in FreeCAD e devono essere installati separatamente.

Tutti questi componenti e il modo appropriato per installarli sono elencati nella pagina dedicata ai moduli Python aggiuntivi.

FreeCAD non si avvia affatto
Potrebbero esserci molte ragioni per questo, la più probabile è che manchi qualche libreria. Prova ad avviare FreeCAD da un terminale (digitare al prompt del terminale,  su alcuni sistemi) per vedere se appare qualche messaggio di errore. Inoltre, leggi il resto di questa FAQ in quanto può darti più indizi per rilevare la causa del problema. Se nulla aiuta, parlane sul forum, ci sarà sicuramente qualcuno che può aiutarti.

Su alcuni vecchi sistemi Windows XP potresti ricevere un messaggio di errore come questo: Il motivo di questo problema è che sul tuo sistema mancano le librerie di runtime CRT o la versione installata è troppo vecchia perché FreeCAD era collegato a una versione più recente. In questo caso devi installare il che troverai in Microsoft. Vedi anche il corrispondente messaggio sul forum.

FreeCAD si avvia normalmente, ma non vengono visualizzate tutte le icone, alcune di esse sono sostituite da una 'X' nera
Alcune parti di FreeCAD dipendono da un modulo Python esterno chiamato Pivy. Su Windows, pivy è incluso nell'installazione di FreeCAD. Sui sistemi Debian/Ubuntu, il pacchetto python-pivy fa parte dei repository software standard. Su altri sistemi, al momento, potresti dover compilare tu stesso pivy. Nota che sebbene alcuni strumenti non siano disponibili senza pivy, il resto di FreeCAD funziona normalmente.

Ci sono dei problemi di visualizzazione, la vista 3D non si comporta correttamente, rimane dello sporco quando si muove o si ruota la vista, ecc.
FreeCAD dipende da OpenGL per la visualizzazione di contenuti 3D e quindi richiede un ambiente OpenGL funzionante. Su alcuni sistemi, OpenGL non è attivato per impostazione predefinita e potrebbe essere necessario installare o aggiornare i driver grafici. Questo problema si verifica più spesso su sistemi Linux o su sistemi virtuali. Se utilizzi un sistema basato su Linux, prova i seguenti passaggi:
 * verifica che il tuo computer disponga di una scheda grafica compatibile con 3D
 * digita in una finestra di terminale e controlla nell'output che Direct Rendering sia impostato su "yes" e che il vendor/renderer/version di OpenGL corrisponda alla tua scheda grafica.

FreeCAD si arresta all'avvio
Un arresto anomalo potrebbe indicare un bug più grave o qualche problema nella tua configurazione. La maggior parte degli arresti anomali all'avvio si verifica a causa di uno dei due seguenti motivi:

I driver OpenGL non sono installati o non funzionano correttamente
Questa è una causa molto comune del problema. I sintomi sono semplicemente che FreeCAD si arresta in modo anomalo all'avvio o ogni volta che si apre una vista 3D (ad esempio creando un nuovo documento). Prova a scoprire qual è il tuo chip grafico, quindi scopri se supporta OpenGL (i chip più recenti lo fanno), quindi trova il driver corretto e installalo. Un buon modo per verificare se OpenGL è disponibile è provare a eseguire un'altra applicazione OpenGL come blender.

E come suggerimento generale per ottenere qualche informazione in più sugli arresti anomali di FreeCAD, puoi avviarlo con il parametro del programma. Questo creerà il file in   o   su Linux o  su macOS o  su sistemi Windows.

In alcuni rari casi potresti avere un driver grafico installato, che non si adatta alla tua scheda grafica. Abbiamo avuto un caso in cui il laptop dell'utente aveva una scheda grafica Intel integrata ma erano stati installati alcuni driver ATI. . Dopo aver rimosso i file e reinstallato il driver corretto, FreeCAD ha iniziato a funzionare.

Alcune librerie, necessarie a FreeCAD, non sono presenti nel sistema, o non vengono trovate da FreeCAD
Ci possono essere due percorsi per questo problema: o manca semplicemente una libreria, quindi FreeCAD rifiuterà di avviarsi, oppure la libreria è presente, ma è una versione precedente di quella che FreeCAD si aspetta, quindi si verificherà un arresto anomalo quando FreeCAD tenterà di usa una funzione mancante da quella libreria. Un esempio comune è quando hai Qt3 e Qt4 installati sul tuo sistema, FreeCAD potrebbe rilevare Qt4 ma se l'installazione di Qt non è configurata correttamente, alcuni pezzi di Qt3 potrebbero essere ancora utilizzati, provocando arresti anomali.

Si prega di rivedere la procedura di installazione (Windows, Linux o Mac), assicurarsi di aver installato tutte le librerie richieste (sulla maggior parte dei sistemi Linux ciò avviene automaticamente), e controlla qual è il numero di versione minimo per ciascuno dei componenti.

Se tutto sembra corretto, descrivi il problema sul forum o invia un bug. Se sei su un sistema Linux, è facile eseguire un backtrace di debug, che fornisce agli sviluppatori informazioni molto utili sul crash:
 * in un terminale, digita: (supponendo che il pacchetto gdb sia installato)
 * all'interno di gdb, digita
 * dopo il crash, digita per ottenere il backtrace, che puoi includere nella tua segnalazione di bug.

FreeCAD si blocca dopo l'avvio
Quando si avvia FreeCAD, la GUI appare quasi immediatamente, ma la GUI è bloccata e la CPU è di circa il 99%. Questo può accadere sul desktop di KDE quando usi il tema Oxygen. Questo è un bug nel tema Oxygen e la scelta di un altro tema dovrebbe risolvere questo problema.

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, and a component name beginning with "So" (, , etc.), the chances are very high, especially if you are on Linux, that FreeCAD is trying 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 people 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. But you have to make sure that the correct development package of this Coin version is installed.
 * Locate the FreeCAD executable (usually in )
 * Run the command from a terminal
 * Note down the version of the library that FreeCAD is using (for example )
 * Locate the library (usually in )
 * run and check if it links to the same Coin version as FreeCAD

FreeCAD crashes after Edit → Alignment
A segmentation fault happens at. This means that the implementation of VBO in the graphic driver is bad. In order to avoid caching OpenGL calls you can try to set the environment variable and restart FreeCAD.

I have trouble running FreeCAD on macOS
The Mac platform is less easy to support than Windows or Linux, since none of the core developers owns one. The macOS 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 macOS-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 the same symbol for decimal separator and digit grouping symbol in your regional settings. If you do, adapt your system settings to use different characters for the 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 these two settings.

FreeCAD was running normally, and suddenly it doesn't start anymore
This can also happen if you had an older version of FreeCAD installed, and you upgraded to a newer version. In that process, the configuration files of FreeCAD might have been corrupted for some reason, and now FreeCAD cannot read them anymore, and fails to start. The solution is simply to delete these configuration files, so FreeCAD will recreate them on first run.


 * On Windows: Open the file explorer, and write as the file path. Once there, delete the files  and
 * On Linux: Navigate to  or   and delete the files  and
 * On Mac: Navigate to and delete the files  and

FreeCAD should now start again normally with all its settings reset.

There is a Macro findConfigFiles available to help in locating your configuration files. It can be installed using the Addon Manager in the Tools menu. . The macro will find your config file folder, copy it to the clipboard, and (attempt to) open that location with your default file browser. It makes no changes to your files or 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 summarize, you are free to do (almost) anything you want with it. See the Licence page for more details.

How do I rotate the 3D view?
FreeCAD has several 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 navigation 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 a lot of documentation spread in different places, both on and outside the FreeCAD website. You might want to start with the Getting started page. The Tutorials section contains many specialized tutorial pages to help you getting started with the different workbenches. The Manual:Introduction is a general, complete user-oriented guide to FreeCAD. The User hub section of this wiki lists all pages aimed at end users. On external sites like Youtube, you will also find a load of video tutorials created by users. And, last but not least, the forum contains a lot of replies to questions asked by other newcomers.

I want to import/export data in format XYZ to/from FreeCAD. How do I do that?
Please refer to the FreeCAD Howto Import Export page. Maybe your questions are already answered there.

Where can I find workarounds for features that FreeCAD currently does not support?
Please refer to the Workarounds page.

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 ), join them into a wire (Draft Upgrade tool), then make a face from that wire ( Draft 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.

When I export (or view) my model, the holes are filled in
Don't use +  (Select All) to export everything from the hierarchy tree. If the model is of one single item, try selecting only the newest item (usually the last one) in the hierarchy tree.

As we create a model in the PartDesign Workbench, each feature takes the shape of the last one and adds or removes something, creating linear dependencies from feature to feature as the model is created. Hence a "Cut" feature is not only the cut hole itself, but the whole part with the cut. This is why the user usually should only have the newest item (feature) in the model tree visible, because otherwise the phases of the model overlay each other, and holes are filled in by the earlier model features.

To toggle visibility of an object on or off, select it in the hierarchy tree and press on your keyboard. Usually everything but the last item in the hierarchy tree should be greyed out and therefore not visible in the 3D view.

My parametric objects break when I modify their base sketches
You have met the (in)famous toponaming problem. This is currently a major issue in FreeCAD for newcomers. It is present all over FreeCAD, but is more prominent when using sketches. The explanation is simple: When recalculating a sketch, the geometric entities (edges, faces...) are rebuilt in a different order, depending on the constraints precedence. They then receive a different name (Edge1, Edge2, Face1, Face2...). Most subsequent operations depend on these names to identify which subcomponent they work on. Therefore, when the sketch is rebuilt, features that are based on such subcomponents might suddenly get their base geometry changed and give a wrong result.

This is a very hard problem to overcome (the Topological Naming Project aims at solving it). However, there are many workarounds available to mitigate the problem, and more advanced users generally manage to avoid it completely. A couple of strategies are:


 * Know that sketches are highly sensitive to the problem. Referencing a specific edge of a sketch, or a face of an object built on a sketch, such as a PartDesign Pad, is dangerous, unless you are pretty confident that these sketches will not change over time or the sketch is very simple. A Pad built on a simple rectangular sketch, for example, will likely be safe as it will generate only one face, so there is no order problem.
 * Prefer other kinds of objects such as Part or Draft when possible. These objects are always built the same way, and therefore their geometric components usually follow the same order each time they are rebuilt. They are much less susceptible to toponaming problems.
 * To attach further objects onto the faces of sketch-based geometry, prefer using Datum geometry. These invisible "helper objects" don't depend on sketch geometry, and therefore stay stable over time.

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 sometimes 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 into your own language
 * Translate FreeCAD into 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 are still missing good example files in FreeCAD. If you created something good, share it with us!
 * Submit bugs: It is very important to have all 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 in Google Summer of Code?
Yes. Beginning in 2016, FreeCAD participates in Google Summer of Code. See Google Summer of Code 2020 for information on past editions, and Google Summer Of Code 2016 in the forum for the original announcement.

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 the GNU Lesser General Public License 2.1, which guarantees you those freedoms and, even more important, guarantees 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 are licensed 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, you can use the core parts of FreeCAD in other applications as long as you comply with the terms of the LGPL. Third party libraries, external workbenches, and macros may be subject to their own license terms, so please consult with their authors. More details on the Licence page.