Denna sida visar olika sätt att starta FreeCAD och de viktigaste konfigurationsegenskaperna.
FreeCAD kan startas normalt, genom att dubbelklicka på dess skrivbordsikon eller genom att välja den från startmenyn, men det kan också startas direkt från kommandoraden. Detta tillåter dig att ändra några av standard uppstartsalternativen.
Kommandoradsalternativen förändras ofta, så därför är det en bra ide att kontrollera alternativen genom att skriva:
FreeCAD --help
Från svaret kan du läsa de möjliga parametrarna:
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)
"C:\Program Files\FreeCAD 0.14\bin\FreeCAD.exe" -M "N:\FreeCAD\Mod\Draft" -M "N:\FreeCAD\Mod\Part" -M "N:\FreeCAD\Mod\Drawing" -u "N:\FreeCAD\Config\user.cfg" -s "N:\FreeCAD\Config\system.cfg"
FreeCAD kan läsa en del av dessa alternativ från en konfigurationsfil. Denna fil måste ligga i bin sökvägen och måste ha namnet FreeCAD.cfg. Tänk på att alternativ som specificeras på kommandoraden har högre prioritet än konfigurationsfilen!
En del operativsystem har en låg gräns på kommandoradens längd. Det vanliga sättet att komma runt dessa begränsningar är att använda responsfiler. En responsfil är bara en konfigurationsfil som använder samma syntax som kommandoraden. Om kommandoraden specificerar namnet på den responsfil som ska användas, så laddas den och läses i tillägg till kommandoraden:
FreeCAD @ResponseFile.txt
eller:
FreeCAD --response-file=ResponseFile.txt
Det finns en del alternativ som inte visas för användaren. Dessa alternativ är egentligen X-fönsterparametrar som läses av fönstersystemet:
FreeCAD startar normalt i gränssnittsläge, men du kan också tvinga det att starta i konsolläge genom att skriva:
FreeCAD -c
på kommandoraden. I konsolläge, så kommer inget användargränssnitt att visas, och du kommer att presenteras med en pythontolks prompt. Från den pythonprompten så har du samma funktionalitet som den pythontolk som körs inuti FreeCAD gränssnittet, med normal åtkomst till alla FreeCADs moduler och plugin, förutom FreeCADGui modulen. Tänk på att moduler som beror på FreeCADGui kanske inte heller finns tillgängliga.
Python scripts/FreeCAD macro files can be specified as command line arguments to either of the executables mentioned above.
Vid varje uppstart så undersöker FreeCAD sin omgivning och kommandoradsparametrarna. Det bygger upp ett configuration set vilket innehåller den huvudsakliga körinformationen. Denna information används senare för att avgöra vilken plats som användardata eller loggfiler ska sparas. Det är också mycket viktigt för postmortem analyser. Därför så sparas det i loggfilen.
Konfig. var. namn | Förklaring | Exempel M$ | Exempel Posix (Linux) |
---|---|---|---|
UserAppData | Sökväg där FreeCAD lagrar användarrelaterad applikationsdata. | C:\Documents and Settings\username\Application Data\FreeCAD | /home/username/.FreeCAD |
UserParameter | Fil där FreeCAD lagrar användarrelaterad applikationsdata. | C:\Documents and Settings\username\Application Data\FreeCAD\user.cfg | /home/username/.FreeCAD/user.cfg |
SystemParameter | Fil där FreeCAD lagrar applikationsrelaterad data. | C:\Documents and Settings\username\Application Data\FreeCAD\system.cfg | /home/username/.FreeCAD/system.cfg |
UserHomePath | Nuvarande användares sökväg till hem mappen | C:\Documents and Settings\username\My Documents | /home/username |
Konfig. var. namn | Förklaring | Exempel |
---|---|---|
LoggingFile | 1 om loggningen är påslagen | 1 |
LoggingFileName | Filnamn där loggen sparas | C:\Documents and Settings\username\Application Data\FreeCAD\FreeCAD.log |
RunMode | Detta indikerar hur huvudslingan kommer att fungera. "Script" innebär att det givna skriptet anropas och avslutas efter det. "Cmd" kör kommandotolken. "Internal" kör ett internt skript. "Gui" startar händelseslingan för gränssnittet. "Module" laddar en given python modul. | "Cmd" |
FileName | Innebörd beror på RunMode | |
ScriptFileName | Innebörd beror på RunMode | |
Verbose | FreeCADs pratighet, d.v.s. hur mycket som loggas | "" eller "strict" |
OpenFileCount | Innehåller antalet filer som öppnas genom kommandoradsargument | "12" |
AdditionalModulePaths | Innehåller sökvägen för de extramoduler som ges i kommandoraden | "extraModules/" |
Konfig. var. namn | Förklaring | Exempel M$ | Exempel Posix (Linux) |
---|---|---|---|
AppHomePath | Sökväg där FreeCAD är installerat | c:/Progam Files/FreeCAD_0.7 | /user/local/FreeCAD_0.7 |
PythonSearchPath | Innehåller en lista på sökvägar där python söker efter moduler. Detta är vid uppstart och kan ändras under körning |
En del bibliotek behöver anropa systemmiljövariabler. ibland när det är ett problem med en FreeCAD installation, så beror det på att en del miljövariabler saknas eller är felinställda. Därför dupliceras några viktiga variabler i Konfigurationen och sparas i loggfilen.
Python relaterade miljövariabler:
OpenCascade relaterade miljövariabler:
System relaterade miljövariabler:
Tabellen nedan visar tillgänglig information om Byggversionen. Det flesta av dem kommer från Subversion förrådet. dessa saker behövs för att exakt återuppbygga en version!
Konfig. var. namn | Förklaring | Exempel |
---|---|---|
BuildVersionMajor | Byggningens Major Versionsnummer. Definierad i src/Build/Version.h.in | 0 |
BuildVersionMinor | Byggningens Minor Versionsnummer. Definierad i src/Build/Version.h.in | 7 |
BuildRevision | Källkodens SVN Repository Revisionnummer i byggningen. Genererad av SVN | 356 |
BuildRevisionRange | Område för olika ändringar | 123-356 |
BuildRepositoryURL | URL adress för förråd | https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src |
BuildRevisionDate | Datum av ovanstående Revision | 2007/02/03 22:21:18 |
BuildScrClean | Indikerar om källkoden har ändrats efter kontroll | Källkod ändrad |
BuildScrMixed | Källkod inte blandad |
Dessa konfigurationspunkter är relaterade till FreeCADs märkningsmekanism. Se Branding/sv för mer detaljer.
Konfig. var. namn | Förklaring | Exempel |
---|---|---|
ExeName | Namn på den byggda körfilen. Kan skilja sig från FreeCAD om en annan main.cpp används. | FreeCAD.exe |
ExeVersion | Allmän version som visas vid uppstart | V0.7 |
AppIcon | Ikon som används för körfilen, visas i Applikationens huvudfönster. | "FCIcon" |
ConsoleBanner | Den banner som visas i konsolläge | |
SplashPicture | Namn på den ikon som används till uppstartsskärmen | "FreeCADSplasher" |
SplashAlignment | Textjustering i uppstartsdialogen | Left" |
SplashTextColor | Textfärg i uppstartsfönstret | "#000000" |
StartWorkbench | Namn på den arbetsbänk som ska startas automatiskt efter uppstart | "Part design" |
HiddenDockWindow | Lista på dockningsfönster (separerade av semikolon) som kommer att inaktiveras | "Property editor" |