FAQ/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
Il modo più semplice è attraverso la sezione download (it) oppure download (en), dove sono disponibili diversi pacchetti pronti per l'installazione. Per gli ambienti Debian, Fedora, Ubuntu e per alcune altre distribuzioni si può scaricare FreeCAD direttamente dal gestore dei pacchetti. Per Ubuntu, il team di FreeCAD mantiene anche un proprio repositorio PPA. Per ulteriori dettagli sull'installazione, fare riferimento alla pagina Installazione o alla pagina inglese Installing.

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
Per adesso il kernel di modellazione geometrica su cui è basato FreeCAD, che è una libreria di terze parti chiamata Open CASCADE Technology, o brevemente OCC, non supporta il multithreading.

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

E se voglio compilare FreeCAD?
Il codice sorgente di FreeCAD è sempre disponibile nel repository del codice sorgente del progetto. La procedura di compilazione di FreeCAD è abbastanza semplice e permette di utilizzare le funzioni più recenti o quelle in fase di sviluppo, ma richiede alcune conoscenze di informatica. Tramite il repository è possibile accedere al codice sorgente e alle istruzioni dettagliate per la compilazione su Windows, Linux e Mac OSX.

FreeCAD dice che mancano dei moduli o delle applicazioni
Per offrire tutte le sue funzionalità, FreeCAD dipende da molte cose. Di solito, tutti i principali componenti necessari sono incorporati nel pacchetto di installazione di FreeCAD o forniti dal gestore dei pacchetti, quindi normalmente non c'è nulla di cui preoccuparsi. Se, però, FreeCAD viene installato da fonti non ufficiali, o viene compilato autonomamente, possono mancare delle parti che non sono fondamentali, ma che servono per delle funzionalità particolari. Alcuni formati di file specifici quali i Collada o i DWG richiedono dei componenti aggiuntivi che non possono essere incorporati in FreeCAD, ma che devono essere installati separatamente.

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

FreeCAD non si avvia
Questo può essere dovuto a diversi motivi, il più probabile è che manchi qualche libreria. Provare ad avviare FreeCAD da un terminale (digitare freecad al prompt del terminale) per vedere se appare qualche messaggio di errore. Inoltre, leggere il resto di queste FAQ, in modo da avere maggiori indizi per individuare la causa del problema. Se non si trova nulla di utile, esporre il problema nel forum dove ci sarà sicuramente qualcuno che può fornire un aiuto.

Su alcuni vecchi sistemi Windows XP, è possibile ottenere un messaggio di errore come questo: ''The application can't start, because the side-by-side configuration is wrong. The reinstallation of the application may solve the problem''. Questo problema è causato dalla mancanza nel sistema delle librerie di runtime CRT oppure la versione installata è troppo vecchia e FreeCAD ne usa una più recente. In questo caso è necessario installare il Microsoft Visual C++ Redistributable Package che troverete presso Microsoft. Vedere anche il corrispondente messaggio nel 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 esterno Python chiamato Pivy. In Windows, pivy è incluso nell'installatore di FreeCAD. Sui sistemi Debian/Ubuntu, il pacchetto python-pivy fa parte dei repository software standard. Su altri sistemi, al momento, può essere necessario compilare pivy. Notare che senza pivy alcuni strumenti non sono disponibili, ma 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 ..
Per la visualizzazione di contenuti 3D FreeCAD dipende da OpenGL, e quindi richiede un ambiente di lavoro OpenGL. Su alcuni sistemi, OpenGL non è attivato di default, e può essere necessario installare o aggiornare i driver grafici. Questo problema si verifica più sovente su sistemi Linux o su sistemi virtuali. Se si utilizza un sistema basato su Linux, provare a:


 * verificare che la scheda grafica supporti la visualizzazione 3D
 * digitare glxinfo in una finestra di terminale, e controllare che l'output Direct Rendering sia impostato "yes", e che il vendor/renderer/version OpenGL corrisponda alla propria scheda grafica.
 * installare altro software basato su OpenGL, per esempio Blender, e controllare se funziona e se viene visualizzato correttamente.

