Preferences Editor/zh-cn: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(94 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Interface_Customization|Interface Customization]]
|[[Document structure|Document structure]]
|[[Import Export Preference|Import Export Preference]]
|[[Import_Export_Preferences|Import Export Preferences]]
}}
}}

{{TOCright}}


==Introduction==
==Introduction==
Line 9: Line 12:
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
FreeCAD的首选项系统位于{{MenuCommand|Edit menu → Preferences}}。
FreeCAD的首选项系统位于{{MenuCommand|Edit menu → Preferences}}。
</div>
</div>

{{TOCright}}
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
FreeCAD中的功能被分为不同的模块,每个模块负责实现一种特定[[Workbenches|workbench]]的具体工作。 FreeCAD采用的是延迟加载方式,意即只有当需要使用特定组件时才会进行加载。您在FreeCAD的工具栏中选择工作台时可能会注意到这一点,因为在加载工作台及其所有组件时需要花费一点儿时间。在进行首选项设置时也是如此。
FreeCAD中的功能被分为不同的模块,每个模块负责实现一种特定[[Workbenches|workbench]]的具体工作。 FreeCAD采用的是延迟加载方式,意即只有当需要使用特定组件时才会进行加载。您在FreeCAD的工具栏中选择工作台时可能会注意到这一点,因为在加载工作台及其所有组件时需要花费一点儿时间。在进行首选项设置时也是如此。
</div>
</div>

To preserve resources, FreeCAD does not automatically load all available workbenches. See [[#Workbenches|Workbenches]] for more information. For a list of workbench related preferences see [[#Workbench_related_preferences|Workbench related preferences]].


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 19: Line 24:
</div>
</div>


<div class="mw-translate-fuzzy">
点击首选项左下角的{{Button|Reset}}按钮,即可将FreeCAD中的'''所有'''首选项设置还原为其默认值。
点击首选项左下角的{{Button|Reset}}按钮,即可将FreeCAD中的'''所有'''首选项设置还原为其默认值。
</div>

Some advanced preferences can only be changed in the [[Std_DlgParameter|Parameter editor]]. The [[Fine-tuning|Fine-tuning]] page lists some of them.


<span id="General"></span>
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
==通用设置==
==通用设置==
Line 29: Line 39:
</div>
</div>


In {{VersionMinus|0.21}} the seventh tab, Help, is only available if the [https://github.com/FreeCAD/FreeCAD-Help Help Addon] has been [[Std_AddonMgr|installed]].
===General===

<span id="General"></span>
===常规===


<div class="mw-translate-fuzzy">
在''General''选项卡中,您可以指定下列内容:
在''General''选项卡中,您可以指定下列内容:

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|名称
!style="width 33%;"|名称
!style="width: 66%;"|描述
!style="width 66%;"|描述
|-
|-
| {{MenuCommand|Change language}}
| {{MenuCommand|更改语言}}
| 选择FreeCAD的用户界面语言
| 选择FreeCAD的用户界面语言
|-
|-
| {{MenuCommand|Size of recent file list}}
| {{MenuCommand|最近文件列表大小}}
| 指定有多少最近用过的文件显示在recent files列表中
| 指定有多少最近用过的文件显示在recent files列表中
|-
|-
| {{MenuCommand|Enable tiled background}}
| {{MenuCommand|启用平面背景}}
| 如果选中此复选框,则FreeCAD的主窗口背景将默认由以下图片填充:[[File:Background.png|64px]]<br/>本选项只有在{{MenuCommand|Style sheet}}/''No style sheet''被选中时才会生效。<br/>将图片加入到下列路径中的{{FileName|Gui/Images}}文件夹下即可改变贴图内容 <br/>[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ {{FileName|%APPDATA%]/FreeCAD}} (在Windows上),<br/>{{FileName|$HOME/.FreeCAD}} (在Linux上) or<br/>{{FileName|$HOME/Library/Preferences/FreeCAD}} (在MacOS上)。<br/>将图片文件命名为{{FileName|background.png}},再依次取消/选中本选项来查看效果。
| 如果选中此复选框,则FreeCAD的主窗口背景将默认由以下图片填充:[[File:Background.png|64px]]<br/>本选项只有在{{MenuCommand|样式表:}}/''No style sheet''被选中时才会生效。<br/>将图片加入到下列路径中的{{FileName|Gui/Images}}文件夹下即可改变贴图内容 <br/>[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ {{FileName|%APPDATA%]/FreeCAD}} (在Windows上),<br/>{{FileName|$HOME/.FreeCAD}} (在Linux上) or<br/>{{FileName|$HOME/Library/Preferences/FreeCAD}} (在MacOS上)。<br/>将图片文件命名为{{FileName|background.png}},再依次取消/选中本选项来查看效果。
|-
| {{MenuCommand|Style sheet}}
| 选择样式表。样式表定义了FreeCAD用户界面的外观。
|-
| {{MenuCommand|Size of toolbar icons}}
| 选择工具栏图标的大小。
|-
| {{MenuCommand|Auto load module after start up}}
| 选择FreeCAD开启后将直接打开的工作台。
|-
| {{MenuCommand|Enable splash screen at start up}}
| 如果选中此项, 则在FreeCAD开启时展示启动画面。<br/>可通过向{{FileName|%APPDATA%/FreeCAD}}( %APPDATA%是用户在操作系统中为FreeCAD指定的应用文件夹)添加{{FileName|Gui/Images}}文件夹来修改启动画面。将作为启动画面的图像命名为{{FileName|splash_image.png}}并重启FreeCAD即可看到效果。
|-
| {{MenuCommand|Enable word wrap}}
| 利用此选项可实现在Python控制台中令超出一行中的文本自动换行。利用{{MenuCommand|View → Panels → Python console}}菜单来开启Python控制台。
|}
</div>
</div>


Optionally, imported files can be excluded from this list, and exported files can be included. See [[Fine-tuning|Fine-tuning]].
This option only has an effect if in {{MenuCommand|Style sheet}}/''No style sheet'' is selected.
|-
| {{MenuCommand|Enable tiled background}}
| If checked, the background of FreeCAD's main window will by default consist of tiles of this image: [[File:Background.png|64px]]


This option only has an effect if no {{MenuCommand|Style sheet}} is selected.
The image can be changed by adding the folders {{FileName|Gui/Images}} in the folder


The image can be changed by adding the folders {{FileName|Gui/Images}} in the folder:
[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ {{FileName|%APPDATA%]/FreeCAD}} (on Windows),

{{FileName|[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ %APPDATA%]/FreeCAD}} (on Windows),


{{FileName|$HOME/.FreeCAD}} (on Linux) or
{{FileName|$HOME/.FreeCAD}} (on Linux) or


{{FileName|$HOME/Library/Preferences/FreeCAD}} (on MacOS).
{{FileName|$HOME/Library/Preferences/FreeCAD}} (on macOS).


Put there a file named {{FileName|background.png}} and uncheck/check this option to see the changed file.
Place a file named {{FileName|background.png}} in the {{FileName|Images}} folder, and uncheck/check this option to see the changed file.
|-
|-
| {{MenuCommand|Style sheet}}
| {{MenuCommand|Enable splash screen at start up}}
| Selection of a style sheet. The style sheets define how the user interface of FreeCAD looks.
| If checked, a splash screen is shown when starting FreeCAD.

<div class="mw-translate-fuzzy">
|-
|-
| {{MenuCommand|Size of toolbar icons}}
| {{MenuCommand|样式表:}}
| 选择样式表。样式表定义了FreeCAD用户界面的外观。
| Selection of the size for the toolbar icons
|-
|-
| {{MenuCommand|Auto load module after start up}}
| {{MenuCommand|工具栏图标大小}}
| 选择工具栏图标的大小。
| Selection what workbench will be used directly after starting FreeCAD
|-
|-
| {{MenuCommand|Enable splash screen at start up}}
| {{MenuCommand|启动后自动加载模块}}
| 选择FreeCAD开启后将直接打开的工作台。
| If checked, the splash screen of FreeCAD is shown when starting.

The splash screen image can be changed by adding the folders {{FileName|Gui/Images}} in the folder {{FileName|%APPDATA%/FreeCAD}} (where %APPDATA% is the the user-specific application folder of FreeCAD of your operating system). Put there a file named {{FileName|splash_image.png}} and restart FreeCAD to see the changed splash screen.
|-
|-
| {{MenuCommand|Enable word wrap}}
| {{MenuCommand|打开软件启动界面}}
| 如果选中此项, 则在FreeCAD开启时展示启动画面。<br/>可通过向{{FileName|%APPDATA%/FreeCAD}}( %APPDATA%是用户在操作系统中为FreeCAD指定的应用文件夹)添加{{FileName|Gui/Images}}文件夹来修改启动画面。将作为启动画面的图像命名为{{FileName|splash_image.png}}并重启FreeCAD即可看到效果。
| Words will be wrapped when they exceed the available horizontal space in the Python console. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|-
| {{MenuCommand|启用自动换行}}
| 利用此选项可实现在Python控制台中令超出一行中的文本自动换行。利用{{MenuCommand|View → Panels → Python console}}菜单来开启Python控制台。
|}
|}
</div>


[[Image:Preference_General_Tab_01.png]]
[[Image:Preferences_General_Tab_General.png]]


===Document===
<span id="Document"></span>
===文档===

