Start up and Configuration/ru

Обзор
На этой странице показаны различные способы запуска 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

In the following table, selected options are described in more detail:

Options can written in two forms: and.

Файлы конфигурации и ответов(response)
FreeCAD может считать некоторые параметры из конфигурационного файла. Этот файл должен находится в пути bin и должен называться. Помните, у параметров командной строки приоритет над конфигурационным файлом!

Некоторые операционные системы имеют очень лимитированную по символам командную строку. Чтобы обойти это ограничение используют обычно файлы ответов. Файл ответов - это просто конфигурационный файл, который использует синтаксис командной строки. Если в командной строке указан файл ответов, он загружается и обрабатывается как дополнение к командной строке:

FreeCAD @ResponseFile.txt

или: FreeCAD --response-file=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 может запускаться в консольном режиме с помощью ключа "-c", для это поведение по умолчанию:

FreeCAD --console

в командной строке. В консольном режиме, не будет отображаться пользовательский интерфейс, а вам будет предоставлена строка интерпретатора python. С помощью командной строки python, вы обладаете той же функциональностью, что и интерпретатором python, запущенном внутри FreeCAD GUI, и обладаете доступом ко всем модулям и плагинам FreeCAD, исключая модуль FreeCADGui. Имейте в виду, что модули, зависящие от FreeCADGui, также могут быть недоступны.

To read more about console or headless mode, refer to Headless FreeCAD.

Пример выполнения файла
See Macro at Startup on how to set up a macro to automatically run at FreeCAD startup.

Переменные Среды Окружения
FreeCAD supports the following environment variables, which can be used to configure directories: If the specified path does not exist, the setting is ignored!

The above environment variables are meant to be used to realize a portable FreeCAD environment. For an example how environment variables can be used from the command line on Linux refer to the notes for Linux users on the downloads page.

FreeCAD uses Qt, which does honor the environmental variable. Thus, setting can be used to specify the base directory of Qt-related configuration files.

FreeCad itself does not honor the environmental variable (because it determines the user's home directory from a lower-level system API). Use for this pupose.

The default temporary directory is. The environmental variable can be used to override the default. (Editor: precedence?).

Libraries
Некоторые библиотеки нуждаются в вызове системных переменных. Иногда когда возникают проблемы с установкой 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

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

Пользовательская информация
Note: For Linux distributions, an additional configuration file that relates to Qt may exist at path.

Информация связанная со Сборкой
Приведенная ниже таблица показывает доступную информацию о версии сборки. Большая часть её взята из хранилища Subversion. Этот материал нужен, чтобы точно восстановить версию!

Связанная с Брендированием
Это конфигурационные записи связанные с механизмом брендинга FreeCAD. Смотри Брендинг для более подробной информации.

Querying the configuration
From FreeCAD's Python console

Entries of the configuration set can be queried with the config var name (see tables above) from the Python console. For example: >>> FreeCAD.ConfigGet("ExeVersion") '0.19' If the name is not found, an empty string is returned.

Из командной строки

Use the option to query a single name. Not all names are supported. For example: FreeCAD --get-config ExeVersion

Use the option to get a list of names and their values. Not all names are supported.

Из консоли FreeCAD

Start FreeCAD in console mode with and query with Python code. For example: $ FreeCAD --console [FreeCAD Console mode ] >>> FreeCAD.ConfigGet("ExeVersion") '0.19' >>> exit

For Linux (bash shell) you can modify the following command line to suit your needs: $ FreeCAD --console <<EOF print( "FREECAD_USER_HOME: " + ( "not set" if ( os.environ.get('FREECAD_USER_HOME') is None ) else os.environ.get('FREECAD_USER_HOME') ) ) print( "UserHomePath: " + FreeCAD.ConfigGet("UserHomePath") ) exit EOF

Linux: Creating an additional start option
The following assumes that your desktop is configured such that you can launch FreeCAD from it. Depending on your Linux distribution and desktop environment, you may have to adapt the following steps:
 * 1) Copy the freedesktop entry file for FreeCAD from  to.
 * 2) Change the name from  to something else (e.g. ).
 * 3) Open the file with a text editor and change how FreeCAD is invoked by modifying the line starting with.
 * 4) As a result, an additional entry in your start menu/application launcher is available. This way, you can have multiple FreeCAD entries with various launch options.

Starting FreeCAD from a portable USB medium
Windows

Put the FreeCAD executable,, on the USB medium. Create a batch file,, and put it into the same directory as. Inside the batch file write:

Or with (see):

With the batch in the root of the USB medium:

Now double-click the batch file to start FreeCAD. (see)