На этой странице показаны различные способы запуска FreeCAD и наиболее важные особенности конфигурации.
FreeCAD может быть запущен, ка правильно двойным щелчком по иконке на рабочем столе или выбором в стартовом меню, его также можно запустить напрямую из командной строки. Это позволяет вам изменять,при запуске, некоторые парметры по умолчанию.
Параметры командной строки, часто изменяются, поэтому отличной идей будет проверить текущие опции, введя:
FreeCAD --help
Из появившегся ответа, вы можете прочесть назначение параметров:
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 может считать некоторые параметры из конфигурационного файл. Этот файл должен находится в bin директории и должен называться FreeCAD.cfg. помните параметры указанные в командной строке переопределяют конфигурационный файл!
Некоторые операционные системы, обладют очень низким приделом длинны командной строки. Обычно, чтобы обойти это ограничение используют файлы ответов. Файл ответов, это тот же конфигурационный файл, который использет тот же синтаксис командной строки. Если в командной строке указывается имя файла ответов, он загружается и обрабатывается в дополнение к командной строке:
FreeCAD @ResponseFile.txt
или:
FreeCAD --response-file=ResponseFile.txt
Существует несколько параметров не видных пользователю. Эти параметры такие как X-Window параметры, анализируются оконной системой:
FreeCAD обычно запускается в графическом режиме, но также вы можете принудительно запустить его в консольном режиме, введя:
FreeCAD -c
в командной строке. В консольном режиме, не будет отображаться пользовательский интерфейс, а вам будет предоставлена строка pythonинтепритатора. С помощи python командной строки, вы обладаете той же функциональностью , что и python интерпритатр запущеный внутри FreeCAD GUI, и обладаете доступом ко всем модулям и плагинам FreeCAD, исключая модуль FreeCADGui. Имейте в виду что все модули зависящие от FreeCADGui также могут быть не доступны.
Python scripts/FreeCAD macro files can be specified as command line arguments to either of the executables mentioned above.
При каждом запуске FreeCAD проверяет своё окружение и параметры командной строки. Он выстраивает конфигурационный набор который хранит суть о процессе выполнения программы(runtime information). Эта информация позже используется для определения места где сохранены пользовательские данные или файлы логов. Это также важно для анализа после крушения программы. Поэтому она сохраняется в лог файле(журнале).
Имя конф. переменной | Краткий обзор | Пример для M$ | Пример для Posix (Linux) |
---|---|---|---|
UserAppData | Путь где FreeCAD хранит User Related application data. | C:\Documents and Settings\username\Application Data\FreeCAD | /home/username/.FreeCAD |
UserParameter | Файл где FreeCAD хранит User Related application data. | C:\Documents and Settings\username\Application Data\FreeCAD\user.cfg | /home/username/.FreeCAD/user.cfg |
SystemParameter | Файл где FreeCAD хранит Application Related data. | C:\Documents and Settings\username\Application Data\FreeCAD\system.cfg | /home/username/.FreeCAD/system.cfg |
UserHomePath | Домашняя папка текущего пользователя | C:\Documents and Settings\username\My Documents | /home/username |
Имя конф. переменной | Краткий обзор | Пример |
---|---|---|
LoggingFile | 1 если ведение журнала включено | 1 |
LoggingFileName | Имя файла куда помещен журнал | C:\Documents and Settings\username\Application Data\FreeCAD\FreeCAD.log |
RunMode | Это паказывает как, будет работать основной цикл. "Script" означает что данный сценарий вызывается, а затем выходит. "Cmd" запускает командную строку интепритатора. "Internal" запускает внутренний сценарий. "Gui" входит в цикл Gui событий. "Module" загружается как python модуль. | "Cmd" |
FileName | Значение зависит RunMode | |
ScriptFileName | Значение зависит RunMode | |
Verbose | Уровень детализации в FreeCAD | "" or "strict" |
OpenFileCount | Содержит количество файлов, открытых через аргументы командной строки | "12" |
AdditionalModulePaths | Содержит дополнительные Пути к модулям заданных в командной строке | "extraModules/" |
Имя конф. переменной | Краткий обзор | Пример для M$ | Пример для Posix (Linux) |
---|---|---|---|
AppHomePath | Путь куда установлен FreeCAD | c:/Progam Files/FreeCAD_0.7 | /user/local/FreeCAD_0.7 |
PythonSearchPath | Содержит список путей для поисковика python модулей. Начальная конфигурация может изменятся во время вып. программы |
Некоторые библиотеки нуждаются в вызове системных переменных. Иногда когда возникают проблемы с установкой FreeCAD , потому что некоторые переменные отсутствуют или установлены неправильно. Таким образом, некоторые важные переменные дублируются в Config и сохраняются в журнале(log file).
Связанные с Python переменные окружения:
Связанные с OpenCascade переменные окружения:
Связанные с системой переменные окружения:
Приведенная ниже таблица показывает доступные информацию о версии Сборки. Большинство из неё поступает из Subversion хранилища. Этот материал нужен чтобы точно восстановить версию!
Имя конф. переменной | Краткий обзор | Пример |
---|---|---|
BuildVersionMajor | Основной номер версии Сборки. Задан в src/Build/Version.h.in | 0 |
BuildVersionMinor | Малый номер версии Сборки. Задан в src/Build/Version.h.in | 7 |
BuildRevision | Номер изменения кодов в SVN хранилище. Генерируется в SVN | 356 |
BuildRevisionRange | Диапазон различных изменений | 123-356 |
BuildRepositoryURL | URL Хранилища | https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src |
BuildRevisionDate | Дата упомянутых изменний | 2007/02/03 22:21:18 |
BuildScrClean | Показывает что было иземенено после проверки | Src modified |
BuildScrMixed | Src not mixed |
Это конфигурационные записи связанные с механизмом брендинга FreeCAD. Смотри Брендинг для более подробной информации.
Имя конф. переменной | Краткий обзор | Пример |
---|---|---|
ExeName | Название собранного исполняемого файла. Может запускаться из FreeCAD если используются различные main.cpp. | FreeCAD.exe |
ExeVersion | Большая из всех Версий появляется во время запуска(?) | V0.7 |
AppIcon | Иконка используемая для выполнения, отображается в главном окне приложения. | "FCIcon" |
ConsoleBanner | Банер выводимый в консольном режиме | |
SplashPicture | Название изображения используемого в качестве заставки | "FreeCADSplasher" |
SplashAlignment | Выравнивание текста в окне заставки | Left" |
SplashTextColor | Цвет текста заставки | "#000000" |
StartWorkbench | Название Инструментария автоматически открывающегося при запуске приложения | "Part design" |
HiddenDockWindow | Список окон(панелей) (разделенный запятой) которые будут отключены | "Property editor" |