Запуск и Конфигурирование
Обзор
На этой странице показаны различные способы запуска FreeCAD и наиболее важные особенности конфигурации.
Запуск FreeCAD из командной строки
FreeCAD может быть запущен, как правило, двойным щелчком по иконке на рабочем столе или выбором в стартовом меню, его также можно запустить напрямую из командной строки. Это позволяет вам изменять при запуске некоторые параметры по умолчанию.
Использование опций командной строки без оболочки командной строки
- В Ubuntu Вы можете создать иконку на десктопе (это будет файл формата XDG с расширением .desktop) и редактировать её параметры. Добавьте опции командной строки, разделённые пробелами, после имени программы в поле "Command".
- В Windows создайте ссылку и редактируйте её параметры. Добавьте разделённые пробелами опции командной строки в поле "Target".
Параметры командной строки
Параметры командной строки часто меняются. Следовательно, будет отличной идей проверить текущие опции, введя:
FreeCAD --help
Из появившегося ответа вы можете прочесть назначение параметров:
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
Файлы конфигурации и ответов(response)
FreeCAD может считать некоторые параметры из конфигурационного файла. Этот файл должен находится в пути bin и должен называться FreeCAD.cfg. Помните, у параметров командной строки приоритет над конфигурационным файлом!
Некоторые операционные системы имеют очень лимитированную по символам командную строку. Чтобы обойти это ограничение используют обычно файлы ответов. Файл ответов - это просто конфигурационный файл, который использует синтаксис командной строки. Если в командной строке указан файл ответов, он загружается и обрабатывается как дополнение к командной строке:
FreeCAD @ResponseFile.txt
или:
FreeCAD --response-file=ResponseFile.txt
Скрытые опции
Существует несколько параметров не видных пользователю. Эти параметры такие как X-Window параметры, анализируются оконной системой:
- -display display, устанавливает значение X дисплея (по умолчанию это $DISPLAY).
- -geometry geometry, устанавливает клиент геометрии первое окно что отображается.
- -fn или -font font, определяет шрифт приложения. Шрифт должен быть указан используя X логическо описание шрифта.
- -bg или -background color, устанавливает цвет фона по умолчанию и палитру приложения (рассчитываются темные и светлые оттенки).
- -fg или -foreground color, устанавливает цвет по умолчанию переднего плана.
- -btn или -button color, устанавливает цвет по умолчанию для кнопок.
- -name name, устанавливает имя приложения.
- -title title, устанавливает заголовок приложения.
- -visual TrueColor, заставляет приложение использовать TrueColor визуальное отображение на 8-битном дисплее.
- -ncols count, граничивает число цветов выделенных в цветовой куб на 8-битном дисплее, если приложение использует QApplication::ManyColor цветовую спецификацию. Если количество 216 то используется цветовой куб 6x6x6 (т.е. 6 уровней красного, 6 зеленого, и 6 синего); для остальных значений, используется куб пропорциональный 2x3x1.
- -cmap, вызывает приложение для установки вашей карты цветов на 8-битном дисплее.
Запуск FreeCAD без Графического Интерфейса
FreeCAD обычно компилируется в два исполняемых файла: с графическим интерфейсом, FreeCAD, и только с командной строкой, FreeCADCmd. FreeCAD может запускаться в консольном режиме с помощью ключа "-c", для FreeCADCmd это поведение по умолчанию:
FreeCAD -c
в командной строке. В консольном режиме, не будет отображаться пользовательский интерфейс, а вам будет предоставлена строка интерпретатора python. С помощью командной строки python, вы обладаете той же функциональностью, что и интерпретатором python, запущенном внутри FreeCAD GUI, и обладаете доступом ко всем модулям и плагинам FreeCAD, исключая модуль FreeCADGui. Имейте в виду, что модули, зависящие от FreeCADGui, также могут быть недоступны.
Скрипты Python и файлы макросов FreeCAD могут быть указаны как аргументы командной строки для любого вышеуказанного исполняемого файла.
Конфигурационные параметры
При каждом запуске FreeCAD проверяет своё окружение и параметры командной строки. Он выстраивает конфигурационный набор который хранит суть о процессе выполнения программы (runtime information). Эта информация позже используется для определения места где сохранены пользовательские данные или файлы логов. Это также важно для анализа после крушения программы. Поэтому она сохраняется в лог файле (журнале).
Пользовательская информация
Имя конф. переменной | Краткий обзор | Пример для M$ | Пример для Posix (Linux) |
---|---|---|---|
UserAppData | Путь где FreeCAD хранит пользовательские данные программы. | C:\Documents and Settings\username\AppData\FreeCAD Short path : %APPDATA%\FreeCAD |
/home/username/.FreeCAD Short path : ~/.FreeCAD |
UserParameter | Файл где FreeCAD хранит пользовательские данные программы. | 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 | Файл где FreeCAD хранит данные программы. | 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 | Домашняя папка текущего пользователя. | C:\Documents and Settings\username Short path : %USERPROFILE% |
/home/username Short path : ~ |
Аргументы командной строки
Имя конф. переменной | Краткий обзор | Пример |
---|---|---|
LoggingFile | 1 если ведение журнала включено | 1 |
LoggingFileName | Имя файла куда помещен журнал | C:\Documents and Settings\username\AppData\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. Начальная конфигурация может изменятся во время выполнения программы |
Example execute a file
Execute a file | System | Command line configuration |
---|---|---|
Module, 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 or .py | Windows | "C:\Program Files\FreeCAD\bin\FreeCAD.exe" "C:\Users\userName\AppData\Roaming\FreeCAD\Mod\WorkFeature\start_WF.FCMacro" |
Linux | todo | |
How to set up a macro to automatically run at FreeCAD startup | Windows / Linux / Mac | See the page Macro at Startup how to set up a macro to automatically run at FreeCAD startup. |
Некоторые библиотеки нуждаются в вызове системных переменных. Иногда когда возникают проблемы с установкой FreeCAD , потому что некоторые переменные отсутствуют или установлены неправильно. Таким образом, некоторые важные переменные дублируются в Config и сохраняются в журнале(log file).
Связанные с Python переменные окружения:
- PYTHONPATH
- PYTHONHOME
- TCL_LIBRARY
- TCLLIBPATH
Связанные с OpenCascade переменные окружения:
- 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
Информация связанная со Сборкой
Приведенная ниже таблица показывает доступные информацию о версии Сборки. Большинство из неё поступает из 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" |
Related Pages
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub