Start up and Configuration/de: Difference between revisions
No edit summary |
(Updating to match new version of source page) |
||
(37 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
⚫ | |||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
{{TOCright}} |
|||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
== FreeCAD von der Kommandozeile starten == |
== 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. |
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 ohne eine Kommandozeilen-Shell verwenden === |
|||
* Auf Ubuntu lässt sich ein Desktop-Symbol erstellen und die Eigenschaften anpassen. Die Kommandozeilenoptionen können im "Command"-Feld hinter dem Programmnamen durch Leerzeichen voneinander getrennt eingetragen werden. |
|||
* Auf Windows wird eine Verknüpfung erstellt und die Eigenschaften angepasst. Die Kommandozeilenoptionen können im "Ziel"-Feld durch Leerzeichen voneinander getrennt eingetragen werden. |
|||
=== Kommandozeilenoptionen === |
=== Kommandozeilenoptionen === |
||
Line 10: | Line 21: | ||
FreeCAD --help |
FreeCAD --help |
||
Die Ausgabe zeigt die möglichen Parameter: |
Die Ausgabe zeigt die möglichen Parameter: |
||
⚫ | |||
Usage: |
|||
⚫ | |||
Allowed options: |
|||
⚫ | |||
Generic options: |
|||
-v [ --version ] |
-v [ --version ] Prints version string |
||
-h [ --help ] |
-h [ --help ] Prints help message |
||
-c [ --console ] |
-c [ --console ] Starts in console mode |
||
--response-file arg |
--response-file arg Can be specified with '@name', too |
||
--dump-config Dumps configuration |
|||
--get-config arg Prints the value of the requested configuration key |
|||
⚫ | |||
-l [ --write-log ] arg write a log file to default location(Run FreeCAD --h to see default location) |
|||
⚫ | |||
⚫ | |||
- |
-l [ --write-log ] Writes a log file to: |
||
/home/username/.FreeCAD/FreeCAD.log |
|||
⚫ | |||
--log-file arg Unlike --write-log this allows logging to an |
|||
⚫ | |||
⚫ | |||
- |
-u [ --user-cfg ] arg User config file to load/save user settings |
||
⚫ | |||
-t [ --run-test ] arg Test case - or 0 for all |
|||
EX: (Windows) |
|||
⚫ | |||
{{Code|code= |
|||
-P [ --python-path ] arg Additional python paths |
|||
⚫ | |||
--single-instance Allow to run a single instance of the application |
|||
⚫ | |||
=== Parameter- und Konfigurationsdateien === |
=== Parameter- 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! |
FreeCad kann einige dieser Optionen aus einer Konfigurationsdatei lesen. Diese Datei muss im bin-Verzeichnis sein und {{FileName|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. |
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. |
||
{{Code|code= |
{{Code|code= |
||
FreeCAD @ResponseFile.txt |
FreeCAD @ResponseFile.txt |
||
}} |
}} |
||
oder: |
oder: |
||
⚫ | |||
{{Code|code= |
{{Code|code= |
||
FreeCAD --response-file=ResponseFile.txt |
FreeCAD --response-file=ResponseFile.txt |
||
}} |
}} |
||
=== Versteckte Optionen === |
=== Versteckte Optionen === |
||
Line 64: | Line 78: | ||
== FreeCAD ohne grafische Benutzeroberfläche ausführen == |
== 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 wird normalerweise mit zwei Programmen geliefert: ein GUI-taugliches namens {{FileName|FreeCAD}} und eine Kommandozeilenversion namens {{FileName|FreeCADCmd}}. FreeCAD kann mithilfe der Option "-c" im Konsolenmodus betrieben werden, dies ist das Standardverhalten von {{FileName|FreeCADCmd}}: |
||
FreeCAD -c |
FreeCAD -c |
||
von der Kommandozeile. Im Konsolenmodus wird kein Benutzerinterface angezeigt, sondern ein Python-Interpreter-Prompt. Dieser bietet die gleiche Funktionalität wie der in die FreeCAD-GUI eingebaute, und normalen Zugang zu allen FreeCAD-Modulen und -Plugins, außer dem FreeCADGui-Modul. Bitte beachten Sie, dass von FreeCADGui abhängige Module möglicherweise ebenfalls nicht verfügbar sind. |
von der Kommandozeile. Im Konsolenmodus wird kein Benutzerinterface angezeigt, sondern ein Python-Interpreter-Prompt. Dieser bietet die gleiche Funktionalität wie der in die FreeCAD-GUI eingebaute, und normalen Zugang zu allen FreeCAD-Modulen und -Plugins, außer dem FreeCADGui-Modul. Bitte beachten Sie, dass von FreeCADGui abhängige Module möglicherweise ebenfalls nicht verfügbar sind. |
||
Line 81: | Line 95: | ||
! Konfig.-Variable !! Beschreibung !! Beispiel M$ !! Beispiel Posix (Linux) |
! Konfig.-Variable !! Beschreibung !! Beispiel M$ !! Beispiel Posix (Linux) |
||
|- |
|- |
||
| UserAppData || Pfad, wo FreeCAD benutzerbezogene Anwendungsdaten speichert || C:\ |
| UserAppData || Pfad, wo FreeCAD benutzerbezogene Anwendungsdaten speichert || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD}}<hr />''Short path : ''{{FileName|%APPDATA%\FreeCAD}} || {{FileName|/home/username/.FreeCAD}}<hr />''Short path : ''{{FileName|~/.FreeCAD}} |
||
|- |
|- |
||
| UserParameter || Datei, wo FreeCAD benutzerbezogene Anwendungsdaten speichert || C:\ |
| UserParameter || Datei, wo FreeCAD benutzerbezogene Anwendungsdaten speichert || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\user.cfg}}<hr />''Short path : ''{{FileName|%APPDATA%\FreeCAD\user.cfg}} || {{FileName|/home/username/.FreeCAD/user.cfg}}<hr />''Short path : ''{{FileName|~/.FreeCAD/user.cfg}} |
||
|- |
|- |
||
| SystemParameter || Datei, wo FreeCAD anwendungsbezogene Daten speichert || C:\ |
| SystemParameter || Datei, wo FreeCAD anwendungsbezogene Daten speichert || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\system.cfg}}<hr />''Short path : ''{{FileName|%APPDATA%\FreeCAD\system.cfg}} || {{FileName|/home/username/.FreeCAD/system.cfg}}<hr />''Short path : ''{{FileName|~/.FreeCAD/system.cfg}} |
||
|- |
|- |
||
| UserHomePath || Home-Verzeichnis des aktuellen Benutzers || C:\ |
| UserHomePath || Home-Verzeichnis des aktuellen Benutzers || {{FileName|C:\Documents and Settings\username}}<hr />''Short path : ''{{FileName|%USERPROFILE%}} || {{FileName|/home/username}}<hr />''Short path : ''{{FileName|~}} |
||
|} |
|} |
||
Line 99: | Line 113: | ||
| LoggingFile || 1, wenn das Logging eingeschaltet ist || 1 |
| LoggingFile || 1, wenn das Logging eingeschaltet ist || 1 |
||
|- |
|- |
||
| LoggingFileName || Dateiname, wo die Log-Datei abgelegt wird || C:\ |
| LoggingFileName || Dateiname, wo die Log-Datei abgelegt wird || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\FreeCAD.log}} |
||
|- |
|- |
||
| RunMode || Dies beschreibt, wie die Hauptschleife ausgeführt wird. '''"Script"''' bedeutet, dass das Skript aufgerufen und dann beendet wird. '''"Cmd"''' startet den Kommandozeilen-Interpreter. '''"Internal"''' startet ein internes Skript. '''"Gui"''' Eintritt in die GUI-Ereignis-Schleife. '''"Module"''' lädt ein angegebenes Python-Modul. || "Cmd" |
| RunMode || Dies beschreibt, wie die Hauptschleife ausgeführt wird. '''"Script"''' bedeutet, dass das Skript aufgerufen und dann beendet wird. '''"Cmd"''' startet den Kommandozeilen-Interpreter. '''"Internal"''' startet ein internes Skript. '''"Gui"''' Eintritt in die GUI-Ereignis-Schleife. '''"Module"''' lädt ein angegebenes Python-Modul. || "Cmd" |
||
Line 107: | Line 121: | ||
| ScriptFileName || Bedeutung abhängig von RunMode || |
| ScriptFileName || Bedeutung abhängig von RunMode || |
||
|- |
|- |
||
| Verbose || |
| Verbose || Ausführlichkeits-Level von FreeCAD || "" oder "strict" |
||
|- |
|- |
||
| OpenFileCount || Enthält die Anzahl von Dateien, die durch Kommandozeilenargumente geöffnet wurden || "12" |
| OpenFileCount || Enthält die Anzahl von Dateien, die durch Kommandozeilenargumente geöffnet wurden || "12" |
||
Line 121: | Line 135: | ||
! Konfig.-Variable !! Beschreibung !! Beispiel M$ !! Beispiel Posix (Linux) |
! Konfig.-Variable !! Beschreibung !! Beispiel M$ !! Beispiel Posix (Linux) |
||
|- |
|- |
||
| AppHomePath || Pfad, wo FreeCAD installiert ist || c: |
| AppHomePath || Pfad, wo FreeCAD installiert ist || {{FileName|c:/Progam Files/FreeCAD_0.7}} || {{FileName|/user/local/FreeCAD_0.7}} |
||
|- |
|- |
||
| PythonSearchPath || Enthält eine Liste von Pfaden, die Python nach Modulen durchsucht. Status zum Startzeitpunkt, kann sich während der Ausführung ändern || || |
| PythonSearchPath || Enthält eine Liste von Pfaden, die Python nach Modulen durchsucht. Status zum Startzeitpunkt, kann sich während der Ausführung ändern || || |
||
|} |
|} |
||
=== Beispiel zum Auführen einer Datei === |
|||
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;" |
|||
|+ Command line configuration for execute a file |
|||
! Execute a file !! System !! Konfiguration der Befehlszeile |
|||
|- |
|||
⚫ | |||
|- |
|||
| ||Linux || {{FileName|todo}} |
|||
|- |
|||
|- |
|||
| .FCMacro oderr .py ||Windows || {{FileName|"C:\Program Files\FreeCAD\bin\FreeCAD.exe" "C:\Users\userName\AppData\Roaming\FreeCAD\Mod\WorkFeature\start_WF.FCMacro"}} |
|||
|- |
|||
| ||Linux || {{FileName|todo}} |
|||
|- |
|||
|Wie wird ein Makro gestaltet, um es automatisch beim Start von FreeCAD zu starten ||Windows / Linux / Mac||Siehe Seite [[Macro_at_Startup|Macro at Startup]] Wie wird ein Makro gestaltet, um es automatisch beim Start von FreeCAD zu starten. |
|||
⚫ | |||
Einige Bibliotheken benötigen Zugriff zu Systemumgebungsvariablen. Manchmal, wenn es ein Problem mit einer FreeCAD-Installation gibt, liegt es daran, dass eine Umgebungsvariable nicht oder falsch gesetzt ist. Deshalb werden einige wichtige Variablen in die Konfiguration dupliziert und in der Log-Datei gespeichert. |
Einige Bibliotheken benötigen Zugriff zu Systemumgebungsvariablen. Manchmal, wenn es ein Problem mit einer FreeCAD-Installation gibt, liegt es daran, dass eine Umgebungsvariable nicht oder falsch gesetzt ist. Deshalb werden einige wichtige Variablen in die Konfiguration dupliziert und in der Log-Datei gespeichert. |
||
'''Python-bezogene Umgebungsvariablen''' |
'''Python-bezogene Umgebungsvariablen''' |
||
* PYTHONPATH |
* PYTHONPATH |
||
* PYTHONHOME |
* PYTHONHOME |
||
* TCL_LIBRARY |
* TCL_LIBRARY |
||
* TCLLIBPATH |
* TCLLIBPATH |
||
'''OpenCascade-bezogene Umgebungsvariablen:''' |
'''OpenCascade-bezogene Umgebungsvariablen:''' |
||
* CSF_MDTVFontDirectory |
* CSF_MDTVFontDirectory |
||
* CSF_MDTVTexturesDirectory |
* CSF_MDTVTexturesDirectory |
||
Line 146: | Line 183: | ||
* CSF_IGESDefaults |
* CSF_IGESDefaults |
||
* CSF_STEPDefaults |
* CSF_STEPDefaults |
||
'''System-bezogene Umgebungsvariablen:''' |
'''System-bezogene Umgebungsvariablen:''' |
||
* PATH |
* PATH |
||
=== Programmpaket [Build]-bezogene Informationen === |
=== Programmpaket [Build]-bezogene Informationen === |
||
Line 157: | Line 196: | ||
! Konfig.-Variable !! Beschreibung !! Beispiel |
! Konfig.-Variable !! Beschreibung !! Beispiel |
||
|- |
|- |
||
| BuildVersionMajor || Major Versionsnummer der Programmpaketausgabe. Definiert in src/Build/Version.h.in || 0 |
| BuildVersionMajor || Major Versionsnummer der Programmpaketausgabe. Definiert in {{FileName|src/Build/Version.h.in}} || 0 |
||
|- |
|- |
||
| BuildVersionMinor || Minor Versionsnummer der Programmpaketausgabe. Definiert in src/Build/Version.h.in || 7 |
| BuildVersionMinor || Minor Versionsnummer der Programmpaketausgabe. Definiert in {{FileName|src/Build/Version.h.in}} || 7 |
||
|- |
|- |
||
| BuildRevision || SVN Repository Revisionsnummer der Source der Programmpaketausgabe. Generiert durch SVN || 356 |
| BuildRevision || SVN Repository Revisionsnummer der Source der Programmpaketausgabe. Generiert durch SVN || 356 |
||
Line 174: | Line 213: | ||
|} |
|} |
||
=== Branding |
=== "Branding"-verwandt (Warenkennzeichnung) === |
||
Diese Konfigurationseinträge beziehen sich auf den "Branding"-Mechanismus von FreeCAD. Mehr Details unter [[Branding]]. |
Diese Konfigurationseinträge beziehen sich auf den "Branding"-Mechanismus von FreeCAD. Mehr Details unter [[Branding]]. |
||
Line 183: | Line 222: | ||
! Konfig.-Variable !! Beschreibung !! Beispiel |
! Konfig.-Variable !! Beschreibung !! Beispiel |
||
|- |
|- |
||
| ExeName || Name der ausführbaren Programmpaket-Datei. Kann von FreeCAD abweichen, falls eine andere main.cpp benutzt wird. || FreeCAD.exe |
| ExeName || Name der ausführbaren Programmpaket-Datei. Kann von FreeCAD abweichen, falls eine andere {{FileName|main.cpp}} benutzt wird. || {{FileName|FreeCAD.exe}} |
||
|- |
|- |
||
| ExeVersion || Während des Programmstarts angezeigte Hauptversion || V0.7 |
| ExeVersion || Während des Programmstarts angezeigte Hauptversion || V0.7 |
||
Line 193: | Line 232: | ||
| SplashPicture || Name des Icon, das für den Splash Screen benutzt wird || "FreeCADSplasher" |
| SplashPicture || Name des Icon, das für den Splash Screen benutzt wird || "FreeCADSplasher" |
||
|- |
|- |
||
| SplashAlignment || Ausrichtung des Textes im Splash-Dialog || "Bottom |
| SplashAlignment || Ausrichtung des Textes im Splash-Dialog || "Bottom" oder "Left" |
||
|- |
|- |
||
| SplashTextColor || Farbe des Splasher-Textes || "#000000" |
| SplashTextColor || Farbe des Splasher-Textes || "#000000" |
||
Line 202: | Line 241: | ||
|} |
|} |
||
=== Zugehörige Seiten === |
|||
⚫ | |||
* [[Std CommandLine|Std CommandLine]] |
|||
<div class="mw-translate-fuzzy"> |
|||
{{docnav/de|[[Third Party Tools/de|Drittanbieterwerkzeuge]]|[[FreeCAD Build Tool/de]]}} |
|||
</div> |
|||
{{Userdocnavi/de}} |
|||
[[Category:Developer Documentation/de]] |
[[Category:Developer Documentation/de]] |
||
{{clear}} |
{{clear}} |
||
⚫ |
Revision as of 21:28, 10 February 2020
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 ohne eine Kommandozeilen-Shell verwenden
- Auf Ubuntu lässt sich ein Desktop-Symbol erstellen und die Eigenschaften anpassen. Die Kommandozeilenoptionen können im "Command"-Feld hinter dem Programmnamen durch Leerzeichen voneinander getrennt eingetragen werden.
- Auf Windows wird eine Verknüpfung erstellt und die Eigenschaften angepasst. Die Kommandozeilenoptionen können im "Ziel"-Feld durch Leerzeichen voneinander getrennt eingetragen werden.
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 ] Prints version string -h [ --help ] Prints help message -c [ --console ] Starts in console mode --response-file arg Can be specified with '@name', too --dump-config Dumps configuration --get-config arg Prints the value of the requested configuration key Configuration: -l [ --write-log ] Writes a log file to: /home/username/.FreeCAD/FreeCAD.log --log-file arg Unlike --write-log this allows logging 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 case - or 0 for all -M [ --module-path ] arg Additional module paths -P [ --python-path ] arg Additional python paths --single-instance Allow to run a single instance of the application
Parameter- 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.
FreeCAD @ResponseFile.txt
oder:
FreeCAD --response-file=ResponseFile.txt
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
von der Kommandozeile. Im Konsolenmodus wird kein Benutzerinterface angezeigt, sondern ein Python-Interpreter-Prompt. Dieser bietet die gleiche Funktionalität wie der in die FreeCAD-GUI eingebaute, und normalen Zugang zu allen FreeCAD-Modulen und -Plugins, außer dem FreeCADGui-Modul. Bitte beachten Sie, dass von FreeCADGui abhängige Module möglicherweise ebenfalls nicht verfügbar sind.
Python-Skripte/FreeCAD-Makrodateien können als Kommandozeilenargumente für die o.g. Programme angegeben werden.
Der Konfigurationssatz
FreeCAD untersucht bei jedem Start die Umgebung und die Kommandozeilenparameter. Es erstellt einen "Konfigurationssatz", der das Wesentliche der Laufzeitinformationen enthält. Diese Informationen werden später genutzt, um den Platz festzulegen, an dem Benutzerdaten oder Log-Dateien gespeichert werden. Sie sind auch wichtig für "post postmortem"-Analysen. Daher werden sie in der Log-Datei gespeichert.
Benutzerbezogene Informationen
Konfig.-Variable | Beschreibung | Beispiel M$ | Beispiel Posix (Linux) |
---|---|---|---|
UserAppData | Pfad, wo FreeCAD benutzerbezogene Anwendungsdaten speichert | C:\Documents and Settings\username\AppData\FreeCAD Short path : %APPDATA%\FreeCAD |
/home/username/.FreeCAD Short path : ~/.FreeCAD |
UserParameter | Datei, wo FreeCAD benutzerbezogene Anwendungsdaten speichert | C:\Documents and Settings\username\AppData\FreeCAD\user.cfg Short path : %APPDATA%\FreeCAD\user.cfg |
/home/username/.FreeCAD/user.cfg Short path : ~/.FreeCAD/user.cfg |
SystemParameter | Datei, wo FreeCAD anwendungsbezogene Daten speichert | C:\Documents and Settings\username\AppData\FreeCAD\system.cfg Short path : %APPDATA%\FreeCAD\system.cfg |
/home/username/.FreeCAD/system.cfg Short path : ~/.FreeCAD/system.cfg |
UserHomePath | Home-Verzeichnis des aktuellen Benutzers | C:\Documents and Settings\username Short path : %USERPROFILE% |
/home/username Short path : ~ |
Kommandozeilenoptionen
Konfig.-Variable | Beschreibung | Beispiel |
---|---|---|
LoggingFile | 1, wenn das Logging eingeschaltet ist | 1 |
LoggingFileName | Dateiname, wo die Log-Datei abgelegt wird | C:\Documents and Settings\username\AppData\FreeCAD\FreeCAD.log |
RunMode | Dies beschreibt, wie die Hauptschleife ausgeführt wird. "Script" bedeutet, dass das Skript aufgerufen und dann beendet wird. "Cmd" startet den Kommandozeilen-Interpreter. "Internal" startet ein internes Skript. "Gui" Eintritt in die GUI-Ereignis-Schleife. "Module" lädt ein angegebenes Python-Modul. | "Cmd" |
FileName | Bedeutung abhängig von RunMode | |
ScriptFileName | Bedeutung abhängig von RunMode | |
Verbose | Ausführlichkeits-Level von FreeCAD | "" oder "strict" |
OpenFileCount | Enthält die Anzahl von Dateien, die durch Kommandozeilenargumente geöffnet wurden | "12" |
AdditionalModulePaths | Enthält die zusätzlichen Modul-Pfade, die auf der Kommandozeile angegeben wurden | "extraModules/" |
Systembezogen
Konfig.-Variable | Beschreibung | Beispiel M$ | Beispiel Posix (Linux) |
---|---|---|---|
AppHomePath | Pfad, wo FreeCAD installiert ist | c:/Progam Files/FreeCAD_0.7 | /user/local/FreeCAD_0.7 |
PythonSearchPath | Enthält eine Liste von Pfaden, die Python nach Modulen durchsucht. Status zum Startzeitpunkt, kann sich während der Ausführung ändern |
Beispiel zum Auführen einer Datei
Execute a file | System | Konfiguration der Befehlszeile |
---|---|---|
Modul, cfg | Windows | "C:\Program Files\FreeCAD\bin\FreeCAD.exe" -M "C:\FreeCAD\Mod\Draft" -u "C:\FreeCAD\Config\user.cfg" -s "C:\FreeCAD\Config\system.cfg" |
Linux | todo | |
.FCMacro oderr .py | Windows | "C:\Program Files\FreeCAD\bin\FreeCAD.exe" "C:\Users\userName\AppData\Roaming\FreeCAD\Mod\WorkFeature\start_WF.FCMacro" |
Linux | todo | |
Wie wird ein Makro gestaltet, um es automatisch beim Start von FreeCAD zu starten | Windows / Linux / Mac | Siehe Seite Macro at Startup Wie wird ein Makro gestaltet, um es automatisch beim Start von FreeCAD zu starten. |
Einige Bibliotheken benötigen Zugriff zu Systemumgebungsvariablen. Manchmal, wenn es ein Problem mit einer FreeCAD-Installation gibt, liegt es daran, dass eine Umgebungsvariable nicht oder falsch gesetzt ist. Deshalb werden einige wichtige Variablen in die Konfiguration dupliziert und in der Log-Datei gespeichert.
Python-bezogene Umgebungsvariablen
- PYTHONPATH
- PYTHONHOME
- TCL_LIBRARY
- TCLLIBPATH
OpenCascade-bezogene Umgebungsvariablen:
- CSF_MDTVFontDirectory
- CSF_MDTVTexturesDirectory
- CSF_UnitsDefinition
- CSF_UnitsLexicon
- CSF_StandardDefaults
- CSF_PluginDefaults
- CSF_LANGUAGE
- CSF_SHMessage
- CSF_XCAFDefaults
- CSF_GraphicShr
- CSF_IGESDefaults
- CSF_STEPDefaults
System-bezogene Umgebungsvariablen:
- PATH
Programmpaket [Build]-bezogene Informationen
Die folgende Tabelle zeigt die verfügbaren Informationen zur Programmpaketversion. Das Meiste kommt aus dem Subversion-Repository. Diese Dinge werden benötigt, eine Version genau so wieder erstellen zu können.
Konfig.-Variable | Beschreibung | Beispiel |
---|---|---|
BuildVersionMajor | Major Versionsnummer der Programmpaketausgabe. Definiert in src/Build/Version.h.in | 0 |
BuildVersionMinor | Minor Versionsnummer der Programmpaketausgabe. Definiert in src/Build/Version.h.in | 7 |
BuildRevision | SVN Repository Revisionsnummer der Source der Programmpaketausgabe. Generiert durch SVN | 356 |
BuildRevisionRange | Bereich von verschiedenen Änderungen | 123-356 |
BuildRepositoryURL | Repository-URL | https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src |
BuildRevisionDate | Datum der obigen Revision | 2007/02/03 22:21:18 |
BuildScrClean | Zeigt an, ob die Source nach dem Checkout verändert wurde | Src modified |
BuildScrMixed | Src not mixed |
"Branding"-verwandt (Warenkennzeichnung)
Diese Konfigurationseinträge beziehen sich auf den "Branding"-Mechanismus von FreeCAD. Mehr Details unter Branding.
Konfig.-Variable | Beschreibung | Beispiel |
---|---|---|
ExeName | Name der ausführbaren Programmpaket-Datei. Kann von FreeCAD abweichen, falls eine andere main.cpp benutzt wird. | FreeCAD.exe |
ExeVersion | Während des Programmstarts angezeigte Hauptversion | V0.7 |
AppIcon | Icon, das für das ausführbare Programm benutzt wird, angezeigt im Anwendungshauptfenster. | "FCIcon" |
ConsoleBanner | Banner, das im Konsolenmodus gezeigt wird | |
SplashPicture | Name des Icon, das für den Splash Screen benutzt wird | "FreeCADSplasher" |
SplashAlignment | Ausrichtung des Textes im Splash-Dialog | "Bottom" oder "Left" |
SplashTextColor | Farbe des Splasher-Textes | "#000000" |
StartWorkbench | Name des Arbeitsbereichs, der automatisch nach dem Programmstart gestartet wird | "Part design" |
HiddenDockWindow | Liste von Andockfenstern (getrennt durch Semikolon), die versteckt werden | "Property editor" |
Zugehörige Seiten
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzlicher Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Programmeinstellungen, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, Hilf FreeCAD, Spende
- Hilfe: Tutorien, Video Tutorien
- Arbeitsbereiche: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web