FreeCAD non si avvia
Un crash in fase di avvio può indicare un errore più grave, o qualche problema nella configurazione. La maggior parte dei crash di avvio si verificano a causa di uno dei due motivi seguenti:

I driver OpenGL non sono installati o non funzionano correttamente
Questa è una causa molto comune del problema. I sintomi sono semplicemente che FreeCAD si blocca all'avvio oppure quando si apre una vista 3D (ad esempio creando un nuovo documento). Cercate di scoprire qual'è il vostro chip grafico e quindi di scoprire se supporta OpenGL (la maggior parte dei chip più recenti lo fanno), poi cercare il driver corretto e installarlo. Un buon modo per ricontrollare se OpenGL è disponibile è di cercare di eseguire un'altra applicazione OpenGL, ad esempio Blender.

Come suggerimento generale, per ottenere maggiori informazioni sul blocco di FreeCAD è possibile avviarlo con l'opzione --write-log. In questo modo si crea il file FreeCAD.log in $HOME/.FreeCAD nei sistemi Linux e Mac OS X oppure in %APPDATA\FreeCAD% nei sistemi Windows.

In qualche raro caso può essere installato un driver grafico non adatto alla scheda grafica. È capitato un caso in cui in un computer portatile con un processore Intel erano installati alcuni driver ATI. Dopo la rimozione dei file e l'instalazione del driver corretto FreeCAD ha iniziato a funzionare. Vedere

Alcune librerie, necessarie a FreeCAD, non sono presenti nel sistema, o non vengono trovate da FreeCAD
Ci possono essere due motivazioni per questo problema: o semplicemente manca qualche libreria, quindi FreeCAD rifiuta di avviarsi, o la libreria c'è, ma è una versione più vecchia di quella che FreeCAD si aspetta, quindi il crash si verifica quando FreeCAD tenta di utilizzare una funzione che manca in quella libreria. Un caso frequente è quello in cui Qt3 e Qt4 sono entrambi installati sul proprio sistema. FreeCAD potrebbe rilevare Qt4, ma se l'installazione Qt non è configurata correttamente, alcune parti di Qt3 possono essere ancora in uso e provocare il crash.

Si prega di rivedere la procedura di installazione - (installing), accertarsi di aver installato tutte le librerie richieste (nella maggior parte dei sistemi Linux questo viene fatto automaticamente), e verificare qual è il numero di versione minimo per ciascuno dei componenti.

Se tutto sembra corretto, descrivere il problema nel forum oppure segnalare un bug - (report a bug). Se siete su un sistema Linux, è facile fare un backtrace di debug, che fornisce agli sviluppatori informazioni molto utili sul crash:
 * in un terminale, digitare: gdb freecad (assumendo che il pacchetto gdb è installato)
 * all'interno di gdb, digitare run
 * dopo il crash, digitare bt per ottenere il backtrace, che è possibile includere nella segnalazione del bug.

FreeCAD si blocca dopo l'avvio
Quando si avvia FreeCAD la GUI appare quasi subito, ma rimane "congelata" e la CPU è impegnata circa al 99%. Questo può accadere sul desktop KDE quando si utilizza il tema Oxygen. Questo è un bug di Oxygen e utlizzando un tema diverso si dovrebbe risolvere il problema.

FreeCAD si blocca quando si crea un nuovo documento o si apre un file
Se FreeCAD va in crash quando crea una nuova vista 3D, provare ad avviare FreeCAD da terminale. Se quando il sistema si blocca, viene visualizzato un messaggio di errore riportante "Assertion Failed" e il nome di un componente che inizia con "So" (SoBase, SoFieldContainer, ecc ..), è molto probabile, soprattutto se siete su Linux, che FreeCAD tenti di utilizzare due versioni diverse della stessa libreria Coin e che questo causi il crash. Per verificare se il problema è effettivamente questo, provare quanto segue:

