Start up and Configuration/de

Diese Seite zeigt die verschiedene Wege, FreeCAD zu starten, und die wichtigsten Konfigurationsmöglichkeiten.

FreeCAD von der Kommandozeile starten
FreeCad kann normal gestartet werden, durch Doppelklick auf das entsprechende Desktopicon oder Auswahl aus dem START-Menue. Es kann aber auch direkt von der Kommandozeile gestartet werden. Das ermöglicht die Änderung der Standard-Start-Optionen.

Kommandozeilenoptionen
Die Kommandozeilenoptionen sind Gegenstand ständiger Veränderungen, es ist deshalb empfehlenswert, die aktuellen Optionen wie folgt zu überprüfen: FreeCAD --help Die Ausgabe zeigt die möglichen Parameter: Usage: FreeCAD [options] File1 File2 ..... Allowed options: Generic options: -v [ --version ]     print version string -h [ --help ]        print help message -c [ --console ]     start in console mode --response-file arg  can be specified with '@name', too

Configuration: -l [ --write-log ] arg   write a log file to default location(Run FreeCAD --h to see default location) --log-file arg           Unlike to --write-log this allows to log to an arbitrary file -u [ --user-cfg] arg     User config file to load/save user settings -s [ --system-cfg] arg   System config file to load/save system settings -t [ --run-test ] arg    test level -M [ --module-path ] arg additional module paths -P [ --python-path ] arg additional python paths

EX: (Windows)

Rückmeldung und Konfigurationsdateien
FreeCad kann einige dieser Optionen aus einer Konfigurationsdatei lesen. Diese Datei muss im bin-Verzeichnis sein und FreeCAD.cfg heißen. Beachten Sie, dass Optionen auf der Kommandozeile die aus der Konfigurationsdatei übersteuern!

Bei einigen Betriebssystemen ist die Länge der Kommandozeile sehr kurz. Der übliche Weg zur Umgehung dieser Beschränkungen ist es, Parameterdateien zu benutzen. Eine Parameterdatei ist einfach nur eine Konfigurationsdatei, die die gleiche Syntax wie die Kommandozeile benutzt. Wenn die Kommandozeile eine Parameterdatei angibt, wird diese geladen und zusätzlich zur Kommandozeile analysiert.

oder:

Versteckte Optionen
Es gibt eine Reihe von Optionen, die nicht für den Benutzer sichtbar sind. Diese Optionen sind z.B. die X-Window-Parameter, die durch das Windows-System analysiert werden:
 * "-display" - setzt das X-Display (Standardwert ist $DISPLAY).
 * "-geometry" - setzt die Client-Geometrie des ersten angezeigten Fensters.
 * "-fn" oder "-font" - definiert die Anwendungsschriftart. Die Schriftart sollte durch eine X logische Schriftartbeschreibung angegeben werden.
 * "-bg" oder "-background" - setzt die Standardhintergrundfarbe und eine Anwendungspalette (helle und dunkle Farbschattierungen werden berechnet).
 * "-fg" oder "foreground" - setzt die Standardvordergrundfarbe.
 * "-btn" oder "-button" - setzt die Standard-Button-Farbe.
 * "-name" - setzt den Anwendungsnamen.
 * "-title" - setzt den Anwendungstitel.
 * "-visual" - zwingt die Anwendung, TrueColor anstatt einer 8-Bit-Farbanzeige zu nutzen.
 * "-ncols" - begrenzt die Anzahl der im Farbwürfel verwendeten Farben auf einer 8-Bit-Anzeige, wenn die Anwendung die QApplication::ManyColor-Angabe verwendet. Wenn die Anzahl 216 ist, dann wird ein 6x6x6-Farbwürfel (d.h. 6 Stufen für Rot, 6 Stufen für Grün und 6 Stufen für Blau); bei anderen Werten wird ein Quader annähernd zu einem 2x3x1-Quader verwendet.
 * "-cmap" - führt dazu, dass die Anwendung eine eigene Farbpalette für eine 8-Bit-Anzeige installiert.

FreeCAD ohne grafische Benutzeroberfläche ausführen
FreeCAD wird normalerweise mit zwei Programmen geliefert: ein GUI-taugliches namens FreeCAD und eine Kommandozeilenversion namens FreeCADCmd. FreeCAD kann mithilfe der Option "-c" im Konsolenmodus betrieben werden, dies ist das Standardverhalten von FreeCADCmd: FreeCAD -c from the command line. In console mode, no user interface will be displayed, and you will be presented with a python interpreter prompt. From that python prompt, you have the same functionality as the python interpreter that runs inside the FreeCAD GUI, and normal access to all modules and plugins of FreeCAD, excepted the FreeCADGui module. Be aware that modules that depend on FreeCADGui might also be unavailable.

Python scripts/FreeCAD macro files can be specified as command line arguments to either of the executables mentioned above.

The Config set
On every Startup FreeCAD examines its surrounding and the command line parameters. It builds up a configuration set which holds the essence of the runtime information. This information is later used to determine the place where to save user data or log files. It is also very important for post postmortem analyzes. Therefore it is saved in the log file.

System related
Some libraries need to call system environment variables. Sometimes when there is a problem with a FreeCAD installation, it is because some environment variable is absent or set wrongly. Therefore, some important variables get duplicated in the Config and saved in the log file.

Python related environment variables: OpenCascade related environment variables: System related environment variables:
 * PYTHONPATH
 * PYTHONHOME
 * TCL_LIBRARY
 * TCLLIBPATH
 * CSF_MDTVFontDirectory
 * CSF_MDTVTexturesDirectory
 * CSF_UnitsDefinition
 * CSF_UnitsLexicon
 * CSF_StandardDefaults
 * CSF_PluginDefaults
 * CSF_LANGUAGE
 * CSF_SHMessage
 * CSF_XCAFDefaults
 * CSF_GraphicShr
 * CSF_IGESDefaults
 * CSF_STEPDefaults
 * PATH

Build related information
The table below shows the availible informations about the Build version. Most of it comes from the Subversion repository. This stuff is needed to exactly rebuild a version!

Branding related
These Config entries are related to the branding mechanism of FreeCAD. See Branding for more details.