Запуск и Конфигурирование

From FreeCAD Documentation
Revision as of 14:51, 11 May 2020 by Baritone (talk | contribs)

Обзор

На этой странице показаны различные способы запуска FreeCAD и наиболее важные особенности конфигурации.

Запуск FreeCAD из командной строки

FreeCAD может быть запущен, как правило, двойным щелчком по иконке на рабочем столе или выбором в стартовом меню, его также можно запустить напрямую из командной строки. Это позволяет вам изменять при запуске некоторые параметры по умолчанию.

Using command line options without a command line shell

  • On Ubuntu you can create a desktop icon and edit its properties. Add the command line options separated by spaces behind the program name in the "Command" field.
  • On Windows create a shortcut and edit the properties. Add the command line options separated by spaces to "Target" field.

Параметры командной строки

Параметры командной строки часто меняются. Следовательно, будет отличной идей проверить текущие опции, введя:

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 scripts/FreeCAD macro files can be specified as command line arguments to either of the executables mentioned above.

Конфигурационные параметры

При каждом запуске FreeCAD проверяет своё окружение и параметры командной строки. Он выстраивает конфигурационный набор который хранит суть о процессе выполнения программы(runtime information). Эта информация позже используется для определения места где сохранены пользовательские данные или файлы логов. Это также важно для анализа после крушения программы. Поэтому она сохраняется в лог файле(журнале).

Пользовательская информация

User config entries
Имя конф. переменной Краткий обзор Пример для 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

Аргументы командной строки

User config entries
Имя конф. переменной Краткий обзор Пример
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/"

Связанные с системой

User config entries
Имя конф. переменной Краткий обзор Пример для M$ Пример для Posix (Linux)
AppHomePath Путь куда установлен FreeCAD c:/Progam Files/FreeCAD_0.7 /user/local/FreeCAD_0.7
PythonSearchPath Содержит список путей для поисковика python модулей. Начальная конфигурация может изменятся во время вып. программы

Example execute a file

Command line configuration for 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 хранилища. Этот материал нужен чтобы точно восстановить версию!

User config entries
Имя конф. переменной Краткий обзор Пример
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. Смотри Брендинг для более подробной информации.

User config entries
Имя конф. переменной Краткий обзор Пример
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

Third Party Tools/ru
FreeCAD Build Tool/ru