FAQ/de

Diese Seite versucht, die am häufigsten im Forum gestellten Fragen zu beantworten. Wenn Du ein Problem oder eine Frage bezüglich FreeCAD hast, sieh bitte zuerst hier nach. Erst wenn Du hier keine Antwort auf Deine Frage findest, wende dich an das Forum FreeCAD forum!

Was ist der einfachste Weg, FreeCAD auf meinem Rechner zu installieren ?
Wenn Du mit Windows oder Mac OS arbeitest ist es am einfachsten, sich die fertigen Installationspakete von der Download-Seite herunterzuladen. Arbeitest Du mit Debian, Fedora, Ubuntu (und noch einigen weiteren Distributionen), dann ist FreeCAD bereits in den Standard-Repositories enthalten und kann mit dem entsprechenden Softwaremanager einfach installiert werden. Für Ubuntu pflegt das FreeCAD-Team sogar ein eigenes PPA repositories. Für weitere Einzelheiten zur Installation wird auf die Installing-Seite verwiesen.

Was sind die Voraussetzungen um FreeCAD auszuführen
Im Gegensatz zu den meisten 3D-CAD-Programmen läuft FreeCAD problemlos auf den meisten (auch einfachen) Rechnern, so auch auf Pentium 4 und IntelCore2 solo CPUs. Wenn auf Ihrem Rechner ein aktuelles Betriebssystem seinen Dienst verrichtet, stehen die Chanchen gut für FreeCAD. Die einzige Voraussetzung ist eine Grafikkarte, deren Chipsatz in der Version 2.0 und höher unterstützt. Im Problemfall lesen Sie im Abschnitt (Fehlerbeseitigung ) dieser FAQ nach.

Multithreading
Der FreeCAD zugrundeliegende "geometric modeling kernel" Open CASCADE Technology (kurz OCC) eines Drittanbieters unterstützt zur Zeit kein multithreading. bietet zur Zeit partielle Mulitithreading.

Für MAC-Nutzer
Es wird nur die MacIntel-Architektur unterstützt, für PowerPC sind keine Versionen verfügbar.

Ich möchte FreeCAD selbst kompilieren
Der Sourcecode von FreeCAD ist im entsprechenden Repository des Projektes verfügbar. Das eigene Kompilieren ermöglicht die Nutzung der neuesten Funktionen, erfordert aber ein paar Computerkenntnisse. Das Verfahren ist ziemlich einfach. Der Zugang zum Sourcecode ist erklärt here und es existieren genaue Anleitungen zum Kompilieren für Windows, Linux und Mac OSX.

FreeCAD meldet, dass einige Module oder Anwendungen fehlen
FreeCAD benötigt eine Reihe von Komponenten, um seine volle Funktionalität zu gewährleisten, die wichtigsten sind in den Installationspaketen vorhanden oder werden durch den Paketmanager geliefert. Wenn Sie FreeCAD allerdings aus einer nichtoffiziellen Quelle installieren oder selbst kompilieren, können einige Teile fehlen. Das ist unkritisch für FreeCAD, kann aber einen eingeschränkten Funktionsumfang zur Folge haben. Einige spezielle Dateiformate (wie Collada oder DWG) benötigen auch zusätzliche Komponenten, die nicht in FreeCAD integriert werden können. Diese müssen von Dir separat installiert werden.

Diese Komponenten und das empfohlende Vorgehen zur Installation sind auf dieser Seite aufgeführt: Extra python modules

FreeCAD startet überhaupt nicht
Dafür kann es eine Menge Gründe geben, am wahrscheinlichsten fehlen einige Bibliotheken. Versuche FreeCAD von einem Terminal zu starten (schreibe "freecad" in der Eingabeaufforderung), um hier evtl. Fehlermeldungen zu erhalten. Lies außerdem den Rest der FAQs, um weitere Tips zur Lösung dieses Problems zu erhalten. Wenn nichts hilft, berichte darüber im Forum, hier kann Dir bestimmt jemand helfen.