在''Document''选项卡中,您可以指定以下内容:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
在''Document''选项卡中,您可以指定以下内容:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|名称
!style="width 33%;"|名称
!style="width: 66%;"|描述
!style="width 66%;"|描述
|-
|-
| {{MenuCommand|Create new document at start up}}
| {{MenuCommand|启动时创建新文档}}
| 如果选中此选项,FreeCAD将在启动时创建一个新文档。
| 如果选中此选项,FreeCAD将在启动时创建一个新文档。
|-
|-
Line 109: Line 118:
| 指定{{FileName|FCStd}}文件的压缩级别。{{FileName|FCStd}}文件为ZIP压缩文件。因此,您可以将其后缀{{FileName|.FCStd}}改为{{FileName|.zip}},并用ZIP归档程序来打开它们。
| 指定{{FileName|FCStd}}文件的压缩级别。{{FileName|FCStd}}文件为ZIP压缩文件。因此,您可以将其后缀{{FileName|.FCStd}}改为{{FileName|.zip}},并用ZIP归档程序来打开它们。
|-
|-
| {{MenuCommand|Using Undo/Redo on documents}}
| {{MenuCommand|在文档上使用撤消/重做}}
| 如果选中此选项,所有文档的更改情况将被保存下来,因此即可实现undone/redone。
| 如果选中此选项,所有文档的更改情况将被保存下来,因此即可实现undone/redone。
|-
|-
| {{MenuCommand|Maximum Undo/Redo steps}}
| {{MenuCommand|最大撤消/重做步数}}
| 指定可以记录多少次Undo/Redo操作。
| 指定可以记录多少次Undo/Redo操作。
|-
|-
| {{MenuCommand|Run AutoRecovery at startup}}
| {{MenuCommand|在启动时运行自动恢复}}
| 如果存在恢复文件,则FreeCAD将在开启时自动运行此文件进行恢复。此法可对程序崩溃时的文件进行恢复。
| 如果存在恢复文件,则FreeCAD将在开启时自动运行此文件进行恢复。此法可对程序崩溃时的文件进行恢复。
|-
|-
| {{MenuCommand|Save AutoRecovery information every}}
| {{MenuCommand|每次都保存自动恢复信息}}
| 指定多久写一次恢复文件。
| 指定多久写一次恢复文件。
|-
|-
| {{MenuCommand|Save thumbnail into project file when saving document}}
| {{MenuCommand|保存文件时同时保存缩略图到项目文件}}
| 如果选中此选项,在保存文档时,也将存储一份项目的缩略图。此缩略图将显示在[[Start_Workbench|启动工作台]]中的最近打开文件列表中。
| 如果选中此选项,在保存文档时,也将存储一份项目的缩略图。此缩略图将显示在[[Start_Workbench|启动工作台]]中的最近打开文件列表中。
|-
|-
| {{MenuCommand|Add the program logo to the generated thumbnail}}
| {{MenuCommand|将程序徽标添加到生成的缩略图}}
| 如果选中此选项,则会将FreeCAD程序的logo [[image:FreeCAD-logo.svg|24px]]添加至缩略图中。此选项仅在开启{{MenuCommand|Save thumbnail into project file when saving document}}选项后才会生效。
| 如果选中此选项,则会将FreeCAD程序的logo [[image:FreeCAD-logo.svg|24px]]添加至缩略图中。此选项仅在开启{{MenuCommand|保存文件时同时保存缩略图到项目文件}}选项后才会生效。
|-
|-
| {{MenuCommand|Maximum number of backup files to keep when resaving document}}
| {{MenuCommand|保存文档时要保留的最大备份文件数}}
| 如果选中此选项,在保存文档时也会保留备份文件。您可以指定保留备份文件的数量。这些文件中保存的是此前(previously)的文档版本。第一个备份文件的后缀为 {{FileName|.FCStd1}}, 第二个后缀为{{FileName|.FCStd2}},并以此类推。
| 如果选中此选项,在保存文档时也会保留备份文件。您可以指定保留备份文件的数量。这些文件中保存的是此前(previously)的文档版本。第一个备份文件的后缀为 {{FileName|.FCStd1}}, 第二个后缀为{{FileName|.FCStd2}},并以此类推。
|-
|-
| {{MenuCommand|Allow duplicate object labels in one document}}
| {{MenuCommand|在一个文档中允许重复的对象标签}}
| 如果选中此选项,则不同的对象可以使用相同的标签/名称。例如,同一文档中的不同零件与features可用相同的名字。
| 如果选中此选项,则不同的对象可以使用相同的标签/名称。例如,同一文档中的不同零件与features可用相同的名字。
|-
|-
| {{MenuCommand|Author name}}
| {{MenuCommand|作者姓名}}
| 创建的所有文档均采用此指定的作者名。对于匿名作者而言,作者名字的区域为空白内容。若开启了{{MenuCommand|Set on save}}选项,则在保存文件时将''Last modified by''的内容设置为此作者名。可通过{{MenuCommand|File → Project information}}菜单来查看该文本域。
| 创建的所有文档均采用此指定的作者名。对于匿名作者而言,作者名字的区域为空白内容。若开启了{{MenuCommand|保存时的设置}}选项,则在保存文件时将''Last modified by''的内容设置为此作者名。可通过{{MenuCommand|File → Project information}}菜单来查看该文本域。
|-
|-
| {{MenuCommand|Company}}
| {{MenuCommand|公司}}
| 将创建的所有文档都指定为此公司名称。
| 将创建的所有文档都指定为此公司名称。
|-
|-
| {{MenuCommand|Default license}}
| {{MenuCommand|默认许可证}}
| 为新文档所指定的默认许可证。对于预定义的许可证而言,{{MenuCommand|License URL}}将自动做出对应的设置。而针对自定义许可证或特殊许可证来讲,可选择'Other(其他)'项。
| 为新文档所指定的默认许可证。对于预定义的许可证而言,{{MenuCommand|许可证网址}}将自动做出对应的设置。而针对自定义许可证或特殊许可证来讲,可选择'Other(其他)'项。
|-
|-
| {{MenuCommand|License URL}}
| {{MenuCommand|许可证网址}}
| 指定URL来描述{{MenuCommand|Default license}}中所选的许可证。
| 指定URL来描述{{MenuCommand|默认许可证}}中所选的许可证。
|}
|}
</div>
</div>


[[Image:Preference_General_Tab_02.png]]
[[Image:Preferences_General_Tab_Document.png]]


<span id="Selection"></span>
===Editor===
===选择===


On the ''Selection'' tab you can specify the following:
<div class="mw-translate-fuzzy">
编辑器首选项设置影响的是宏编辑器的行为。此编辑器可通过{{MenuCommand|Macro → Macros... → Edit/Create}}菜单打开。<br/>'''请注意:''' 这里的颜色和字体设置也会影响到[https://en.wikipedia.org/wiki/Python_(programming_language) Python]控制台。此控制台可通过{{MenuCommand|View → Panels → Python console}}菜单打开。
</div>


The color and font settings also affect the [[Python console|Python console]]. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.

在''Editor''选项卡中,您可以指定以下内容:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|名称
!style="width: 33%;"|Name
!style="width: 66%;"|描述
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Display Items}}
| {{MenuCommand|Auto switch to the 3D view containing the selected item}}
| Enables the [[Std_TreeSyncView|Tree view SyncView mode]].
| 选择代码类型。此处的颜色与字体设置将应用于所选的代码类型。可以从'''Preview'''框中预览效果。
|-
|-
| {{MenuCommand|Auto expand tree item when the corresponding object is selected in 3D view}}
| {{MenuCommand|Family}}
| Enables the [[Std_TreeSyncSelection|Tree view SyncSelection mode]].
| 指定应用于所选代码类型的字体系列(font family)。
|-
|-
| {{MenuCommand|Size}}
| {{MenuCommand|Preselect the object in 3D view when mouse over the tree item}}
| Enables the [[Std_TreePreSelection|Tree view PreSelection mode]].
| 指定应用于所选代码类型的字体大小。
|-
|-
| {{MenuCommand|Enable line numbers}}
| {{MenuCommand|Record selection in tree view in order to go back/forward using navigation button}}
| Enables the [[Std_TreeRecordSelection|Tree view RecordSelection mode]].
| 若开启此项,将显示代码行号。
|-
|-
| {{MenuCommand|Tab size}}
| {{MenuCommand|Add checkboxes for selection in document tree}}
| Each [[Tree_view|Tree view]] item will get a checkbox. This is for example useful for selecting multiple items on a touchscreen.
| 指定一个tab符占多少空格位置。若将此值设置为'6',则多次按下{{KEY|Tab}}键后,将根据当前光标位置,依次跳至其后的第7个字符、第13个字符或第19个字符等处。只有在选中{{MenuCommand|Keep tabs}}后,本选项才可生效。
|}

[[Image:Preferences_General_Tab_Selection.png]]

===Cache===

These preferences are related to the cache directory where FreeCAD stores temporary files.

On the ''Cache'' tab ({{Version|0.20}}) you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Indent size}}
| {{MenuCommand|Location}}
| Specifies the path of the cache directory.
| 指定在按下{{KEY|Tab}}键后将会插入多少个空格。只有在选中{{MenuCommand|Insert spaces}}后,本选项才会生效。
|-
|-
| {{MenuCommand|Keep tabs}}
| {{MenuCommand|Check periodically at program start}}
| Controls the frequency with which the directory size is checked. The options are:
| 如果选择本项,则按下{{KEY|Tab}}键将插入占空为{{MenuCommand|Tab size}}的tab符。
* '''Always'''
* '''Daily'''
* '''Weekly'''
* '''Monthly'''
* '''Yearly'''
* '''Never'''
|-
|-
| {{MenuCommand|Insert spaces}}
| {{MenuCommand|Cache size limit}}
| Specifies the maximum size of the directory. You will be notified if a check is performed and the size exceeds this value. The options are:
| 如果选择本项,则按下{{KEY|Tab}}键将插入数量为{{MenuCommand|Indent size}}的空格符。
* '''100 MB'''
* '''300 MB'''
* '''500 MB'''
* '''1 GB'''
* '''2 GB'''
* '''3 GB'''
|-
| {{MenuCommand|Current cache size}}
| Shows the current size of the directory, if available. Press the {{Button|Check now...}} button to update the value.
|}
|}


[[Image:Preference_General_Tab_03.png]]
[[Image:Preferences_General_Tab_Cache.png]]


===Output window===
===Notification Area===


The output preferences affect the behavior of the [[Report view|Report view]].
These preferences control the Notification Area and its notifications.

On the ''Notification Area'' tab ({{Version|0.21}}) you can specify the following:


