Donate

Third Party Tools

FreeCAD Build Tool

Оглавление

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

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

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

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

FreeCAD --help

 Usage: FreeCAD [options] File1 File2 ...
 
 Allowed options:
 
 Generic options:
   -v [ --version ]          Prints version string
   --verbose                 Prints verbose 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
   --set-config arg          Sets the value of a configuration key
   --keep-deprecated-paths   If set then config files are kept on the old 
                             location
 
 Configuration:
   -l [ --write-log ]        Writes FreeCAD.log to the user directory.
   --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     Run a given test case (use 0 (zero) to run all 
                             tests). If no argument is provided then return list
                             of all available tests.
   -r [ --run-open ] arg     Run a given test case (use 0 (zero) to run all 
                             tests). If no argument is provided then return list
                             of all available tests.  Keeps UI open after 
                             test(s) complete.
   -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
   --safe-mode               Force enable safe mode
   --pass arg                Ignores the following arguments and pass them 
                             through to be used by a script

Файлы конфигурации и ответов(response)

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

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

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 --console

Переменные Среды Окружения

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

App.getUserConfigDir()

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

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

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

Информация связанная со Сборкой

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

Связанная с Брендированием

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

 >>> FreeCAD.ConfigGet("ExeVersion")
 '0.19'

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

 FreeCAD --get-config ExeVersion

Из консоли FreeCAD

 $ FreeCAD --console
 [FreeCAD Console mode <Use Ctrl-D (i.e. EOF) to exit.>]
 >>> FreeCAD.ConfigGet("ExeVersion")
 '0.19'
 >>> exit()

 $ 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

Windows

set CURRENTDIR=%cd%
set FREECAD_USER_HOME=%CURRENTDIR%
start FreeCAD.exe -u FreeCAD/user.cfg -s FreeCAD/system.cfg --write-log

Or with FREECAD_USER_DATA (see):

set CURRENTDIR="%cd%"
set FREECAD_USER_DATA=%CURRENTDIR%/..
start FreeCAD.exe -u %FREECAD_USER_DATA%/user.cfg -s %FREECAD_USER_DATA%/system.cfg

set CURRENTDIR=%cd%
set FREECAD_USER_DATA=%CURRENTDIR%FreeCAD\
start %cd%FreeCAD\bin\FreeCAD.exe -u %FREECAD_USER_DATA%user.cfg -s %FREECAD_USER_DATA%system.cfg

Third Party Tools

FreeCAD Build Tool

Оглавление