Auf einigen älteren XP-Rechnern erhalten Sie u.U. folgende oder eine ähnliche Fehlermeldung: "Die Anwendung kann nicht gestarten werden, da die "side-by-side Konfiguration fehlerhaft ist. Die erneute Installation der Anwendung kann das Problem evtl. beheben". Die Ursache für das Problem sind entweder fehlende CRT-Laufzeitbliotheken oder dass die installierte Version zu alt ist, weil FreeCAD gegen eine neuere Version gelinked wurde. Installiere in diesem Fall das Microsoft Visual C++ Redistributable Package, das im Download-Bereich von Microsoft verfügbar ist. s.a.: forum message.

FreeCAD startet normal, aber nicht alle Icons werden angezeigt. Einige werden durch ein schwarzes 'X' ersetzt.
Einige Teile von FreeCAD sind von dem externen Pythonmodul "Pivy" abhängig. Unter Windows ist "Pivy" Bestandteil des Installationspaketes. Auf Debian/Ubuntu-Systemen ist das python-pivy-Paket Bestandteil der Standard-Repositories. Auf anderen Systemen muss pivy derzeit selbst kompiliert werden. Ohne pivy sind einige Werkzeuge nicht verfügbar, der "Rest" von FreeCAD funktioniert normal.

Ich habe Anzeigeprobleme, die 3D-Ansicht verhält sich nicht korrekt, es gibt "Müll", wenn ich die Ansicht bewege/drehe, etc...
FreeCAD ist abhängig von OpenGL bei der Anzeige von 3D-Inhalten und erfordert daher eine funktionierende OpenGL-Umgebung. Auf einigen Systemen ist OpenGL als Standardeinstellung nicht aktiviert und Du musst ggf. die Grafiktreiber installieren oder aktualisieren. Diese Probleme treten meistens auf Linux- oder virtuellen Systemen auf. Wenn Du ein Linux-basiertes System hast, versuche die folgenden Schritte:
 * überprüfe, dass Dein Computer eine 3D-fähige Grafikkarte hat
 * tippe glxinfo in einem Terminal-Fenster ein und prüfe in der Ausgabe, dass 'Direct Rendering' auf "yes" steht und dass OpenGL-Hersteller/Renderer/Version zu Deiner Grafikkarte passen
 * installiere weitere OpenGL-basierte Software (beispielsweise [Blender]) und prüfe, ob sie läuft und fehlerfrei anzeigt

FreeCAD stürzt beim Start ab
Ein Absturz könnte eine ernsthafteren Fehler andeuten oder ein Problem in Deiner Konfiguration. Die meisten Abstürze treten aus einem der beiden folgenden Gründe auf:

Die OpenGL-Treiber sind nicht installiert oder funktionieren nicht ordnungsgemäß
Es gibt einen einfachen Grund für dieses Problem. Die Symtome sind, dass FreeCAD während des Startvorgangs abstürzt bzw. wenn Du eine 3D-Ansicht öffnest (z.B. beim Anlegen eines neuen Dokuments). Versuche den Typ Deines Grafik-Chips herauszufinden und suche z.B. auf, ob er unterstützt wird (das ist bei den meisten der Fall), dann finde den richtigen Treiber und installiere ihn. Eine gute Methode zur Überprüfung von OpenGL ist, eine andere OpenGL-Anwendung wie z.B. blender zu testen.

Als generellen Hinweis zur Ermittlung von weiteren Informationen über Abstürze kannst du FreeCAD mit der Option --write-log starten. Dies wird die Datei FreeCAD.log in $HOME/.FreeCAD auf Linux und Mac OS X oder %APPDATA\FreeCAD% auf Windows-Systemen.

In einigen seltenen Fällen hast Du vielleicht einen Grafiktreiber installiert, der nicht zu Deiner Grafikkarte passt. Wir hatten einen Fall, wo im Laptop des Benutzer eine Intel on-board-Grafik verbaut war, aber ATI-Treiber installiert waren. Nach dem Entfernen der Dateien und Installation der richtigen Treiber startete FreeCAD ohne Fehler.

Eine von FreeCAD benötigte Bibliothek ist nicht auf Deinem System oder wurde nicht von FreeCAD gefunden
Es gibt zwei mögliche Erklärungen für dieses Problem: Entweder diese Bibliothek fehlt ganz einfach, so dass FreeCAD den Start verweigert, oder die Bibliothek ist vorhanden, aber in einer älteren Version als der von FreeCAD erwarteten, so dass ein Absturz beim Zugriff auf eine fehlende Funktion in der Bibliothek erfolgt. Ein übliches Beispiel ist, wenn Du Qt3 und Qt4 auf Deinem System installiert hast, dann könnte FreeCAD Qt4 erkennen, aber falls Deine Konfiguration fehlerhaft ist, könnten einige Teile von Qt3 noch benutzt werden, aber zu Abstürzen führen.