In the ''Output'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Record log messages}}
| {{MenuCommand|Enable Notification Area}}
| If checked, the Notification Area will appear in the status bar.
| If checked, also log messages will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Log messages}}. This panel is shown using the menu {{MenuCommand|View → Panels → Report view}}.
|-
|-
| {{MenuCommand|Record warnings}}
| {{MenuCommand|Enable non-intrusive notifications}}
| If checked, warnings will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Warnings}}.
| If checked, non-intrusive notifications will appear next to the Notification Area in the status bar.
|-
|-
| {{MenuCommand|Record error messages}}
| {{MenuCommand|Errors}}
| If checked, error messages will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Errors}}
| If checked, errors will appear in the Notification Area.
|-
|-
| {{MenuCommand|Show report view on error or warning}}
| {{MenuCommand|Warnings}}
| If checked, report view panel will show up automatically as soon as an error or warning is logged.
| If checked, warnings will appear in the Notification Area.
|-
|-
| {{MenuCommand|Normal messages}}
| {{MenuCommand|Maximum Duration}}
| Maximum duration during which notifications are shown (unless mouse buttons are clicked).
| Specification of the font color for normal messages in the Report view panel.
|-
|-
| {{MenuCommand|Log messages}}
| {{MenuCommand|Minimum Duration}}
| Minimum duration (idem).
| Specification of the font color for log messages in the Report view panel.
|-
|-
| {{MenuCommand|Warnings}}
| {{MenuCommand|Maximum Number of Notifications}}
| Maximum number of notifications shown simultaneously.
| Specification of the font color for warning messages in the Report view panel.
|-
|-
| {{MenuCommand|Errors}}
| {{MenuCommand|Notification width}}
| Width of the Notification Area in pixels.
| Specification of the font color for error messages in the Report view panel.
|-
| {{MenuCommand|Hide when other window is activated}}
| If checked, open notifications will disappear when another window is activated.
|-
| {{MenuCommand|Do not show when inactive}}
| If checked, notifications will not appear if the FreeCAD window is not the active window.
|-
|-
| {{MenuCommand|Redirect internal Python output to report view}}
| {{MenuCommand|Maximum Messages (0 &#61; no limit)}}
| The maximum number of messages kept in the list. Set to 0 for no limit.
| If checked, internal Python output will be redirected from the Python console to the Report view panel. The Python console is shown using the menu {{MenuCommand|View → Panels → Python console}}
|-
|-
| {{MenuCommand|Redirect internal Python errors to report view}}
| {{MenuCommand|Auto-remove User Notifications}}
| If checked, internal Python error messages will be redirected from the Python console to the Report view panel.
| If checked, notifications will be removed from the message list when the '''Maximum Duration''' has elapsed.
|}
|}


[[Image:Preference_General_Tab_04.png]]
[[Image:Preferences_General_Tab_Notification_Area.png]]


===Macro===
===Report view===


These preferences control the behavior of the [[Report_view|Report view]]. This panel can be opened using the {{MenuCommand|View → Panels → Report view}} menu option.
These options control certain aspects of running [[macros|macros]].


In the ''Macro'' tab you can specify the following:
On the ''Report view'' tab you can specify the following:

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|名称
!style="width: 66%;"|Description
!style="width: 66%;"|描述
|-
|-
| {{MenuCommand|Run macros in local environment}}
| {{MenuCommand|Record normal messages}}
| If checked, normal messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|正常的消息}}.
| If checked, variables defined by macros are created as local variables, otherwise as global Python variable
|-
|-
| {{MenuCommand|Macro path}}
| {{MenuCommand|记录日志}}
| If checked, log messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|日志信息}}.
| Specification of a path to macro files
|-
|-
| {{MenuCommand|Recording GUI commands}}
| {{MenuCommand|记录警告}}
| If checked, warnings will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|警告}}.
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands
|-
|-
| {{MenuCommand|Record as comment}}
| {{MenuCommand|记录错误}}
| If checked, error messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|错误}}.
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands but as comments. This is useful if you don't want to execute visible actions when running the macro but to see what could be done visibly.
|-
|-
| {{MenuCommand|Show script commands in python console}}
| {{MenuCommand|错误时显示报表视图}}
| If checked, the [[Report_view|Report view]] will be shown automatically when an error is recorded
| If checked, the commands executed by the macro scripts are shown in the Python console. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|-
| {{MenuCommand|在警告时显示报告视图}}
| If checked, the [[Report_view|Report view]] will be shown automatically when a warning is recorded
|-
| {{MenuCommand|Show report view on normal message}}
| If checked, the [[Report_view|Report view]] will be shown automatically when a normal message is recorded
|-
| {{MenuCommand|在日志消息中显示报告视图}}
| If checked, the [[Report_view|Report view]] will be shown automatically when a log message is recorded
|-
| {{MenuCommand|Include a timecode for each entry}}
| If checked, each message and warning will receive a timecode
|-
| {{MenuCommand|正常的消息}}
| Specification of the font color for normal messages
|-
| {{MenuCommand|日志信息}}
| Specification of the font color for log messages
|-
| {{MenuCommand|警告}}
| Specification of the font color for warning messages
|-
| {{MenuCommand|错误}}
| Specification of the font color for error messages
</div>

<div class="mw-translate-fuzzy">
|-
| {{MenuCommand|将 Python 内部输出重定向到报告视图}}
| If checked, internal Python output will be redirected from the [[Python_console|Python console]] to the [[Report_view|Report view]]
|-
| {{MenuCommand|将 Python 内部错误重定向到报告视图}}
| If checked, internal Python error messages will be redirected from the [[Python_console|Python console]] to the [[Report_view|Report view]]
|}
|}
</div>


[[Image:Preference_General_Tab_05.png]]
[[Image:Preferences_General_Tab_Report_view.png]]


===Units===
===Help===


On the ''Help'' tab you can specify the following:
This tab configures how [[Units|Units]] are shown.