Se ci sono delle differenze, FreeCAD o SoQt devono essere ricompilati. Meglio ricompilare quello che utilizza la versione di Coin più vecchia. La cosa migliore è cercare di contattare i responsabili dell'impacchettamento di SoQt o FreeCAD e gentilmente chiedere loro di prendere in considerazione la ricompilazione. Se si vuole intraprendere questa operazione da soli, e non è possibile ricompilare SoQt perché danneggia altre applicazioni del sistema, è possibile forzare la compilazione di FreeCAD con la versione Coin richiesta tramite ./configure --with-coin=DIR. Ma bisogna assicurarsi che il pacchetto corretto di questa versione Coin sia installato.
 * Individuare il file eseguibile FreeCAD (di solito in /usr/lib/FreeCAD/bin)
 * Eseguire il comando 'ldd FreeCAD' da terminale
 * Annotare la versione della libreria libCoin.so library che FreeCAD sta usando (ad esmpio libCoin.so.60)
 * Individuare la libreria libSoQt.so (di solito in /usr/lib)
 * Eseguire 'ldd libSoQt.so' e verificare se rimanda alla stessa versione di Coin a cui rimanda FreeCAD

FreeCAD va in crash dopo Modifica -> Allineamento
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.

Problemi ad eseguire FreeCAD su Mac OSX
La piattaforma Mac è meno facile da supportare rispetto a Windows o Linux, dato che nessuno dei principali sviluppatori ne possiede una. I pacchetti OSX sono compilati da utenti volontari di FreeCAD, e a volte possono non funzionare correttamente su tutte le macchine, secondo quale sistema usano. La cosa migliore è probabilmente quella di cercare sul forum le discussioni relative ai sistemi Mac OSX e discutere il problema o vedere se qualcuno ha già trovato una soluzione.

Non posso cambiare i valori numerici nei pannelli delle proprietà di FreeCAD


Molto probabilmente le impostazioni internazionali, Paese e Lingua, nel pannello di controllo di Windows non sono corrette. Controllare se è impostato lo stesso simbolo per il separatore decimale e per il simbolo di raggruppamento delle cifre nelle impostazioni regionali. Se sono uguali, modificare le impostazioni di sistema e utilizzare due caratteri diversi, uno per il simbolo di raggruppamento delle cifre e un altro per il separatore dei decimali. Si noti che non è obbligatorio utilizzare il punto come separatore decimale. È obbligatorio l'uso di simboli diversi in queste due impostazioni.

FreeCAD è veramente gratuito? Anche per uso commerciale?
FreeCAD è un software open-source ed è concesso di utilizzarlo non solo per uso personale o per uso commerciale, ma anche di distribuirlo, modificarlo, o addirittura di utilizzarlo in una applicazione closed-source. Per riassumere, con esso si è liberi di fare (quasi) tutto quello che si vuole. Vedere la pagina della license per ulteriori dettagli.

Come faccio a ruotare la vista 3D?
FreeCAD dispone di quattro diversi modi di navigazione che si possono impostare nella finestra di dialogo delle preferenze o modificare facendo clic con il destro nella vista 3D. Per maggiori dettagli sulle modalità, vedere la pagina Tipi di navigazione. Per la modalità di default "CAD Navigation", i comandi sono i seguenti:

Cosa si può fare con FreeCAD? Da dove si inizia?
Consultare la pagina Per iniziare dove si trova una breve descrizione degli strumenti che è possibile utilizzare. C'è anche una recente sezione dedicata alle Giude - (Tutorials) contenente per ora poche risorse. La sezione Centro utenti - (User hub) contiene informazioni più dettagliate sui diversi ambienti di lavoro di FreeCAD. Si noti che, poiché FreeCAD è relativamente nuovo, la sua interfaccia utente è ancora molto spoglia e non dispone di molti strumenti. Le funzionalità più avanzate sono disponibili tramite gli script Python - (python scripting).

La documentazione per i nuovi utenti​​ è disponibile? Come imparare ad usare FreeCAD?
Al momento, la documentazione per i principianti è ancora scarna, ma la nuova sezione Giude - (Tutorials) contiene già alcune pagine che consentono di iniziare.

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.