Bitte überprüfe die Installing/de-Anleitung, stelle sicher, dass Du alle benötigten Bibliotheken installiert hast (auf den meisten Linux-Systemen passiert das automatisch) und überprüfe die minimale Versionnummer für jede der Komponenten.

Wenn alles richtig aussieht, beschreibe das Problen im Forum oder erstelle einen Bug-Report. Wenn Du auf einem Linux-System bist, ist es einfach, ein Debug-Backtrace zu erstellen, der für die Entwickler sehr wichtige Informationen über den Absturz liefert:
 * Tippe in einem Terminal gdb freecad (vorausgesetzt, das gdb-Paket ist installiert)
 * In gdb, tippe run
 * Nach dem Absturz tippe bt, um den Backtrace zu erhalten, so dass Du ihn an den Bug-Report anfügen kannst.

FreeCAD friert nach dem Start ein
Nach dem Start von FreeCAD erscheint die GUI fast augenblicklich, aber die GUI ist eingefroren und die CPU-Auslastung bei ungefähr 99%. Das kann auf dem KDE-Desktop passieren, wenn man das Oxygen-Theme benutzt. Das ist ein Bug im Oxygen-Theme und die Nutzung eines anderen Themes sollte das Problem lösen.

FreeCAD stürzt beim Anlegen eines neuen oder Öffnen eines vorhandenen Dokuments ab
Falls FreeCAD beim Anlegen einer neuen 3D-Ansicht abstürzt, versuch FreeCAD von einem Terminal aus zu starten. Falls eine Fehlermeldung beim Absturz erscheint, in der "Assertion failed" und ein Komponentenname beginnend mit "So" (SoBase, SoFieldContainer, etc) erwähnt wird, dann ist die Chance sehr hoch, gerade wenn Du auf Linux bist, dass FreeCAD versucht, zwei verschiedene Versionen der coin-Library zu verwenden, was den Absturz verursacht. Um zu prüfen, dass das tatsächlich das Problem ist, versuch das Folgende: Wenn es einen Unterschied gibt, dann muss entweder FreeCAD oder SoQt erneut kompiliert werden (es ist besser, das Programm mit der älteren Coin-Version erneut zu kompilieren). Das normale Verhalten ist, die Personen zu kontaktieren, die für das Paketieren von FreeCAD oder Coin zuständig sind und sie freundlich zu bitten, über ein erneutes Kompilieren nachzudenken. Wenn Du diesen Schritt selbst durchführen willst und es nicht möglich ist, SoQt erneut zu kompilieren, weil dann andere Anwendungen auf Deinem System nicht funktionieren, dann kannst Du FreeCAD mit './configure --with-coin=DIR' zwingen, die benötigte Coin-Version beim Kompilieren zu benutzen. Du solltest vorher sicherstellen, dass das passende devel-Paket zu dieser Coin-Version installiert ist.
 * Finde das FreeCAD-Binary (normalerweise in /usr/lib/FreeCAD/bin)
 * Führe den Befehl 'ldd FreeCAD' in einem Terminal aus
 * Merke Dir die Version der libCoin-Library, die FreeCAD benutzt (z.B. libCoin.so.60)
 * Finde die linSoQt.so-Library (normalerweise in /usr/lib)
 * Führe 'ldd libSoQt.so' aus und prüfe, ob dort die gleiche Version wie bei FreeCAD benutzt wird

FreeCAD nach Bearbeiten -> Ausrichtung ab
Ein Segmentation fault tritt in vbo_save_playback_vertex_list auf. Dies bedeutet, dass die Implementierung von VBO des Grafiktreibers schlecht ist. Um zu vermeiden, dass OpenGL-Aufrufe den Cache nutzen, kannst Du versuchen, die Umgebungsvariable IV_SEPARATOR_MAX_CACHES=0 zu setzen und FreeCAD neu zu starten.