In the ''Units'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|User system}}
| {{MenuCommand|Help location}}
| Specifies the location of the Help files. The options are:
| Selection of a unit system that should be used for all parts of FreeCAD
* {{MenuCommand|Online}}: Enter the URL or leave blank to use the automatic [https://github.com/FreeCAD/FreeCAD-documentation/tree/main/wiki GitHub URL].
: {{MenuCommand|Translation suffix}}: If {{Value|https://wiki.freecad.org/}} is used, a [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes language suffix] can be specified. Use for example {{Value|fr}} for the French translation. Must be blank for the GitHub URL.
* {{MenuCommand|From disk location}}: Enter the path where the downloaded FreeCAD documentation can be found. To download the documentation select the ''offline-documentation'' addon from the Workbenches list in the [[Std_AddonMgr|Addon Manager]].
|-
|-
| {{MenuCommand|Number of decimals}}
| {{MenuCommand|Display}}
| Specifies where the documentation should be displayed. The options are:
| The number of decimals that should be shown for numbers and dimensions in FreeCAD
* {{MenuCommand|In a new FreeCAD tab}}: The documentation is displayed on a new tab in the [[Main_view_area|Main view area]].
* {{MenuCommand|In your default web browser}}: The documentation is displayed in the default web browser.
* {{MenuCommand|In a separate, embeddable, dialog}}: The documentation is displayed in a separate dialog. This dialog can be docked on top of the [[Combo_view|Combo view]] for example.
|-
|-
| {{MenuCommand|Minimum fractional inch}}
| {{MenuCommand|Custom stylesheet}}
| Specifies an optional custom stylesheet. Not used for the Wiki URL.
| Minimum fractional inch that should be displayed. This setting is only available if the unit system '''Building US (ft-in/sqft/cuft)''' is used.
|}
|}


[[Image:Preference_General_Tab_06.png]]
[[Image:Preferences_General_Tab_Help.png]]


==Display settings==
==Display==


This preferences section has two general tabs, 3D View and Colors, and further tabs depending in the used workbenches.
This preferences section has three standard tabs: 3D View, Navigation and Colors. A fourth tab, Mesh view, is added if the [[Mesh_Workbench|Mesh Workbench]] has been loaded.


<span id="3D_View"></span>
===3D View===
===三维视图===


On the ''3D View'' tab you can specify the following:
This tab is always available, and controls certain characteristics of the [[3D view|3D view]].


In the ''3D View'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
Line 293: Line 374:
|-
|-
| {{MenuCommand|Show coordinate system in the corner}}
| {{MenuCommand|Show coordinate system in the corner}}
| If checked, the main coordinate system will always be shown at the lower right in opened files
| If checked, the main coordinate system will be shown in the lower right corner of the [[3D_view|3D view]].
The {{MenuCommand|Relative size}} ({{Version|0.20}}) defines the size of the representation as a percentage of the view size (the minimum of its height and width).
|-
| {{MenuCommand|Show axis cross by default}}
| If checked, the axis cross will be shown by default in the [[3D_view|3D view]].
|-
|-
| {{MenuCommand|Show counter of frames per second}}
| {{MenuCommand|Show counter of frames per second}}
| If checked, the time needed for the last operation and the resulting [https://en.wikipedia.org/wiki/Frame_rate frame rate] will always be shown at the lower left in opened files
| If checked, the time needed for the last operation and the resulting [https://en.wikipedia.org/wiki/Frame_rate frame rate] will be shown in the lower left corner of the [[3D_view|3D view]].
|-
|-
| {{MenuCommand|Show navigation cube}}
| {{MenuCommand|Use software OpenGL}}
| If checked, [https://en.wikipedia.org/wiki/OpenGL OpenGL] will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application.
| If checked, the [[Navigation_Cube|navigation cube]] will always be shown at the selected {{MenuCommand|Corner}} in opened files
|-
|-
| {{MenuCommand|Use OpenGL Vertex Buffer Object}}
| {{MenuCommand|Use OpenGL VBO (Vertex Buffer Object)}}
| If checked, [https://en.wikipedia.org/wiki/Vertex_Buffer_Object Vertex Buffer Objects] (VBO) will be used. A VBO is an [https://en.wikipedia.org/wiki/OpenGL OpenGL] feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by GPU. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects this webpage].
| If checked, [https://en.wikipedia.org/wiki/Vertex_Buffer_Object Vertex Buffer Objects] (VBO) will be used. A VBO is an [https://en.wikipedia.org/wiki/OpenGL OpenGL] feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects Understanding OpenGL Objects].
|-
|-
| {{MenuCommand|Render Cache}} {{Version|0.19}}
| {{MenuCommand|Render Cache}}
| "Render Cache" or "Render Acceleration" is explained in more detail in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link#render-caching Link#render-caching]. There are 3 options:
| "Render Cache" or "Render Acceleration" is explained in more detail in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link#render-caching FreeCAD assembly3 render-caching]. The options are:
* '''Auto''' (default), let Coin3D decide where to cache.
* '''Auto''': Let Coin3D decide where to cache (default).
* '''Distributed''', manually turn on cache for all view provider root nodes.
* '''Distributed''': Manually turn on cache for all view provider root nodes.
* '''Centralized''', manually turn off cache in all nodes of all view providers, and only cache at the scene graph root node. This offers the fastest rendering speed, but slower response to any scene changes.
* '''Centralized''': Manually turn off cache in all nodes of all view providers, and only cache at the scene graph root node. This offers the fastest rendering speed, but slower response to any scene changes.
|-
|-
| {{MenuCommand|Enable animation}}
| {{MenuCommand|Anti-Aliasing}}
| Specifies if and what type of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used
| If checked, rotations can be animated. If for example the {{MenuCommand|3D Navigation}} set ''CAD'' is used and the mouse is moved while the scroll wheel and the right mouse button is pressed, parts are rotated. If one keeps the mouse moving while releasing e.g. the right mouse button, the rotation will continue as animation. To end the animation left-click with the mouse.
|-
|-
| {{MenuCommand|3D Navigation}}
| {{MenuCommand|Transparent objects}}
| Specifies the render type of transparent objects. The options are:
| Selection of a navigation settings set. To see what each set defines, select a set and press the button {{Button|Mouse...}}.
* '''One pass''': Rendering is done in one pass (default). This can lead to triangular artifacts. If these occur the type '''Backface pass''' can be used to avoid them.
* '''Backface pass''': Rendering is done in two passes. Back-facing polygons are rendered in the first pass and front-facing polygons in the second pass.
|-
|-
| {{MenuCommand|Orbit style}}
| {{MenuCommand|Marker size}}
| Specifies the size of [[Glossary#Vertex|vertices]] (points) in the [[Sketcher_Workbench|Sketcher Workbench]]. The clickable area of points can be additionally enlarged by increasing the {{MenuCommand|Pick radius}}.
| Selection of the rotation orbit style. When viewing a part in the x-y plane an being in the rotation mode of the 3D navigation, the difference is: If '''Trackball''' is selected, moving the mouse horizontally will rotate the part around the y-axis, if '''Turntable''' is selected the part will be rotated around the z-axis.
|-
|-
| {{MenuCommand|Anti-Aliasing}}
| {{MenuCommand|Pick radius (px)}}
| Sets the area for picking elements in the [[3D_view|3D view]]. Larger value makes it easier to pick things, but can make some small features impossible to select.
| Selection if and what kind of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used
|-
|-
| {{MenuCommand|New Document Camera Orientation}}
| {{MenuCommand|Eye to eye distance for stereo modes}}
| Specifies the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the [[Property_editor#View|bounding box]] size of the 3D object that is currently displayed.
| Selection of the camera orientation for new documents
|-
|-
| {{MenuCommand|New Document Scale}}
| {{MenuCommand|Backlight color}}
| If checked, backlight is enabled with the defined color. Backlight is used for rendering the back sides of faces. Usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly. It is only used for objects whose Lighting property (on the View tab) is set to '''One side'''. If disabled, the back side of the faces of those objects will be black.
| Affects the initial "zoom level" of camera for new documents. The value you set is the diameter of a sphere that fits in 3D view. Default is 100 mm, convenient for objects like boxes for Arduino. It also sets initial size of origin features (base planes in a new PartDesign Body).
The related {{MenuCommand|Intensity}} setting specifies the intensity of the backlight.
|-
|-
| {{MenuCommand|Zoom at cursor}}
| {{MenuCommand|Camera type}}
| Specifies the camera projection type. The options are:
| If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise zoom operations will be performed at the center of the current view. The {{MenuCommand|Zoom step}} defines how much will be zoomed. A zoom step of '1' means a factor of 7.5 for every zoom step.
* '''Perspective rendering''': Objects will appear in a [https://en.wikipedia.org/wiki/Perspective_projection perspective projection].
* '''Orthographic rendering''': Objects will be appear in an [https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].
|}

[[Image:Preferences_Display_Tab_3D_View.png]]

<span id="Navigation"></span>
===导航栏===

On the ''Navigation'' tab you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Invert zoom}}
| {{MenuCommand|Navigation cube}}
| If checked, the direction of zoom operations will be inverted.
| If checked, the [[Navigation_Cube|Navigation cube]] will be shown in the [[3D_view|3D view]].

{{MenuCommand|Steps by turn}} defines the number of steps required for a full rotation when using the Navigation cube rotation arrows.

If {{MenuCommand|Rotate to nearest}} is checked, the 3D view is rotated to the nearest most logical position, based on the current orientation of the cube, when a cube face is clicked. Else clicking a face will always result in the same rotation. {{Version|0.20}}

{{MenuCommand|Cube size}} defines the size of the cube. {{Version|0.20}}

{{MenuCommand|Color}} sets the base color for all elements. {{Version|0.21}}

{{MenuCommand|Corner}} defines where the Navigation cube is displayed in the [[3D_view|3D view]]. The options are:
* '''Top left'''
* '''Top right'''
* '''Bottom left'''
* '''Bottom right'''

{{MenuCommand|Font name}} specifies the font used for the cube's texts. {{Version|0.21}}

{{MenuCommand|Font size}} sets the size of the font used for the cube's texts. {{Version|0.21}}

|-
|-
| {{MenuCommand|Disable touchscreen tilt gesture}}
| {{MenuCommand|3D Navigation}}
| Specifies a [[Mouse_navigation|mouse navigation style]]. To see the details of each style, select it and then press the {{Button|Mouse...}} button.
| If checked, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the {{MenuCommand|3D Navigation}} set ''Gesture''.
|-
|-
| {{MenuCommand|Drag at cursor}}
| {{MenuCommand|Orbit style}}
| Specifies the rotation orbit style used when in rotation mode. The options are:
| If checked, rotations in 3D will use the current cursor position as center for the rotation. Otherwise always the center of the screen will be used.
* '''Turntable''': Moving the mouse will divide the rotation in steps, rotations around the different axes are performed sequentially.
* '''Trackball''': Rotations around the different axes are performed simultaneously.
* '''Free Turntable''': Like '''Trackball''', but if possible the rotation axis is kept collinear with the global 3D view axis. {{Version|0.21}}
|-
|-
| {{MenuCommand|Marker size}}
| {{MenuCommand|Rotation mode}}
| Defines the rotation center. The options are:
| Selection of the size of [[Glossary#Vertex|vertices]] (points) in the [[Sketcher_Workbench|Sketcher workbench]]. The clickable area of points can be additionally enlarged by increasing {{MenuCommand|Pick radius}} (on Colors tab).
* '''Window center'''
* '''Drag at cursor'''
* '''Object center'''
|-
|-
| {{MenuCommand|Eye to eye distance for stereo modes}}
| {{MenuCommand|Default camera orientation}}
| Specifies the camera orientation for new documents. This setting is also used by the [[Std_ViewHome|Std ViewHome]] command.
| Specification of the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the [[Property_editor#View|bounding box]] size of the 3D object that is currently displayed.
|-
|-
| {{MenuCommand|Enable backlight color}}
| {{MenuCommand|Camera zoom}}
| Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in [[3D_view|3D view]]. The default is 100 mm. It also sets the initial size of origin features (base planes in new [[PartDesign_Body|PartDesign Bodies]] and [[Std_Part|Std Parts]]).
| If checked, backlight is enabled with the defined color. Backlight is used for rendering back sides of faces (usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly). It is only active for objects whose Lighting property (on View tab) is set to "One side". If disabled, back sides of faces of objects in "One side" lighting mode will be black.
|-
|-
| {{MenuCommand|Intensity of backlight}}
| {{MenuCommand|Enable animation}}
| If checked, and {{MenuCommand|3D Navigation}} is set to '''CAD''', rotations can be animated. If the mouse is moved while the scroll wheel and the right mouse button are pressed, the view is rotated. If one keeps the mouse moving while releasing the right mouse button, the rotation will continue. To end this animation left-click with the mouse.
| Specification of the intensity of the backlight. This setting is only enabled if {{MenuCommand|Enable backlight color}} is checked.
|-
|-
| {{MenuCommand|Camera type}}
| {{MenuCommand|Zoom at cursor}}
| If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise zoom operations will be performed at the center of the current view. The {{MenuCommand|Zoom step}} defines how much will be zoomed. A zoom step of '''1''' means a factor of 7.5 for every zoom step.
| Selection of the camera projection type.
|-

| {{MenuCommand|Invert zoom}}
* '''Perspective rendering''', objects will appear in a [https://en.wikipedia.org/wiki/Perspective_projection perspective projection].
| If checked, the direction of zoom operations will be inverted.
* '''Orthographic rendering''', objects will be projected in [https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].
|-
| {{MenuCommand|Disable touchscreen tilt gesture}}
| If checked, and {{MenuCommand|3D Navigation}} is set to '''Gesture''', the tilting gesture will be disabled for pinch-zooming (two-finger zooming).
|-
| {{MenuCommand|Enable rotation center indication}}
| If checked, the rotation center of the view is shown when dragging. {{Version|1.0}}
|}
|}


[[Image:Preference_Display_Tab_01.png]]
[[Image:Preferences_Display_Tab_Navigation.png]]


===Colors===
<span id="Colors"></span>
===颜色===


On the ''Colors'' tab you can specify the following:
This tab is always available.


In the ''Colors'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
Line 371: Line 504:
|-
|-
| {{MenuCommand|Enable preselection highlighting}}
| {{MenuCommand|Enable preselection highlighting}}
| If checked, preselection is turned on and will be highlighted by the specified color. Preselection means that for example edges in parts will be highlighted while hovering with the mouse over them to indicate that they can be selected.
| If checked, preselection is turned on and the specified color will be used for it. Preselection means that for example edges of objects will be highlighted while hovering over them with the mouse to indicate they can be selected.
|-
|-
| {{MenuCommand|Enable selection highlighting}}
| {{MenuCommand|Enable selection highlighting}}
| If checked, selection highlighting is turned on and the specified color will be used for it
| If checked, selection highlighting is turned on and the specified color will be used for it.
|-
| {{MenuCommand|Pick radius}}
| Sets the area for picking elements in 3D view. Larger value makes it easier to pick things, but can make some small features impossible to select.
|-
|-
| {{MenuCommand|Simple color}}
| {{MenuCommand|Simple color}}
| If selected, the background for parts will have the selected color
| If selected, the background of the [[3D_view|3D view]] will have the specified color.
|-
|-
| {{MenuCommand|Color gradient}}
| {{MenuCommand|Linear gradient}}
| If selected, the background of the [[3D_view|3D view]] will have a vertical color gradient defined by the specified '''Top''' and '''Bottom''' colors. if enabled, a '''Middle''' color can also be specified. Press the {{Button|[[Image:Button_sort.svg|16px]]}} button ({{Version|0.21}}) to switch the top and bottom colors.
| If selected, the background for parts will have the selected color gradient
|-
|-
| {{MenuCommand|Middle color}}
| {{MenuCommand|Radial gradient}} {{Version|0.21}}
| If selected, the background of the [[3D_view|3D view]] will have a radial color gradient defined by the specified '''Central''' and '''End''' colors. if enabled, a '''Midway''' color can also be specified. Press the {{Button|[[Image:Button_sort.svg|16px]]}} button to switch the central and end colors.
| Is only enabled if {{MenuCommand|Color gradient}} is selected. If checked, the color gradient will get the selected color as middle color.
|-
|-
| {{MenuCommand|Object being edited}}
| {{MenuCommand|Object being edited}}
| Selection of the background color for objects in the tree view that are currently edited
| Specifies the background color for objects in the tree view that are currently edited.
|-
|-
| {{MenuCommand|Active container}}
| {{MenuCommand|Active container}}
| Selection of the background color for active containers in the tree view. For example if there are several parts in the tree view and one part is toggled as [[PartDesign_Body#Active_Status|active body]], it will get the selected background color in the tree view.
| Specifies the background color for active containers in the tree view. For example an [[PartDesign_Body#Active_Status|active PartDesign Body]] will get this color.
|}
|}


[[Image:Preference_Display_Tab_02.png]]
[[Image:Preferences_Display_Tab_Colors.png]]


<span id="Mesh_view"></span>
===Part colors===
===网格视图===


This tab is only shown if you are in the [[Part_Module|Part]] or [[PartDesign_Workbench|PartDesign Workbench]] or if you have been in these workbenches before.
This tab is only available if the [[Mesh_Workbench|Mesh Workbench]] has been loaded.

On the ''Mesh view'' tab you can specify the following:


In the ''Part colors'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Default shape color}}
| {{MenuCommand|Default mesh color}}
| Specifies the default face color.
| Selection of the default color for new shapes. If the option {{MenuCommand|Random shape color}} is set, a random color is used instead.
|-
|-
| {{MenuCommand|Default line color}}
| {{MenuCommand|Default line color}}
| Selection of the default line color for new shapes
| Specifies the default line color.
|-
|-
| {{MenuCommand|Default line width}}
| {{MenuCommand|Mesh transparency}}
| Specification of the default line thickness for new shapes
| Specifies the default mesh transparency.
|-
|-
| {{MenuCommand|Default vertex color}}
| {{MenuCommand|Line transparency}}
| Specifies the default line transparency.
| Selection of the default color for new [[Glossary#Vertex|vertices]]
|-
|-
| {{MenuCommand|Default vertex size}}
| {{MenuCommand|Two-side rendering}}
| If checked, the default value for the {{PropertyView|Lighting}} property is {{value|Two side}} instead of {{value|One side}}. {{value|Two side}} means the color of the interior side of faces is the same as the color of the exterior side. {{value|One side}} means their color is either the [[#3D_View|backlight color]], if enabled, or black.
| Specification of the default size for new [[Glossary#Vertex|vertices]]
|-
|-
| {{MenuCommand|Bounding box color}}
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
| If checked, the default value for the {{PropertyView|Selection Style}} property is {{value|BoundBox}} instead of {{value|Shape}}. {{value|BoundBox}} means a highlighted bounding box is displayed if meshes are highlighted or selected. {{value|Shape}} means the shape itself is then highlighted.
| Selection of the color of [[Property_editor#View|bounding boxes]] in the 3D view
|-
|-
| {{MenuCommand|Default text color}}
| {{MenuCommand|Define normal per vertex}}
| If checked, [https://en.wikipedia.org/wiki/Phong_shading Phong shading] is used, otherwise flat shading. Shading defines the appearance of surfaces. With flat shading the surface normals are not defined per vertex. This leads to an unrealistic appearance for curved surfaces. While Phong shading leads to a more realistic, smoother appearance.
| Selection of the default text color for document annotations. There is currently no dialog to add annotations to documents. Annotations can only be added using the Python console with this command:
|-
| {{MenuCommand|Crease angle}}
| The crease angle is a threshold angle between two faces. It can only be set if the option {{MenuCommand|Define normal per vertex}} is used.
:If face angle ≥ crease angle, facet shading is used.
:If face angle < crease angle, smooth shading is used.
|}


[[Image:Preferences_Display_Tab_Mesh_view.png]]
<code>obj=App.ActiveDocument.addObject("App::Annotation", "Label")</code>


==Workbenches==
This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.

This preferences section has a single tab: Available Workbenches.

===Available Workbenches===

These preferences control workbench loading.

On the ''Available Workbenches'' tab you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Workbench list}}
| The list displays all installed workbenches. The list can be reordered by drag and drop ({{Version|0.21}}) and sorted by right-clicking the list and selecting {{MenuCommand|Sort alphabetically}} ({{Version|1.0}}). The order of the list also determines the order of the [[Std_Workbench|Workbench selector]].
* {{Version|0.21}}: {{MenuCommand|First checkbox in each row}}: If checked, the workbench will be available in the Workbench selector in the next FreeCAD session. The start up workbench cannot be unchecked. Unchecked workbenches are moved to the bottom of the list.
* {{MenuCommand|Auto-load}}: If checked, the workbench will auto-load when FreeCAD starts. Loading more workbenches will make the start up slower, but switching between workbenches that have already been loaded is faster.
* {{Button|Load}}: Press this button to load the workbench in the current FreeCAD session.
|-
| {{MenuCommand|Start up workbench}}
| The workbench that is activated when FreeCAD starts.
|-
| {{MenuCommand|Workbench selector position}} {{Version|0.21}}
| Defines where the [[Std_Workbench|Workbench selector]] appears. The options are:
* '''Toolbar''': In a dedicated toolbar.
* '''Left corner''': In the left corner of the menubar.
* '''Right corner''': In the right corner of the menubar.
|-
| {{MenuCommand|Remember active workbench by tab}}
| If checked, FreeCAD will remember and restore the workbench that was active for each tab in the [[Main_view_area|Main view area]].
|}
|}


[[Image:Preference_Display_Tab_03.png]]
[[Image:Preferences_Workbenches_Tab_Available_Workbenches.png]]

==Python==

This preferences section ({{Version|0.21}}) has three tabs: Macro, Python console and Editor.

<span id="Macro"></span>
===宏===

On the ''Macro'' tab you can specify the following:

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|名称
!style="width: 66%;"|描述
|-
| {{MenuCommand|在本地环境中运行宏}}
| If checked, variables defined by macros are created as local variables, otherwise as global Python variables
|-
| {{MenuCommand|宏路径}}
| Specification of the path for macro files
|-
| {{MenuCommand|录制图形用户界面命令}}
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands
|-
| {{MenuCommand|录制为注释}}
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands, but as comments. This is useful if you don't want to execute these commands when running the macro, but do want to see what has been done while recording.
|-
| {{MenuCommand|在Python控制台显示脚本}}
| If checked, the commands executed by macro scripts are shown in the Python console. This console is shown using the {{MenuCommand|View → Panels → Python console}} menu option.
|-
| {{MenuCommand|Size of recent macros list}}
| Controls the number of recent macros to display in the menu
|-
| {{MenuCommand|快捷方式计数}}
| Controls the number of recent macros that get dynamically assigned shortcuts
|-
| {{MenuCommand|键盘编辑器}}
| Controls which keyboard modifiers are used for the shortcuts, example '''Ctrl+Shift+''' creates shortcuts in the form of '''Ctrl+Shift+1''', '''Ctrl+Shift+2''', etc.
|}
</div>

[[Image:Preferences_Python_Tab_Macro.png]]

===Python console===

These preferences control the behavior of the [[Python_console|Python console]]. This console can be opened using the {{MenuCommand|View → Panels → Python console}} menu option.


Note that the color and font settings for the console are defined on the [[#Editor|Editor]] tab.
===Mesh view===


On the ''Python console'' tab ({{Version|0.20}}) you can specify the following:
This tab is only shown if you are in the [[Mesh_Workbench|Mesh Workbench]] or if you have been in this workbench before.


In the ''Mesh view'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Default mesh color}}
| {{MenuCommand|Enable word wrap}}
| If checked, words will be wrapped if they exceed the available horizontal space in the console.
| Selection of the default color for new meshes
|-
|-
| {{MenuCommand|Default line color}}
| {{MenuCommand|Enable block cursor}}
| Selection of the default line color for new meshes
| If checked, the cursor will have a block shape.
|-
|-
| {{MenuCommand|Mesh transparency}}
| {{MenuCommand|Save history}}
| If checked, Python history is saved across sessions.
| Specification of the default mesh transparency for new meshes
|}

[[Image:Preferences_Python_Tab_Python_console.png]]

<span id="Editor"></span>
===编辑器===

<div class="mw-translate-fuzzy">
编辑器首选项设置影响的是宏编辑器的行为。此编辑器可通过{{MenuCommand|Macro → Macros... → Edit/Create}}菜单打开。<br/>'''请注意:''' 这里的颜色和字体设置也会影响到[https://en.wikipedia.org/wiki/Python_(programming_language) Python]控制台。此控制台可通过{{MenuCommand|View → Panels → Python console}}菜单打开。
</div>

The color and font settings are also used by the [[#Python_console|Python console]].

在''Editor''选项卡中,您可以指定以下内容:

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|名称
!style="width 66%;"|描述
|-
|-
| {{MenuCommand|Line transparency}}
| {{MenuCommand|Display Items}}
| 选择代码类型。此处的颜色与字体设置将应用于所选的代码类型。可以从'''Preview'''框中预览效果。
| Specification of the default line transparency for new meshes
|-
|-
| {{MenuCommand|Two-side rendering}}
| {{MenuCommand|字体族}}
| 指定应用于所选代码类型的字体系列(font family)。
| If checked, the bottom side of the surface will be rendered the same way than the top side. If not checked, it depends on the option {{MenuCommand|Enable backlight color}} (see section [[Preferences_Editor#3D_View|3D view]]). Either the backlight color will be used or black.
|-
|-
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
| {{MenuCommand|大小}}
| 指定应用于所选代码类型的字体大小。
| If checked, a yellow bounding box will be displayed for highlighted or selected meshes.
|-
|-
| {{MenuCommand|Define normal per vertex}}
| {{MenuCommand|启用行号}}
| 若开启此项,将显示代码行号。
| If checked, [https://en.wikipedia.org/wiki/Phong_shading Phong shading] is used, otherwise flat shading. Shading defines the appearance of surfaces.
With flat shading the surface normals are not defined per vertex that leads to a unreal appearance for curved surfaces while using Phong shading leads to a smoother appearance.
|-
|-
| {{MenuCommand|Crease angle}}
| {{MenuCommand|制表符长度}}
| 指定一个tab符占多少空格位置。若将此值设置为'6',则多次按下{{KEY|Tab}}键后,将根据当前光标位置,依次跳至其后的第7个字符、第13个字符或第19个字符等处。只有在选中{{MenuCommand|保留制表符}}后,本选项才可生效。
| The crease angle is a threshold angle between two faces. It can only be set if the option {{MenuCommand|Define normal per vertex}} is used.
|-
:If face angle ≥ crease angle, facet shading is used
| {{MenuCommand|缩进大小}}
:If face angle < crease angle, smooth shading is used
| 指定在按下{{KEY|Tab}}键后将会插入多少个空格。只有在选中{{MenuCommand|插入空格}}后,本选项才会生效。
|-
| {{MenuCommand|保留制表符}}
| 如果选择本项,则按下{{KEY|Tab}}键将插入占空为{{MenuCommand|制表符长度}}的tab符。
|-
| {{MenuCommand|插入空格}}
| 如果选择本项,则按下{{KEY|Tab}}键将插入数量为{{MenuCommand|缩进大小}}的空格符。
|}
|}
</div>


[[Image:Mesh View Preferences.png]]
[[Image:Preferences_Python_Tab_Editor.png]]


==Addon Manager==
==Import-Export Settings==


This preferences section has a single tab: Addon manager options.
The Import-Export settings affect how files are imported and exported to and from FreeCAD. They are described in the page [[Import Export Preference|Import Export Preference]].


===Addon manager options===

These preferences control the behavior of the [[Std AddonMgr|Addon manager]].

On the ''Addon manager options'' tab ({{Version|0.20}}) you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Automatically check for updates at start (requires git)}}
| If checked, the Addon manager will check for updates when it is launched. Git must be installed for this to work.
|-
| {{MenuCommand|Download Macro metadata (approximately 10MB)}}
| If checked, macro metadata is downloaded for display in the Addon manager's main addon listing. This data is cached locally.
|-
| {{MenuCommand|Cache update frequency}}
| Controls the frequency with which the locally cached addon availability and metadata information is updated. The options are:
* '''Manual (no automatic updates)'''
* '''Daily'''
* '''Weekly'''
|-
| {{MenuCommand|Hide Addons marked Python 2 Only}}
| If checked, addons marked as "Python 2 Only" are not included in the listing. These addons are unlikely to work in the current FreeCAD version.
|-
| {{MenuCommand|Hide Addons marked Obsolete}}
| If checked, addons marked as "Obsolete" are not included in the listing.
|-
| {{MenuCommand|Hide Addons that require a newer version of FreeCAD}}
| If checked, addons that require a newer FreeCAD version are not included in the listing.
|-
| {{MenuCommand|Custom repositories}}
| Custom repositories can be specified here.

To add a repository press the {{Button|[[Image:List-add.svg|16px]]}} button. Both the {{MenuCommand|Repository URL}} and the {{MenuCommand|Branch}}, typically {{Value|master}} or {{Value|main}}, must be specifies in the dialog that opens. {{Version|0.21}}

To remove a repository select it in the list and press the {{Button|[[Image:List-remove.svg|16px]]}} button. {{Version|0.21}}
|-
| {{MenuCommand|Proxy}}
| The Addon manager includes experimental support for proxies requiring authentication, set up as user-defined proxies.
|-
| {{MenuCommand|Python executable (optional)}}
| The Addon manager attempts to determine the Python executable that should be used for the automatic pip-based installation of Python dependencies. To override this selection, the path to the executable can be set here.
|-
| {{MenuCommand|git executable (optional)}}
| The Addon manager attempts to determine the git executable. To override this selection, the path to the executable can be set here. {{Version|0.21}}
|-
| {{MenuCommand|Show option to change branches (requires git)}}
| If checked, the Addon manager provides an interface on the addon's details screen that allows switching which git branch is currently checked out. This is intended for advanced users only, as it is possible that a non-primary-branch version of an addon may result in instability and compatibility issues. Git must be installed for this to work. Use with caution.
|-
| {{MenuCommand|Disable git (fall back to ZIP downloads only)}}
| If checked, git downloads are disabled. {{Version|0.21}}
|-
| {{MenuCommand|Addon developer mode}}
| If checked, Addon manager options intended for developers of addons are activated. {{Version|0.21}}
|}

[[Image:Preferences_Addon_Manager_Tab_Addon_manager_options.png]]

==Import-Export==

The Import-Export preferences affect how files are imported and exported. They are described on the [[Import_Export_Preferences|Import Export Preferences]] page.

<span id="Workbench_related_preferences"></span>
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
==工作台首选项==
==工作台首选项==
Line 482: Line 785:
</div>
</div>


Preferences for the built-in workbenches are linked below. These links are also listed in [[:Category:Preferences]]. Some workbenches have no preferences.

{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each core workbench}}

Preferences for the more common workbenches are linked below.
Some workbenches have no preferences.
Other optional workbenches may not be listed. These links are also listed in [[:Category:Preferences]]


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 493: Line 791:
</div>
</div>


==Scripting==
=== External workbenches ===


{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


For a scripting example see [[Std_DlgParameter|Std DlgParameter]].
{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each [[External Workbenches|External workbench]]}}

==Related==

* [[Std_DlgParameter|Parameter editor]]
* [[Fine-tuning|Fine-tuning]]


<div class="mw-translate-fuzzy">
[[A2plus_Workbench#Preferences|A2plus工作台首选项]]
</div>


{{Docnav
{{Docnav
|[[Interface_Customization|Interface Customization]]
|[[Document structure|Document structure]]
|[[Import Export Preference|Import Export Preference]]
|[[Import_Export_Preferences|Import Export Preferences]]
}}
}}



Latest revision as of 09:25, 21 April 2024

Introduction

FreeCAD的首选项系统位于Edit menu → Preferences

FreeCAD中的功能被分为不同的模块,每个模块负责实现一种特定workbench的具体工作。 FreeCAD采用的是延迟加载方式,意即只有当需要使用特定组件时才会进行加载。您在FreeCAD的工具栏中选择工作台时可能会注意到这一点,因为在加载工作台及其所有组件时需要花费一点儿时间。在进行首选项设置时也是如此。

To preserve resources, FreeCAD does not automatically load all available workbenches. See Workbenches for more information. For a list of workbench related preferences see Workbench related preferences.

在没有加载任何模块时,您可以访问两个配置部分,分别用于应用通用设置(general)与显示设置(display)。当您使用特定的工作台时,便会在新选项卡中显示对应工作台的首选项设置,并在Import-Export新加部分显示该工作台所支持的文件格式。

点击首选项左下角的Reset按钮,即可将FreeCAD中的所有首选项设置还原为其默认值。

Some advanced preferences can only be changed in the Parameter editor. The Fine-tuning page lists some of them.

通用设置

本首选项部分包含6个选项卡:

In version 0.21 and below the seventh tab, Help, is only available if the Help Addon has been installed.

常规

General选项卡中,您可以指定下列内容:

名称 描述
更改语言 选择FreeCAD的用户界面语言
最近文件列表大小 指定有多少最近用过的文件显示在recent files列表中
启用平面背景 如果选中此复选框,则FreeCAD的主窗口背景将默认由以下图片填充:
本选项只有在样式表:/No style sheet被选中时才会生效。
将图片加入到下列路径中的Gui/Images文件夹下即可改变贴图内容
%APPDATA%/FreeCAD (在Windows上),
$HOME/.FreeCAD (在Linux上) or
$HOME/Library/Preferences/FreeCAD (在MacOS上)。
将图片文件命名为background.png,再依次取消/选中本选项来查看效果。

Optionally, imported files can be excluded from this list, and exported files can be included. See Fine-tuning.

Enable tiled background If checked, the background of FreeCAD's main window will by default consist of tiles of this image:

This option only has an effect if no Style sheet is selected.

The image can be changed by adding the folders Gui/Images in the folder:

%APPDATA%/FreeCAD (on Windows),

$HOME/.FreeCAD (on Linux) or

$HOME/Library/Preferences/FreeCAD (on macOS).

Place a file named background.png in the Images folder, and uncheck/check this option to see the changed file.

Enable splash screen at start up If checked, a splash screen is shown when starting FreeCAD.
样式表: 选择样式表。样式表定义了FreeCAD用户界面的外观。
工具栏图标大小 选择工具栏图标的大小。
启动后自动加载模块 选择FreeCAD开启后将直接打开的工作台。
打开软件启动界面 如果选中此项, 则在FreeCAD开启时展示启动画面。
可通过向%APPDATA%/FreeCAD( %APPDATA%是用户在操作系统中为FreeCAD指定的应用文件夹)添加Gui/Images文件夹来修改启动画面。将作为启动画面的图像命名为splash_image.png并重启FreeCAD即可看到效果。
启用自动换行 利用此选项可实现在Python控制台中令超出一行中的文本自动换行。利用View → Panels → Python console菜单来开启Python控制台。

文档

Document选项卡中,您可以指定以下内容:

名称 描述
启动时创建新文档 如果选中此选项,FreeCAD将在启动时创建一个新文档。
Document save compression level 指定FCStd文件的压缩级别。FCStd文件为ZIP压缩文件。因此,您可以将其后缀.FCStd改为.zip,并用ZIP归档程序来打开它们。
在文档上使用撤消/重做 如果选中此选项,所有文档的更改情况将被保存下来,因此即可实现undone/redone。
最大撤消/重做步数 指定可以记录多少次Undo/Redo操作。
在启动时运行自动恢复 如果存在恢复文件,则FreeCAD将在开启时自动运行此文件进行恢复。此法可对程序崩溃时的文件进行恢复。
每次都保存自动恢复信息 指定多久写一次恢复文件。
保存文件时同时保存缩略图到项目文件 如果选中此选项,在保存文档时,也将存储一份项目的缩略图。此缩略图将显示在启动工作台中的最近打开文件列表中。
将程序徽标添加到生成的缩略图 如果选中此选项,则会将FreeCAD程序的logo 添加至缩略图中。此选项仅在开启保存文件时同时保存缩略图到项目文件选项后才会生效。
保存文档时要保留的最大备份文件数 如果选中此选项,在保存文档时也会保留备份文件。您可以指定保留备份文件的数量。这些文件中保存的是此前(previously)的文档版本。第一个备份文件的后缀为 .FCStd1, 第二个后缀为.FCStd2,并以此类推。
在一个文档中允许重复的对象标签 如果选中此选项,则不同的对象可以使用相同的标签/名称。例如,同一文档中的不同零件与features可用相同的名字。
作者姓名 创建的所有文档均采用此指定的作者名。对于匿名作者而言,作者名字的区域为空白内容。若开启了保存时的设置选项,则在保存文件时将Last modified by的内容设置为此作者名。可通过File → Project information菜单来查看该文本域。
公司 将创建的所有文档都指定为此公司名称。
默认许可证 为新文档所指定的默认许可证。对于预定义的许可证而言,许可证网址将自动做出对应的设置。而针对自定义许可证或特殊许可证来讲,可选择'Other(其他)'项。
许可证网址 指定URL来描述默认许可证中所选的许可证。

选择

On the Selection tab you can specify the following:

Name Description
Auto switch to the 3D view containing the selected item Enables the Tree view SyncView mode.
Auto expand tree item when the corresponding object is selected in 3D view Enables the Tree view SyncSelection mode.
Preselect the object in 3D view when mouse over the tree item Enables the Tree view PreSelection mode.
Record selection in tree view in order to go back/forward using navigation button Enables the Tree view RecordSelection mode.
Add checkboxes for selection in document tree Each Tree view item will get a checkbox. This is for example useful for selecting multiple items on a touchscreen.

Cache

These preferences are related to the cache directory where FreeCAD stores temporary files.

On the Cache tab (introduced in version 0.20) you can specify the following:

Name Description
Location Specifies the path of the cache directory.
Check periodically at program start Controls the frequency with which the directory size is checked. The options are:
  • Always
  • Daily
  • Weekly
  • Monthly
  • Yearly
  • Never
Cache size limit Specifies the maximum size of the directory. You will be notified if a check is performed and the size exceeds this value. The options are:
  • 100 MB
  • 300 MB
  • 500 MB
  • 1 GB
  • 2 GB
  • 3 GB
Current cache size Shows the current size of the directory, if available. Press the Check now... button to update the value.

Notification Area

These preferences control the Notification Area and its notifications.

On the Notification Area tab (introduced in version 0.21) you can specify the following:

Name Description
Enable Notification Area If checked, the Notification Area will appear in the status bar.
Enable non-intrusive notifications If checked, non-intrusive notifications will appear next to the Notification Area in the status bar.
Errors If checked, errors will appear in the Notification Area.
Warnings If checked, warnings will appear in the Notification Area.
Maximum Duration Maximum duration during which notifications are shown (unless mouse buttons are clicked).
Minimum Duration Minimum duration (idem).
Maximum Number of Notifications Maximum number of notifications shown simultaneously.
Notification width Width of the Notification Area in pixels.
Hide when other window is activated If checked, open notifications will disappear when another window is activated.
Do not show when inactive If checked, notifications will not appear if the FreeCAD window is not the active window.
Maximum Messages (0 = no limit) The maximum number of messages kept in the list. Set to 0 for no limit.
Auto-remove User Notifications If checked, notifications will be removed from the message list when the Maximum Duration has elapsed.

Report view

These preferences control the behavior of the Report view. This panel can be opened using the View → Panels → Report view menu option.

On the Report view tab you can specify the following:

名称 描述
Record normal messages If checked, normal messages will be recorded. They will be displayed in the Report view with the color set in 正常的消息.
记录日志 If checked, log messages will be recorded. They will be displayed in the Report view with the color set in 日志信息.
记录警告 If checked, warnings will be recorded. They will be displayed in the Report view with the color set in 警告.
记录错误 If checked, error messages will be recorded. They will be displayed in the Report view with the color set in 错误.
错误时显示报表视图 If checked, the Report view will be shown automatically when an error is recorded
在警告时显示报告视图 If checked, the Report view will be shown automatically when a warning is recorded
Show report view on normal message If checked, the Report view will be shown automatically when a normal message is recorded
在日志消息中显示报告视图 If checked, the Report view will be shown automatically when a log message is recorded
Include a timecode for each entry If checked, each message and warning will receive a timecode
正常的消息 Specification of the font color for normal messages
日志信息 Specification of the font color for log messages
警告 Specification of the font color for warning messages
错误 Specification of the font color for error messages
将 Python 内部输出重定向到报告视图 If checked, internal Python output will be redirected from the Python console to the Report view
将 Python 内部错误重定向到报告视图 If checked, internal Python error messages will be redirected from the Python console to the Report view

Help

On the Help tab you can specify the following:

Name Description
Help location Specifies the location of the Help files. The options are:
  • Online: Enter the URL or leave blank to use the automatic GitHub URL.
Translation suffix: If https://wiki.freecad.org/ is used, a language suffix can be specified. Use for example fr for the French translation. Must be blank for the GitHub URL.
  • From disk location: Enter the path where the downloaded FreeCAD documentation can be found. To download the documentation select the offline-documentation addon from the Workbenches list in the Addon Manager.
Display Specifies where the documentation should be displayed. The options are:
  • In a new FreeCAD tab: The documentation is displayed on a new tab in the Main view area.
  • In your default web browser: The documentation is displayed in the default web browser.
  • In a separate, embeddable, dialog: The documentation is displayed in a separate dialog. This dialog can be docked on top of the Combo view for example.
Custom stylesheet Specifies an optional custom stylesheet. Not used for the Wiki URL.

Display

This preferences section has three standard tabs: 3D View, Navigation and Colors. A fourth tab, Mesh view, is added if the Mesh Workbench has been loaded.

三维视图

On the 3D View tab you can specify the following:

Name Description
Show coordinate system in the corner If checked, the main coordinate system will be shown in the lower right corner of the 3D view.

The Relative size (introduced in version 0.20) defines the size of the representation as a percentage of the view size (the minimum of its height and width).

Show axis cross by default If checked, the axis cross will be shown by default in the 3D view.
Show counter of frames per second If checked, the time needed for the last operation and the resulting frame rate will be shown in the lower left corner of the 3D view.
Use software OpenGL If checked, OpenGL will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application.
Use OpenGL VBO (Vertex Buffer Object) If checked, Vertex Buffer Objects (VBO) will be used. A VBO is an OpenGL feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see Understanding OpenGL Objects.
Render Cache "Render Cache" or "Render Acceleration" is explained in more detail in FreeCAD assembly3 render-caching. The options are:
  • Auto: Let Coin3D decide where to cache (default).
  • Distributed: Manually turn on cache for all view provider root nodes.
  • Centralized: Manually turn off cache in all nodes of all view providers, and only cache at the scene graph root node. This offers the fastest rendering speed, but slower response to any scene changes.
Anti-Aliasing Specifies if and what type of multisample anti-aliasing is used
Transparent objects Specifies the render type of transparent objects. The options are:
  • One pass: Rendering is done in one pass (default). This can lead to triangular artifacts. If these occur the type Backface pass can be used to avoid them.
  • Backface pass: Rendering is done in two passes. Back-facing polygons are rendered in the first pass and front-facing polygons in the second pass.
Marker size Specifies the size of vertices (points) in the Sketcher Workbench. The clickable area of points can be additionally enlarged by increasing the Pick radius.
Pick radius (px) Sets the area for picking elements in the 3D view. Larger value makes it easier to pick things, but can make some small features impossible to select.
Eye to eye distance for stereo modes Specifies the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the bounding box size of the 3D object that is currently displayed.
Backlight color If checked, backlight is enabled with the defined color. Backlight is used for rendering the back sides of faces. Usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly. It is only used for objects whose Lighting property (on the View tab) is set to One side. If disabled, the back side of the faces of those objects will be black.

The related Intensity setting specifies the intensity of the backlight.

Camera type Specifies the camera projection type. The options are:

导航栏

On the Navigation tab you can specify the following:

Name Description
Navigation cube If checked, the Navigation cube will be shown in the 3D view.

Steps by turn defines the number of steps required for a full rotation when using the Navigation cube rotation arrows.

If Rotate to nearest is checked, the 3D view is rotated to the nearest most logical position, based on the current orientation of the cube, when a cube face is clicked. Else clicking a face will always result in the same rotation. introduced in version 0.20

Cube size defines the size of the cube. introduced in version 0.20

Color sets the base color for all elements. introduced in version 0.21

Corner defines where the Navigation cube is displayed in the 3D view. The options are:

  • Top left
  • Top right
  • Bottom left
  • Bottom right

Font name specifies the font used for the cube's texts. introduced in version 0.21

Font size sets the size of the font used for the cube's texts. introduced in version 0.21

3D Navigation Specifies a mouse navigation style. To see the details of each style, select it and then press the Mouse... button.
Orbit style Specifies the rotation orbit style used when in rotation mode. The options are:
  • Turntable: Moving the mouse will divide the rotation in steps, rotations around the different axes are performed sequentially.
  • Trackball: Rotations around the different axes are performed simultaneously.
  • Free Turntable: Like Trackball, but if possible the rotation axis is kept collinear with the global 3D view axis. introduced in version 0.21
Rotation mode Defines the rotation center. The options are:
  • Window center
  • Drag at cursor
  • Object center
Default camera orientation Specifies the camera orientation for new documents. This setting is also used by the Std ViewHome command.
Camera zoom Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in 3D view. The default is 100 mm. It also sets the initial size of origin features (base planes in new PartDesign Bodies and Std Parts).
Enable animation If checked, and 3D Navigation is set to CAD, rotations can be animated. If the mouse is moved while the scroll wheel and the right mouse button are pressed, the view is rotated. If one keeps the mouse moving while releasing the right mouse button, the rotation will continue. To end this animation left-click with the mouse.
Zoom at cursor If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise zoom operations will be performed at the center of the current view. The Zoom step defines how much will be zoomed. A zoom step of 1 means a factor of 7.5 for every zoom step.
Invert zoom If checked, the direction of zoom operations will be inverted.
Disable touchscreen tilt gesture If checked, and 3D Navigation is set to Gesture, the tilting gesture will be disabled for pinch-zooming (two-finger zooming).
Enable rotation center indication If checked, the rotation center of the view is shown when dragging. introduced in version 1.0

颜色

On the Colors tab you can specify the following:

Name Description
Enable preselection highlighting If checked, preselection is turned on and the specified color will be used for it. Preselection means that for example edges of objects will be highlighted while hovering over them with the mouse to indicate they can be selected.
Enable selection highlighting If checked, selection highlighting is turned on and the specified color will be used for it.
Simple color If selected, the background of the 3D view will have the specified color.
Linear gradient If selected, the background of the 3D view will have a vertical color gradient defined by the specified Top and Bottom colors. if enabled, a Middle color can also be specified. Press the button (introduced in version 0.21) to switch the top and bottom colors.
Radial gradient introduced in version 0.21 If selected, the background of the 3D view will have a radial color gradient defined by the specified Central and End colors. if enabled, a Midway color can also be specified. Press the button to switch the central and end colors.
Object being edited Specifies the background color for objects in the tree view that are currently edited.
Active container Specifies the background color for active containers in the tree view. For example an active PartDesign Body will get this color.

网格视图

This tab is only available if the Mesh Workbench has been loaded.

On the Mesh view tab you can specify the following:

Name Description
Default mesh color Specifies the default face color.
Default line color Specifies the default line color.
Mesh transparency Specifies the default mesh transparency.
Line transparency Specifies the default line transparency.
Two-side rendering If checked, the default value for the 视图Lighting property is Two side instead of One side. Two side means the color of the interior side of faces is the same as the color of the exterior side. One side means their color is either the backlight color, if enabled, or black.
Show bounding-box for highlighted or selected meshes If checked, the default value for the 视图Selection Style property is BoundBox instead of Shape. BoundBox means a highlighted bounding box is displayed if meshes are highlighted or selected. Shape means the shape itself is then highlighted.
Define normal per vertex If checked, Phong shading is used, otherwise flat shading. Shading defines the appearance of surfaces. With flat shading the surface normals are not defined per vertex. This leads to an unrealistic appearance for curved surfaces. While Phong shading leads to a more realistic, smoother appearance.
Crease angle The crease angle is a threshold angle between two faces. It can only be set if the option Define normal per vertex is used.
If face angle ≥ crease angle, facet shading is used.
If face angle < crease angle, smooth shading is used.

Workbenches

This preferences section has a single tab: Available Workbenches.

Available Workbenches

These preferences control workbench loading.

On the Available Workbenches tab you can specify the following:

Name Description
Workbench list The list displays all installed workbenches. The list can be reordered by drag and drop (introduced in version 0.21) and sorted by right-clicking the list and selecting Sort alphabetically (introduced in version 1.0). The order of the list also determines the order of the Workbench selector.
  • introduced in version 0.21: First checkbox in each row: If checked, the workbench will be available in the Workbench selector in the next FreeCAD session. The start up workbench cannot be unchecked. Unchecked workbenches are moved to the bottom of the list.
  • Auto-load: If checked, the workbench will auto-load when FreeCAD starts. Loading more workbenches will make the start up slower, but switching between workbenches that have already been loaded is faster.
  • Load: Press this button to load the workbench in the current FreeCAD session.
Start up workbench The workbench that is activated when FreeCAD starts.
Workbench selector position introduced in version 0.21 Defines where the Workbench selector appears. The options are:
  • Toolbar: In a dedicated toolbar.
  • Left corner: In the left corner of the menubar.
  • Right corner: In the right corner of the menubar.
Remember active workbench by tab If checked, FreeCAD will remember and restore the workbench that was active for each tab in the Main view area.

Python

This preferences section (introduced in version 0.21) has three tabs: Macro, Python console and Editor.

On the Macro tab you can specify the following:

名称 描述
在本地环境中运行宏 If checked, variables defined by macros are created as local variables, otherwise as global Python variables
宏路径 Specification of the path for macro files
录制图形用户界面命令 If checked, recorded macros will also contain user interface commands
录制为注释 If checked, recorded macros will also contain user interface commands, but as comments. This is useful if you don't want to execute these commands when running the macro, but do want to see what has been done while recording.
在Python控制台显示脚本 If checked, the commands executed by macro scripts are shown in the Python console. This console is shown using the View → Panels → Python console menu option.
Size of recent macros list Controls the number of recent macros to display in the menu
快捷方式计数 Controls the number of recent macros that get dynamically assigned shortcuts
键盘编辑器 Controls which keyboard modifiers are used for the shortcuts, example Ctrl+Shift+ creates shortcuts in the form of Ctrl+Shift+1, Ctrl+Shift+2, etc.

Python console

These preferences control the behavior of the Python console. This console can be opened using the View → Panels → Python console menu option.

Note that the color and font settings for the console are defined on the Editor tab.

On the Python console tab (introduced in version 0.20) you can specify the following:

Name Description
Enable word wrap If checked, words will be wrapped if they exceed the available horizontal space in the console.
Enable block cursor If checked, the cursor will have a block shape.
Save history If checked, Python history is saved across sessions.

编辑器

编辑器首选项设置影响的是宏编辑器的行为。此编辑器可通过Macro → Macros... → Edit/Create菜单打开。
请注意: 这里的颜色和字体设置也会影响到Python控制台。此控制台可通过View → Panels → Python console菜单打开。

The color and font settings are also used by the Python console.

Editor选项卡中,您可以指定以下内容:

名称 描述
Display Items 选择代码类型。此处的颜色与字体设置将应用于所选的代码类型。可以从Preview框中预览效果。
字体族 指定应用于所选代码类型的字体系列(font family)。
大小 指定应用于所选代码类型的字体大小。
启用行号 若开启此项,将显示代码行号。
制表符长度 指定一个tab符占多少空格位置。若将此值设置为'6',则多次按下Tab键后,将根据当前光标位置,依次跳至其后的第7个字符、第13个字符或第19个字符等处。只有在选中保留制表符后,本选项才可生效。
缩进大小 指定在按下Tab键后将会插入多少个空格。只有在选中插入空格后,本选项才会生效。
保留制表符 如果选择本项,则按下Tab键将插入占空为制表符长度的tab符。
插入空格 如果选择本项,则按下Tab键将插入数量为缩进大小的空格符。

Addon Manager

This preferences section has a single tab: Addon manager options.

Addon manager options

These preferences control the behavior of the Addon manager.

On the Addon manager options tab (introduced in version 0.20) you can specify the following:

Name Description
Automatically check for updates at start (requires git) If checked, the Addon manager will check for updates when it is launched. Git must be installed for this to work.
Download Macro metadata (approximately 10MB) If checked, macro metadata is downloaded for display in the Addon manager's main addon listing. This data is cached locally.
Cache update frequency Controls the frequency with which the locally cached addon availability and metadata information is updated. The options are:
  • Manual (no automatic updates)
  • Daily
  • Weekly
Hide Addons marked Python 2 Only If checked, addons marked as "Python 2 Only" are not included in the listing. These addons are unlikely to work in the current FreeCAD version.
Hide Addons marked Obsolete If checked, addons marked as "Obsolete" are not included in the listing.
Hide Addons that require a newer version of FreeCAD If checked, addons that require a newer FreeCAD version are not included in the listing.
Custom repositories Custom repositories can be specified here.

To add a repository press the button. Both the Repository URL and the Branch, typically master or main, must be specifies in the dialog that opens. introduced in version 0.21

To remove a repository select it in the list and press the button. introduced in version 0.21

Proxy The Addon manager includes experimental support for proxies requiring authentication, set up as user-defined proxies.
Python executable (optional) The Addon manager attempts to determine the Python executable that should be used for the automatic pip-based installation of Python dependencies. To override this selection, the path to the executable can be set here.
git executable (optional) The Addon manager attempts to determine the git executable. To override this selection, the path to the executable can be set here. introduced in version 0.21
Show option to change branches (requires git) If checked, the Addon manager provides an interface on the addon's details screen that allows switching which git branch is currently checked out. This is intended for advanced users only, as it is possible that a non-primary-branch version of an addon may result in instability and compatibility issues. Git must be installed for this to work. Use with caution.
Disable git (fall back to ZIP downloads only) If checked, git downloads are disabled. introduced in version 0.21
Addon developer mode If checked, Addon manager options intended for developers of addons are activated. introduced in version 0.21

Import-Export

The Import-Export preferences affect how files are imported and exported. They are described on the Import Export Preferences page.

工作台首选项

下列为常用工作台的首选项。部分工作台并没有对应的首选项。其他可选工作台可能也未列入其中。

Preferences for the built-in workbenches are linked below. These links are also listed in Category:Preferences. Some workbenches have no preferences.

Scripting

See also: FreeCAD Scripting Basics.

For a scripting example see Std DlgParameter.

Related