Ich habe Schwierigkeiten bei der Ausführung von FreeCAD auf Mac OSX
Die Mac-Plattform ist weniger einfach zu unterstützen als Windows oder Linux, weil keiner der Core-Entwickler einen besitzt. Die OSX-Pakete werden von bereitwilligen FreeCAD-Benutzern kompiliert und teilweise können sie auf Deiner Maschine nicht richtig funktionieren, abhängig von Deinem System. Die beste Möglichkeit ist wahrscheinlich, im Forum nach Mac OSX-verwandten Threads zu suchen und Dein Problem darzustellen oder zu sehen, ob jemand anders eine Lösung gefunden hat.

Ich kann keine numerischen Werte in den Eigenschaften-Panels von FreeCAD eingeben


Du hast höchstwahrscheinlich eine fehlerhafte Windows-Lokalisierungseinstellung. Prüfe bitte, ob Du das gleiche Zeichen für den Dezimaltrenner und die Tausendertrennung in Deinen Lokalisierungseinstellungen hast. Falls das so ist, dann passe Deine Systemeinstellungen an und verwende für Dezimal- und Tausendertrennung unterschiedliche Zeichen. Beachte, dass es nicht nötig ist, einen Punkt als Dezimaltrenner zu haben. Es ist nötig, unterschiedliche Zeichen zu haben.

FreeCAD lief normal, aber plötzlich startet es nicht mehr
Dies kann auch passieren, wenn Du von einer älteren auf eine neuere Version aktualisiert hast. Während dieses Vorgangs könnten die Konfigurationsdateien aus irgendeinem Grund beschädigt worden sein, so dass FreeCAD sie nicht mehr lesen und deshalb nicht mehr starten kann. Die Lösung ist, diese Konfigurationsdateien zu löschen, damit FreeCAD sie beim nächsten Start wieder erzeugen kann.


 * Auf Windows: Öffne den Datei-Explorer und schreibe "%APPDATA%\FreeCAD" als Dateipfad. Lösche dort die Dateien user.cfg und system.cfg
 * Auf Linux: Navigiere zu "/home/USERNAME/.FreeCAD" und lösche dort die Dateien user.cfg und system.cfg
 * Auf Mac: Navigiere zu "/Users/USERNAME/Library/Preferences/FreeCAD" und lösche dort die Dateien user.cfg und system.cfg

FreeCAD sollte nun wieder normal starten mit den Standardeinstellungen.

Es ist ein Makro Macro_findConfigFiles verfügbar, um bei der Suche nach Deinen Konfigurationsdateien zu helfen. Es kann mit Hilfe des Addon-Manager im Werkzeuge-Menü installiert werden. Werkzeuge → Addon Manager → Macros → findConfigFiles. Das Makro findet Dein Konfigurationsdateienverzeichnis, kopiert den Namen in die Zwischenablage und öffnet (bzw. versucht es) das Verzeichnis mit Deinem Standard-Datei-Explorer. Es macht keine Änderungen an Deinen Dateien oder Einstellungen.

Ist FreeCAD wirklich kostenlos/frei (free)? Sogar für kommerzielle Nutzung?
FreeCAD ist Open-Source-Software und sowohl kostenlos als auch frei, sowohl für Dich selbst als auch für kommerzielle Nutzung. Das gilt auch für die Weitergabe, Änderung oder sogar die Nutzung in einer Closed-Source-Anwendung. Du bist frei, (nahezu) alles damit zu machen, was Du willst. Auf der Lizenz-Seite findest Du Einzelheiten.

Wie drehe ich die 3D-Ansicht?
FreeCAD hat mehrere verschiedene Navigationsmodi, die im Einstellungsdialog oder durch Rechtsklicken in der 3D-Ansicht geändert werden können. Mehr Einzelheiten über die Modi findest Du auf der Maus-Modell-Seite. Für den Standard-Modus ("CAD-Navigation") sind die Befehle wie folgt

Was kann ich mit FreeCAD tun? Wo soll ich anfangen?
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.

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

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.

When I Export (or View) My Model, The Holes Are Filled In
Don't use Crtl + A (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 Part Design 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 the Spacebar. Usually everything but the last item in the hierarchy tree should be greyed out and therefore not visible in the 3D view.

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?
Yes. Beginning from 2016 FreeCAD participates to the Google Summer of Code. See this topic in the forum and [this wiki page]

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 Licence page.