Difference between revisions of "Preferences Editor/zh"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(31 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
 +
 
{{Docnav
 
{{Docnav
|[[Document structure|Document structure]]
+
|[[Interface_Customization|Interface Customization]]
|[[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 的首选项位于菜单栏中的 编辑 → 首选项。
 
FreeCAD 的首选项位于菜单栏中的 编辑 → 首选项。
</div>  
+
</div>
{{TOCright}}
+
 
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
 
FreeCAD 的功能被分为了不同的模块,每个模块负责某个具体[[Workbenches/zh|工作台]]的相关工作。FreeCAD 还使用了一种称之为后加载的观念,意即相关组件只有在需要时才被加载进来。或许你已经注意到,当你在 FreeCAD 工具栏中选择一个工作台时,此工作台和它的所有组件都同时被加载进来。这其中包含了它的首选项设置。
 
FreeCAD 的功能被分为了不同的模块,每个模块负责某个具体[[Workbenches/zh|工作台]]的相关工作。FreeCAD 还使用了一种称之为后加载的观念,意即相关组件只有在需要时才被加载进来。或许你已经注意到,当你在 FreeCAD 工具栏中选择一个工作台时,此工作台和它的所有组件都同时被加载进来。这其中包含了它的首选项设置。
Line 19: Line 22:
 
</div>
 
</div>
  
 +
<div class="mw-translate-fuzzy">
 
单击任何首选项显示左下角的{{Button|重置}} 按钮,将freecad首选项的“全部”设置为其默认值。
 
单击任何首选项显示左下角的{{Button|重置}} 按钮,将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.
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 35: Line 42:
 
</div>
 
</div>
  
This option only has an effect if in {{MenuCommand|Style sheet}}/''No style sheet'' is selected.
+
{| class="wikitable float-right mw-collapsible mw-collapsed"
 +
!style="width: 33%;"|Name
 +
!style="width: 66%;"|Description
 +
|-
 +
| {{MenuCommand|Change language}}
 +
| Specifies the language of the FreeCAD user interface.
 +
|-
 +
| {{MenuCommand|Number format}} {{Version|0.20}}
 +
| Specifies the number format. The options are:
 +
* '''Operating system''': The decimal separator defined by the operating system is used.
 +
* '''Selected language''': The decimal separator of the selected FreeCAD interface language is used.
 +
* '''C/POSIX''': A point is used as the decimal separator.
 +
|-
 +
| {{MenuCommand|Substitute decimal separator}} {{Version|0.20}}
 +
| If checked, the numerical keypad decimal separator will be substituted with the separator defined by the {{MenuCommand|Number format}} setting (restart required).
 +
|-
 +
| {{MenuCommand|Preference packs}} {{Version|0.20}}
 +
| Lists the available [[Preference_Packs|preference packs]] and also allows you to save new packs.
 +
|-
 +
| {{MenuCommand|Size of recent file list}}
 +
| Specifies how many files should be listed in the recent files list.
 +
|-
 +
| {{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
Line 45: Line 77:
 
{{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|Enable cursor blinking}}
 +
| If checked the text cursor in the [[Python_console|Python console]] and the [[Std_DlgMacroExecute#Edit|Macro editor]] will blink.
 
|-
 
|-
 
| {{MenuCommand|Style sheet}}
 
| {{MenuCommand|Style sheet}}
| Selection of a style sheet. The style sheets define how the user interface of FreeCAD looks.
+
| Specifies a style sheet. Style sheets define how the user interface of FreeCAD looks. For technical details about style sheets see [[Interface_Customization#Themes|themes]].
 
|-
 
|-
 
| {{MenuCommand|Size of toolbar icons}}
 
| {{MenuCommand|Size of toolbar icons}}
| Selection of the size for the toolbar icons
+
| Specifies the size of the toolbar icons. The options are:
 +
* '''Small (16px)'''
 +
* '''Medium (24px)'''
 +
* '''Large (32px)'''
 +
* '''Extra large (48px)'''
 
|-
 
|-
 
| {{MenuCommand|Tree view mode}}
 
| {{MenuCommand|Tree view mode}}
| Customization how the tree view is shown in the panel (restart required). The options are:
+
| Defines how the tree view is shown in the user interface (restart required). The options are:
* '''Combo View''': combine tree view and property view into one panel.
+
* '''Combo View''': Combines the tree view and the property view into one panel.
* '''TreeView and PropertyView''': split tree view and property view into separate panel.
+
* '''TreeView and PropertyView''': Splits the tree view and the property view into separate panels.
* '''Both''': keep all three panels, and you can have two sets of tree view and property view.
+
* '''Both''': Shows all three panels.
 
|-
 
|-
 
| {{MenuCommand|Auto load module after start up}}
 
| {{MenuCommand|Auto load module after start up}}
| Selection what workbench will be used directly after starting FreeCAD
+
| The workbench that will be activated when FreeCAD is started.
 
|-
 
|-
 
| {{MenuCommand|Enable splash screen at start up}}
 
| {{MenuCommand|Enable splash screen at start up}}
| If checked, the splash screen of FreeCAD is shown when starting.
+
| If checked, a splash screen is shown when starting FreeCAD.
  
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.
+
The splash screen image can be changed by placing a file named {{FileName|splash_image.png}} in the {{FileName|Images}} folder already mentioned under {{MenuCommand|Enable tiled background}}.
|-
 
| {{MenuCommand|Enable word wrap}}
 
|  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}}.  
 
 
|}
 
|}
  
[[Image:Preference_General_Tab_01.png]]
+
[[Image:Preferences_General_Tab_General.png]]
  
 
===文档===
 
===文档===
  
In the ''Document'' tab you can specify the following:
+
On the ''Document'' 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 81: Line 118:
 
|-
 
|-
 
| {{MenuCommand|Create new document at start up}}
 
| {{MenuCommand|Create new document at start up}}
| If checked, FreeCAD will create a new document when started
+
| If checked, FreeCAD will create a new document when started.
 
|-
 
|-
 
| {{MenuCommand|Document save compression level}}
 
| {{MenuCommand|Document save compression level}}
| Specification of the compression level for {{FileName|FCStd}} files. {{FileName|FCStd}} files are ZIP-compressed files. Therefore you can rename their suffix {{FileName|.FCStd}} to {{FileName|.zip}} and open them with a ZIP archive program.
+
| Specifies the compression level for {{FileName|FCStd}} files. {{FileName|FCStd}} files are ZIP-compressed files. Therefore you can rename their suffix {{FileName|.FCStd}} to {{FileName|.zip}} and open them with a ZIP archive program.
 
|-
 
|-
 
| {{MenuCommand|Using Undo/Redo on documents}}
 
| {{MenuCommand|Using Undo/Redo on documents}}
| If checked, all changes in documents are stored so that they can be undone/redone
+
| If checked, all changes in documents are stored so that they can be undone/redone.
 
|-
 
|-
 
| {{MenuCommand|Maximum Undo/Redo steps}}
 
| {{MenuCommand|Maximum Undo/Redo steps}}
| Specification how many Undo/Redo steps should be recorded
+
| Specifies how many Undo/Redo steps should be recorded.
 
|-
 
|-
 
| {{MenuCommand|Allow aborting recomputation}}
 
| {{MenuCommand|Allow aborting recomputation}}
| Allow to aborting the document recomputation by pressing {{KEY|Esc}}. This may slightly increase the recomputation time.
+
| If checked, recomputations can be aborted by pressing {{KEY|Esc}}. This may slightly increase the recomputation time.
 
|-
 
|-
 
| {{MenuCommand|Run AutoRecovery at startup}}
 
| {{MenuCommand|Run AutoRecovery at startup}}
| If there is a recovery file available FreeCAD will automatically run a file recovery when it is started. This way files can be restored if a crash occurred.
+
| If there is a recovery file available FreeCAD will automatically run a file recovery when it is started. This way files can be restored if a crash occurred.
 
|-
 
|-
 
| {{MenuCommand|Save AutoRecovery information every}}
 
| {{MenuCommand|Save AutoRecovery information every}}
| Specification how often a recovery file is written.
+
| Specifies how often a recovery file is written.
 
|-
 
|-
 
| {{MenuCommand|Save thumbnail into project file when saving document}}
 
| {{MenuCommand|Save thumbnail into project file when saving document}}
| If checked, also a thumbnail will be stored when the document is saved. The thumbnail will for example be shown in the list of recent files in the [[Start_Workbench|Start workbench]]. It is possible to select a '''Size''' between 128×128 and 512×512 pixels for the thumbnail. Common sizes are the powers of two: 128, 256, 512.
+
| If checked, a thumbnail will be stored when the document is saved. The thumbnail will for example be shown in the list of recent files in the [[Start_Workbench|Start Workbench]]. It is possible to select a {{MenuCommand|Size}} between 128×128 and 512×512 pixels for the thumbnail. Common sizes are powers of two: 128, 256, 512.
 
|-
 
|-
 
| {{MenuCommand|Add the program logo to the generated thumbnail}}
 
| {{MenuCommand|Add the program logo to the generated thumbnail}}
| If checked, the FreeCAD program logo [[image:FreeCAD-logo.svg|24px]] will be added to the thumbnail. This option only has an effect if {{MenuCommand|Save thumbnail into project file when saving document}} is used.
+
| If checked, the FreeCAD program logo [[image:Freecad.svg|24px]] will be added to the thumbnail.
 
|-
 
|-
 
| {{MenuCommand|Maximum number of backup files to keep when resaving document}}
 
| {{MenuCommand|Maximum number of backup files to keep when resaving document}}
| If checked, backup files will be kept when saving the document. You can specify how many backup files will be kept. They contain the previously saved document version. The first backup file will have the file suffix {{FileName|.FCStd1}}, the second {{FileName|.FCStd2}} and so on.
+
| If checked, backup files will be kept when saving the document. You can specify the number of backup files to keep. Backup files are previously saved versions of the document. The first backup file will have the file suffix {{FileName|.FCStd1}}, the second {{FileName|.FCStd2}} and so on.
 
|-
 
|-
 
| {{MenuCommand|Use date and FCBak extension}}
 
| {{MenuCommand|Use date and FCBak extension}}
| If checked, backup files will get the extension ''.FCbak'' and their file names get a date suffix according to the specified date format. For a description of the date format see [https://devhints.io/datetime this site].
+
| If checked, backup files will get the extension {{FileName|.FCbak}} and their file names get a date suffix according to the specified {{MenuCommand|Date format}}. For a description of the date format see [https://devhints.io/datetime Date & time formats cheatsheet].
With the default settings the backup file will get for example this name ''TD-Cube.20200315-215654.FCBak'' (original filename is ''TD-Cube.FCStd'').
+
With the default settings a backup file will for example get this name {{FileName|TD-Cube.20200315-215654.FCBak}} (original filename is {{FileName|TD-Cube.FCStd}}).
 
|-
 
|-
 
| {{MenuCommand|Allow duplicate object labels in one document}}
 
| {{MenuCommand|Allow duplicate object labels in one document}}
| If checked, objects can have the same label/name. For example different parts or features can then have the same name in the same document.
+
| If checked, objects can have the same label.
 
|-
 
|-
 
| {{MenuCommand|Disable partial loading of external linked objects}}
 
| {{MenuCommand|Disable partial loading of external linked objects}}
| Enable partial loading of external linked document. When enabled, only the referenced objects and their dependencies will be loaded when a linked document is auto opened together with the main document. A partially loaded document cannot be edited. Double click the document icon in the tree view to reload it in full. A more detailed explanation of the feature can be found on the [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes#partial-document-loading Assembly3 documentation page]
+
| If partial loading of external linked objects is enabled, only the referenced objects and their dependencies will be loaded when the linked document is auto opened together with the main document. Such a partially loaded document cannot be edited. Double click the document icon in the tree view to reload it in full. A more detailed explanation of this feature can be found on the [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes#partial-document-loading Assembly3 documentation page].
 
|-
 
|-
 
| {{MenuCommand|Author name}}
 
| {{MenuCommand|Author name}}
| All documents that will be created will get the specified author name. Keep the author field blank for an anonymous author. If the option {{MenuCommand|Set on save}} is checked, the field ''Last modified by'' will be set to the specified author when saving the file. This field can be viewed using the menu {{MenuCommand|File → Project information}}.
+
| All created documents will get the specified author name. Keep the author field blank if you do not want to include this information. If the option {{MenuCommand|Set on save}} is checked, the field '''Last modified by''' will be set to the specified author when saving the file. This field can be viewed using the {{MenuCommand|File → Project information}} menu option.
 
|-
 
|-
 
| {{MenuCommand|Company}}
 
| {{MenuCommand|Company}}
| All documents that will be created will get the specified company name
+
| All created documents will get the specified company name.
 
|-
 
|-
 
| {{MenuCommand|Default license}}
 
| {{MenuCommand|Default license}}
| Selection of a default license for new documents. For predefined license the {{MenuCommand|License URL}} will automatically be set accordingly. Select 'Other' for an own or special license.
+
| Specifies the license for new documents. For predefined licenses the {{MenuCommand|License URL}} will automatically be set accordingly. Select '''Other''' for a custom license.
 
|-
 
|-
 
| {{MenuCommand|License URL}}
 
| {{MenuCommand|License URL}}
| Specification of an URL describing the license selected in {{MenuCommand|Default license}}
+
| Specifies an URL describing the license selected in {{MenuCommand|Default license}}.
 +
|}
 +
 
 +
[[Image:Preferences_General_Tab_Document.png]]
 +
 
 +
===Selection===
 +
 
 +
On the ''Selection'' tab ({{Version|0.19}}) you can specify the following:
 +
 
 +
{| class="wikitable float-right mw-collapsible mw-collapsed"
 +
!style="width: 33%;"|Name
 +
!style="width: 66%;"|Description
 +
|-
 +
| {{MenuCommand|Auto switch to the 3D view containing the selected item}}
 +
| Enables the [[Std_TreeSyncView|Tree view SyncView mode]].
 +
|-
 +
| {{MenuCommand|Auto expand tree item when the corresponding object is selected in 3D view}}
 +
| Enables the [[Std_TreeSyncSelection|Tree view SyncSelection mode]].
 +
|-
 +
| {{MenuCommand|Preselect the object in 3D view when mouse over the tree item}}
 +
| Enables the [[Std_TreePreSelection|Tree view PreSelection mode]].
 +
|-
 +
| {{MenuCommand|Record selection in tree view in order to go back/forward using navigation button}}
 +
| Enables the [[Std_TreeRecordSelection|Tree view RecordSelection mode]].
 +
|-
 +
| {{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.
 
|}
 
|}
  
[[Image:Preference_General_Tab_02.png]]
+
[[Image:Preferences_General_Tab_Selection.png]]
  
===编辑器===
+
===Cache===
  
The editor preferences settings affect the behavior of the macro editor. This editor can be opened using the menu  {{MenuCommand|Macro → Macros...  → Edit/Create}}.
+
These preferences are related to the cache directory where FreeCAD stores temporary files.
  
The color and font settings also affect the [[Python console|Python console]]. This console is shown using the menu  {{MenuCommand|View → Panels → Python console}}.
+
On the ''Cache'' tab ({{Version|0.20}}) you can specify the following:
  
In the ''Editor'' 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|Display Items}}
+
| {{MenuCommand|Location}}
| Selection of the code type. The color and font settings will be applied to the selected type. The result can be seen in the '''Preview''' field.
+
| Specifies the path of the cache directory.
 +
|-
 +
| {{MenuCommand|Check periodically at program start}}
 +
| Controls the frequency with which the directory size is checked. The options are:
 +
* '''Always'''
 +
* '''Daily'''
 +
* '''Weekly'''
 +
* '''Monthly'''
 +
* '''Yearly'''
 +
* '''Never'''
 
|-
 
|-
| {{MenuCommand|Family}}
+
| {{MenuCommand|Cache size limit}}
| Specification of the font family that should be used for the selected code type
+
| 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'''
 
|-
 
|-
| {{MenuCommand|Size}}
+
| {{MenuCommand|Current cache size}}
| Specification of the font size that should be used for the selected code type
+
| Shows the current size of the directory, if available. Press the {{Button|Check now...}} button to update the value.
 +
|}
 +
 
 +
[[Image:Preferences_General_Tab_Cache.png]]
 +
 
 +
===编辑器===
 +
 
 +
These preferences control the behavior of the [[Std_DlgMacroExecute#Edit|Macro editor]]. This editor can be opened using the {{MenuCommand|Macro → Macros... → Edit}} or {{menuCommand|Create}} menu option.
 +
 
 +
The color and font settings are also used by the [[#Python_console|Python console]].
 +
 
 +
On the ''Editor'' tab you can specify the following:
 +
 
 +
{| class="wikitable float-right mw-collapsible mw-collapsed"
 +
!style="width: 33%;"|Name
 +
!style="width: 66%;"|Description
 
|-
 
|-
 
| {{MenuCommand|Enable line numbers}}
 
| {{MenuCommand|Enable line numbers}}
| If checked, the code lines will be numbered
+
| If checked, the code lines will be numbered.
 +
|-
 +
| {{MenuCommand|Enable block cursor}}
 +
| If checked, the cursor will have a block shape.
 
|-
 
|-
 
| {{MenuCommand|Tab size}}
 
| {{MenuCommand|Tab size}}
| Specification of the tabulator raster (how many spaces). If it is for example set to '6', pressing {{KEY|Tab}} will jump to character 7 or 13 or 19 etc., depending the current cursor position. This setting is only used if {{MenuCommand|Keep tabs}} is selected.
+
| Specifies the tabulator raster (how many spaces). If it is for example set to '''6''', pressing {{KEY|Tab}} will jump to character 7 or 13 or 19 etc., depending on the current cursor position. This setting is only used if {{MenuCommand|Keep tabs}} is selected.
 
|-
 
|-
 
| {{MenuCommand|Indent size}}
 
| {{MenuCommand|Indent size}}
| Specification of how many spaces will be inserted when pressing {{KEY|Tab}}. This setting is only used if {{MenuCommand|Insert spaces}} is selected.
+
| Specifies how many spaces will be inserted when pressing {{KEY|Tab}}. This setting is only used if {{MenuCommand|Insert spaces}} is selected.
 
|-
 
|-
 
| {{MenuCommand|Keep tabs}}
 
| {{MenuCommand|Keep tabs}}
|   If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tab size}}
+
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tab size}}.
 
|-
 
|-
 
| {{MenuCommand|Insert spaces}}
 
| {{MenuCommand|Insert spaces}}
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Indent size}}
+
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Indent size}}.
 +
|-
 +
| {{MenuCommand|Display Items}}
 +
| Specifies the code type the color and font settings will be applied to. The result can be checked in the {{MenuCommand|Preview}} field.
 +
|-
 +
| {{MenuCommand|Family}}
 +
| Specifies the font family that should be used for the selected code type.
 +
|-
 +
| {{MenuCommand|Size}}
 +
| Specifies the font size that should be used for the selected code type.
 +
|-
 +
| {{MenuCommand|Color}}
 +
| Specifies the color that should be used for the selected code type.
 +
|}
 +
 
 +
[[Image:Preferences_General_Tab_Editor.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.
 +
 
 +
On the ''Python console'' 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|Enable word wrap}}
 +
| If checked, words will be wrapped if they exceed the available horizontal space in the console.
 +
|-
 +
| {{MenuCommand|Enable block cursor}}
 +
| If checked, the cursor will have a block shape.
 +
|-
 +
| {{MenuCommand|Save history}}
 +
| If checked, Python history is saved across sessions.
 
|}
 
|}
  
[[Image:Preference_General_Tab_03.png]]
+
[[Image:Preferences_General_Tab_Python_console.png]]
  
 
===输出窗口===
 
===输出窗口===
  
The output preferences affect the behavior of the [[Report view|Report view]].
+
Theses preferences control the behavior of the [[Report_view|Report view]]. This panel can be opened using the {{MenuCommand|View → Panels → Report view}} menu option.
 +
 
 +
On the ''Output window'' tab 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 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|Normal messages}}.
 
|-
 
|-
 
| {{MenuCommand|Record log messages}}
 
| {{MenuCommand|Record log messages}}
| 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}}.  
+
| If checked, log messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Log messages}}.  
 
|-
 
|-
 
| {{MenuCommand|Record warnings}}
 
| {{MenuCommand|Record warnings}}
| If checked, warnings will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Warnings}}.
+
| If checked, warnings will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Warnings}}.
 
|-
 
|-
 
| {{MenuCommand|Record error messages}}
 
| {{MenuCommand|Record error messages}}
| 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, error messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Errors}}.
 
|-
 
|-
| {{MenuCommand|Show report view on error or warning}}
+
| {{MenuCommand|Show report view on error}}
| If checked, the [[Report_view|report view]] panel will show up automatically when an error or warning is logged.
+
| If checked, the [[Report_view|Report view]] will be shown automatically when an error is recorded.
 +
|-
 +
| {{MenuCommand|Show report view on warning}}
 +
| 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|Show report view on log message}}
 +
| 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|Normal messages}}
 
| {{MenuCommand|Normal messages}}
| Specification of the font color for normal messages in the Report view panel.
+
| Specifies the font color for normal messages.
 
|-
 
|-
 
| {{MenuCommand|Log messages}}
 
| {{MenuCommand|Log messages}}
| Specification of the font color for log messages in the Report view panel.
+
| Specifies the font color for log messages.
 
|-
 
|-
 
| {{MenuCommand|Warnings}}
 
| {{MenuCommand|Warnings}}
| Specification of the font color for warning messages in the Report view panel.
+
| Specifies the font color for warning messages.
 
|-
 
|-
 
| {{MenuCommand|Errors}}
 
| {{MenuCommand|Errors}}
| Specification of the font color for error messages in the Report view panel.
+
| Specifies the font color for error messages.
 +
 
 
|-
 
|-
 
| {{MenuCommand|Redirect internal Python output to report view}}
 
| {{MenuCommand|Redirect internal Python output to report view}}
| 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}}
+
| If checked, internal Python output will be redirected from the [[Python_console|Python console]] to the [[Report_view|Report view]].
 
|-
 
|-
 
| {{MenuCommand|Redirect internal Python errors to report view}}
 
| {{MenuCommand|Redirect internal Python errors to report view}}
| If checked, internal Python error messages will be redirected from the Python console to the Report view panel.
+
| If checked, internal Python error messages will be redirected from the [[Python_console|Python console]] to the [[Report_view|Report view]].
 
|}
 
|}
  
[[Image:Preference_General_Tab_04.png]]
+
[[Image:Preferences_General_Tab_Output_window.png]]
  
 
===宏脚本===
 
===宏脚本===
  
<div class="mw-translate-fuzzy">
+
On the ''Macro'' tab you can specify the following:
网页工作台首选项(暂无)
 
</div>
 
  
In the ''Macro'' 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 227: Line 372:
 
|-
 
|-
 
| {{MenuCommand|Run macros in local environment}}
 
| {{MenuCommand|Run macros in local environment}}
| If checked, variables defined by macros are created as local variables, otherwise as global Python variable
+
| If checked, variables defined by macros are created as local variables, otherwise as global Python variables.
 
|-
 
|-
 
| {{MenuCommand|Macro path}}
 
| {{MenuCommand|Macro path}}
| Specification of a path to macro files
+
| Specifies the path for macro files.
 
|-
 
|-
| {{MenuCommand|Recording GUI commands}}
+
| {{MenuCommand|Record GUI commands}}
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands
+
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands.
 
|-
 
|-
 
| {{MenuCommand|Record as comment}}
 
| {{MenuCommand|Record as comment}}
| 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.
+
| 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|Show script commands in python console}}
 
| {{MenuCommand|Show script commands in python console}}
| 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}}.  
+
| If checked, the commands executed by macro scripts are shown in the Python console. This console can be opened using the {{MenuCommand|View → Panels → Python console}} menu option.
 +
|-
 +
| {{MenuCommand|Size of recent macro list}}
 +
| Controls the number of recent macros to display in the menu.
 +
|-
 +
| {{MenuCommand|Shortcut count}}
 +
| Controls the number of recent macros that get dynamically assigned shortcuts.
 +
|-
 +
| {{MenuCommand|Keyboard Modifiers}}
 +
| 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.  
 
|}
 
|}
  
[[Image:Preference_General_Tab_05.png]]
+
[[Image:Preferences_General_Tab_Macro.png]]
  
 
===单位===
 
===单位===
 
This tab configures how [[Units|Units]] are shown.
 
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 252: Line 404:
 
</div>
 
</div>
  
[[Image:Preference_General_Tab_06.png]]
+
{| class="wikitable float-right mw-collapsible mw-collapsed"
 +
!style="width: 33%;"|Name
 +
!style="width: 66%;"|Description
 +
|-
 +
| {{MenuCommand|Unit system}}
 +
| Specifies the unit system to be used for all parts of FreeCAD.
 +
|-
 +
| {{MenuCommand|Number of decimals}}
 +
| The number of decimals that should be shown for numbers and dimensions.
 +
|-
 +
| {{MenuCommand|Minimum fractional inch}}
 +
| 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:Preferences_General_Tab_Units.png]]
 +
 
 +
===Help===
 +
 
 +
This tab is only available if the [https://github.com/FreeCAD/FreeCAD-Help Help Addon] has been [[Std AddonMgr|installed]].
 +
 
 +
On the ''Help'' tab you can specify the following:
 +
 
 +
{| class="wikitable float-right mw-collapsible mw-collapsed"
 +
!style="width: 33%;"|Name
 +
!style="width: 66%;"|Description
 +
|-
 +
| {{MenuCommand|Help location}}
 +
| Specifies the location of the Help files. The options are:
 +
* {{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|Display}}
 +
| Specifies where the documentation should be displayed. The options are:
 +
* {{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|Custom stylesheet}}
 +
| Specifies an optional custom stylesheet. Not used for the Wiki URL.
 +
|}
 +
 
 +
[[Image:Preferences_General_Tab_Help.png]]
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 271: Line 465:
 
</div>
 
</div>
  
This tab is always available, and controls certain characteristics of the [[3D view|3D view]].
+
On the ''3D View'' tab you can specify the following:
  
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 279: Line 472:
 
|-
 
|-
 
| {{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}} {{Version|0.19}}
 +
| 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|Remember active workbench by tab}} {{Version|0.19}}
 
| {{MenuCommand|Remember active workbench by tab}} {{Version|0.19}}
| If checked, the application will remember what is the active workbench for each tab independently. This way, the active workbench will be automatically restored when changing tab in the [https://en.wikipedia.org/wiki/Multiple_document_interface multiple-document interface (MDI)] view.
+
| If checked, the application will remember the active workbench for each tab in the [[Main_view_area|Main view area]] independently. When switching to a tab this workbench will be restored automatically.
 
|-
 
|-
| {{MenuCommand|Use OpenGL Vertex Buffer Object}}
+
| {{MenuCommand|Use software OpenGL}} {{Version|0.19}}
| 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/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.
 +
|-
 +
| {{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 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}} {{Version|0.19}}
| "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|Anti-Aliasing}}
 
| {{MenuCommand|Anti-Aliasing}}
| Selection if and what kind of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used
+
| Specifies if and what type of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used
 
|-
 
|-
 
| {{MenuCommand|Transparent objects}} {{Version|0.19}}
 
| {{MenuCommand|Transparent objects}} {{Version|0.19}}
| Render type of transparent objects. The types are:
+
| Specifies the render type of transparent objects. The options are:
* '''One pass''' (default), rendering is done in one pass. For non-solid objects like faces or meshes this can lead to artifacts. [https://forum.freecadweb.org/download/file.php?id=109935 This image] shows such an artifact (black triangle) and that the type '''Backface pass''' avoids this.
+
* '''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''', has only an effect for non-solid objects. They are then rendered in two passes: Back-facing polygons are rendered in the first pass and the front-facing in the second pass.
+
* '''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|Marker size}}
 
| {{MenuCommand|Marker size}}
| 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).
+
| 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}}.
 +
|-
 +
| {{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.
 
|-
 
|-
 
| {{MenuCommand|Eye to eye distance for stereo modes}}
 
| {{MenuCommand|Eye to eye distance for stereo modes}}
| 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.
+
| 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.
 
|-
 
|-
 
| {{MenuCommand|Backlight color}}
 
| {{MenuCommand|Backlight color}}
| 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.
+
| 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 active for objects whose Lighting property (on the View tab) is set to '''One side'''. If disabled, back sides of faces of objects in '''One side''' lighting mode will be black.
 
The related {{MenuCommand|Intensity}} setting specifies the intensity of the backlight.
 
The related {{MenuCommand|Intensity}} setting specifies the intensity of the backlight.
 
|-
 
|-
 
| {{MenuCommand|Camera type}}
 
| {{MenuCommand|Camera type}}
| Selection of the camera projection type.
+
| Specifies the camera projection type. The options are:
 
+
* '''Perspective rendering''': Objects will appear in a [https://en.wikipedia.org/wiki/Perspective_projection perspective projection].
* '''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].
* '''Orthographic rendering''', objects will be projected in [https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].
 
 
|}
 
|}
  
 
+
[[Image:Preferences_Display_Tab_3D_View.png]]
[[Image:Preference_Display_Tab_01.png]]
 
  
 
===Navigation===  
 
===Navigation===  
  
 +
On the ''Navigation'' tab you can specify the following:
  
This tab is always available, and controls the behavior of the navigation tools.
 
 
 
In the ''Navigation'' 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 336: Line 534:
 
|-
 
|-
 
| {{MenuCommand|Navigation cube}}
 
| {{MenuCommand|Navigation cube}}
| If checked, the [[Navigation_Cube|navigation cube]] will always be shown. Related {{MenuCommand|Steps by turn}} defines how many steps (notches) will be applied when using the Navigation cube rotation arrows. Related {{MenuCommand|Corner}} defines where the Navigation cube is displayed on the screen when creating/opening a document
+
| 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.
 +
 
 +
{{MenuCommand|Corner}} defines where the Navigation cube is displayed in the [[3D_view|3D view]].
 +
 
 +
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|3D Navigation}}
 
| {{MenuCommand|3D Navigation}}
| Selection of a [[Mouse_Model|navigation settings set]]. To see what each set defines, select a set and press the button {{Button|Mouse...}}.
+
| Specifies a [[Mouse_navigation|mouse navigation style]]. To see the details of each style, select it and then press the {{Button|Mouse...}} button.
 
|-
 
|-
 
| {{MenuCommand|Orbit style}}
 
| {{MenuCommand|Orbit style}}
| 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.
+
| Specifies the rotation orbit style used when in rotation mode. The options are:
 +
* '''Trackball''': Moving the mouse horizontally will rotate the view around the Y-axis.
 +
* '''Turntable''': Moving the mouse horizontally will rotate the view around the Z-axis.
 
|-
 
|-
| {{MenuCommand|New Document Camera Orientation}}
+
| {{MenuCommand|Rotation mode}}
| Selection of the camera orientation for new documents
+
| Defines the rotation center. The options are:
 +
* '''Window center'''
 +
* '''Drag at cursor'''
 +
* '''Object center'''
 
|-
 
|-
| {{MenuCommand|New Document Scale}}
+
| {{MenuCommand|Default camera orientation}}
| 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).
+
| Specifies the camera orientation for new documents. This setting is also used by the [[Std_ViewHome|Std ViewHome]] command.
 +
|-
 +
| {{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]]).
 
|-
 
|-
 
| {{MenuCommand|Enable animation}}
 
| {{MenuCommand|Enable animation}}
| 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.
+
| 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.
 
|-
 
|-
 
| {{MenuCommand|Zoom at cursor}}
 
| {{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.
+
| 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.
 
|-
 
|-
 
| {{MenuCommand|Invert zoom}}
 
| {{MenuCommand|Invert zoom}}
| If checked, the direction of zoom operations will be inverted.
+
| If checked, the direction of zoom operations will be inverted.
 
|-
 
|-
 
| {{MenuCommand|Disable touchscreen tilt gesture}}
 
| {{MenuCommand|Disable touchscreen tilt gesture}}
| If checked, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the {{MenuCommand|3D Navigation}} set ''Gesture''.
+
| If checked, and {{MenuCommand|3D Navigation}} is set to '''Gesture''', the tilting gesture will be disabled for pinch-zooming (two-finger zooming).
|-
 
| {{MenuCommand|Rotate at cursor}}
 
|  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.
 
 
|}
 
|}
  
[[Image:Preference_Navigation_Tab.png]]
+
[[Image:Preferences_Display_Tab_Navigation.png]]
  
 
===颜色===
 
===颜色===
  
This tab is always available.
+
On the ''Colors'' tab you can specify the following:
  
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 378: Line 588:
 
|-
 
|-
 
| {{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 in parts 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 selected color.
 
|-
 
|-
 
| {{MenuCommand|Color gradient}}
 
| {{MenuCommand|Color gradient}}
| If selected, the background for parts will have a vertical color gradient. The first color is the color at the top of the background, the second one the color at the bottom.
+
| If selected, the background of the [[3D_view|3D view]] will have a vertical color gradient. The first color is the color at the top of the 3D view, the second the color at the bottom.
 
|-
 
|-
 
| {{MenuCommand|Middle color}}
 
| {{MenuCommand|Middle color}}
| Is only enabled if {{MenuCommand|Color gradient}} is selected. If checked, the color gradient will get the selected color as middle color.
+
| This option is only enabled if {{MenuCommand|Color gradient}} is selected. If checked, the color gradient will get the selected color as the 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]]
  
===零件颜色===
+
===Mesh view===
  
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|Shape color}}
+
| {{MenuCommand|Default mesh color}}
| Color for new shapes. If the option {{MenuCommand|Random}} is set, a random color is used instead.
+
| Specifies the default face color.
 
|-
 
|-
| {{MenuCommand|Line color}}
+
| {{MenuCommand|Default line color}}
| Line color for new shapes
+
| Specifies the default line color.
 
|-
 
|-
| {{MenuCommand|Line width}}
+
| {{MenuCommand|Mesh transparency}}
| Line thickness for new shapes
+
| Specifies the default mesh transparency.
 
|-
 
|-
| {{MenuCommand|Vertex color}}
+
| {{MenuCommand|Line transparency}}
| Color for new [[Glossary#Vertex|vertices]]
+
| Specifies the default line transparency.
 
|-
 
|-
| {{MenuCommand|Vertex size}}
+
| {{MenuCommand|Two-side rendering}}
| Size for new [[Glossary#Vertex|vertices]]  
+
| 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.
 
|-
 
|-
| {{MenuCommand|Bounding box color}}
+
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
| Color of [[Property_editor#View|bounding boxes]] in the 3D view
+
| 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.
 
|-
 
|-
| {{MenuCommand|Two-side rendering}}
+
| {{MenuCommand|Define normal per vertex}}
| 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 '''Backlight color'''; either the backlight color will be used or black.
+
| 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.
 
|-
 
|-
| {{MenuCommand|Text color}}
+
| {{MenuCommand|Crease angle}}
| 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:
+
| 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]]
 +
 
 +
==Workbenches==
 +
 
 +
This preferences section has a single tab: Available Workbenches.
  
<code>obj=App.ActiveDocument.addObject("App::Annotation", "Label")</code>
+
===Available Workbenches===
  
This console is shown using the menu  {{MenuCommand|View → Panels → Python console}}.
+
To preserve resources, FreeCAD does not automatically load all available workbenches. And only if a workbench has been loaded will its preferences, if any, appear in the Preferences editor.
|}
+
 
 +
In FreeCAD version 0.19 the tab has a different label: ''Unloaded Workbenches'', and the tab displays a list of installed workbenches that have not yet been loaded. To load one or more workbenches select them in the list and then press the {{Button|Load Selected}} button.
 +
 
 +
In FreeCAD version 0.20 the ''Available Workbenches'' tab displays a list of all installed workbenches. To load a workbench press its {{Button|Load now}} button. If you check a workbench's {{MenuCommand|Autoload}} checkbox it will autoload when FreeCAD starts up. Loading more workbenches will make the startup slower, but switching between workbenches that have already been loaded is faster.
 +
 
 +
If a newly loaded workbench has dedicated preference they will appear in a new section in the Preferences editor. Some workbenches add support for additional import and export formats. If there are any related preferences they will appear on one or more new tabs in the [[#Import-Export|Import-Export]] section of the Preferences editor.
 +
 
 +
For a list of workbench related preferences see [[#Workbench_related_preferences|Workbench related preferences]]
 +
 
 +
[[Image:Preferences_Workbenches_Tab_Available_Workbenches.png]]
 +
 
 +
==Addon Manager==
 +
 
 +
This preferences section has a single tab: Addon manager options.
  
[[Image:Preference_Display_Tab_03.png]]
+
===Addon manager options===
  
===Mesh view===
+
These preferences control the behavior of the [[Std AddonMgr|Addon manager]].
  
This tab is only shown if you are in the [[Mesh_Workbench|Mesh Workbench]] or if you have been in this workbench before.
+
On the ''Addon manager options'' tab ({{Version|0.20}}) you can specify the following:
  
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|Automatically check for updates at start (requires GitPython)}}
| Selection of the default color for new meshes
+
| If checked, the Addon manager will check for updates when it is launched. GitPython and 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|Default line color}}
+
| {{MenuCommand|Hide Addons marked Python 2 Only}}
| Selection of the default line color for new meshes
+
| 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|Mesh transparency}}
+
| {{MenuCommand|Hide Addons marked Obsolete}}
| Specification of the default mesh transparency for new meshes
+
| If checked, addons marked as "Obsolete" are not included in the listing.
 
|-
 
|-
| {{MenuCommand|Line transparency}}
+
| {{MenuCommand|Hide Addons that require a newer version of FreeCAD}}
| Specification of the default line transparency for new meshes
+
| If checked, addons that require a newer FreeCAD version are not included in the listing.
 
|-
 
|-
| {{MenuCommand|Two-side rendering}}
+
| {{MenuCommand|Custom repositories (one per line)}}
| 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.  
+
| Custom repositories can be specified here. They should include the name of the branch you intend to use (typically "master" or "main").
 
|-
 
|-
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
+
| {{MenuCommand|Proxy}}
| If checked, a yellow bounding box will be displayed for highlighted or selected meshes.
+
| The Addon manager includes experimental support for proxies requiring authentication, set up as user-defined proxies.
 
|-
 
|-
| {{MenuCommand|Define normal per vertex}}
+
| {{MenuCommand|Python executable (optional)}}
| If checked,  [https://en.wikipedia.org/wiki/Phong_shading Phong shading] is used, otherwise flat shading. Shading defines the appearance of surfaces.
+
| 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.
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|Show option to change branches (requires GitPython)}}
| 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.
+
| For developers and beta-testers, the Addon manager can provide 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 the Addon may result in instability and compatibility issues. GitPython must be installed for this to work. Use with caution.
:If face angle ≥ crease angle, facet shading is used
 
:If face angle < crease angle, smooth shading  is used
 
 
|}
 
|}
  
[[Image:Mesh View Preferences.png]]
+
[[Image:Preferences_Addon_Manager_Tab_Addon_manager_options.png]]
  
==Import-Export Settings==
+
==Import-Export==
  
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]].
+
The Import-Export preferences affect how files are imported and exported. They are described on the [[Import_Export_Preferences|Import Export Preferences]] page.
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 494: Line 729:
 
</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 505: Line 735:
 
</div>
 
</div>
  
=== External workbenches ===
+
==Scripting==
 +
 
 +
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
 +
 
 +
For a scripting example see [[Std_DlgParameter|Std DlgParameter]].
  
 +
==Related==
  
{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each [[External Workbenches|External workbench]]}}
+
* [[Std_DlgParameter|Parameter editor]]
 +
* [[Fine-tuning|Fine-tuning]]
  
* [[A2plus_Workbench#Preferences|A2plus Preferences]]
 
* Ship Preferences (none)
 
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">

Latest revision as of 10:02, 17 June 2022

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎日本語 • ‎한국어

Introduction

FreeCAD 的首选项位于菜单栏中的 编辑 → 首选项。

FreeCAD 的功能被分为了不同的模块,每个模块负责某个具体工作台的相关工作。FreeCAD 还使用了一种称之为后加载的观念,意即相关组件只有在需要时才被加载进来。或许你已经注意到,当你在 FreeCAD 工具栏中选择一个工作台时,此工作台和它的所有组件都同时被加载进来。这其中包含了它的首选项设置。

如果没有载入任何模块,将会有两项配置部分,一项是对一般的应用设置,另一项则对显示设置。

单击任何首选项显示左下角的重置 按钮,将freecad首选项的“全部”设置为其默认值。

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

一般的首选项设置

在刚启动 FreeCAD 时没有加载工作台,此时出现的是最小首选项窗口。随着其它模块的载入,最小首选项窗口中就会出现新的部分,此时可以对每个工作台的细节进行配置。

通用

Name Description
Change language Specifies the language of the FreeCAD user interface.
Number format introduced in version 0.20 Specifies the number format. The options are:
  • Operating system: The decimal separator defined by the operating system is used.
  • Selected language: The decimal separator of the selected FreeCAD interface language is used.
  • C/POSIX: A point is used as the decimal separator.
Substitute decimal separator introduced in version 0.20 If checked, the numerical keypad decimal separator will be substituted with the separator defined by the Number format setting (restart required).
Preference packs introduced in version 0.20 Lists the available preference packs and also allows you to save new packs.
Size of recent file list Specifies how many files should be listed in the recent files list.
Enable tiled background If checked, the background of FreeCAD's main window will by default consist of tiles of this image: Background.png

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 cursor blinking If checked the text cursor in the Python console and the Macro editor will blink.
Style sheet Specifies a style sheet. Style sheets define how the user interface of FreeCAD looks. For technical details about style sheets see themes.
Size of toolbar icons Specifies the size of the toolbar icons. The options are:
  • Small (16px)
  • Medium (24px)
  • Large (32px)
  • Extra large (48px)
Tree view mode Defines how the tree view is shown in the user interface (restart required). The options are:
  • Combo View: Combines the tree view and the property view into one panel.
  • TreeView and PropertyView: Splits the tree view and the property view into separate panels.
  • Both: Shows all three panels.
Auto load module after start up The workbench that will be activated when FreeCAD is started.
Enable splash screen at start up If checked, a splash screen is shown when starting FreeCAD.

The splash screen image can be changed by placing a file named splash_image.png in the Images folder already mentioned under Enable tiled background.

Preferences General Tab General.png

文档

On the Document tab you can specify the following:

Name Description
Create new document at start up If checked, FreeCAD will create a new document when started.
Document save compression level Specifies the compression level for FCStd files. FCStd files are ZIP-compressed files. Therefore you can rename their suffix .FCStd to .zip and open them with a ZIP archive program.
Using Undo/Redo on documents If checked, all changes in documents are stored so that they can be undone/redone.
Maximum Undo/Redo steps Specifies how many Undo/Redo steps should be recorded.
Allow aborting recomputation If checked, recomputations can be aborted by pressing Esc. This may slightly increase the recomputation time.
Run AutoRecovery at startup If there is a recovery file available FreeCAD will automatically run a file recovery when it is started. This way files can be restored if a crash occurred.
Save AutoRecovery information every Specifies how often a recovery file is written.
Save thumbnail into project file when saving document If checked, a thumbnail will be stored when the document is saved. The thumbnail will for example be shown in the list of recent files in the Start Workbench. It is possible to select a Size between 128×128 and 512×512 pixels for the thumbnail. Common sizes are powers of two: 128, 256, 512.
Add the program logo to the generated thumbnail If checked, the FreeCAD program logo Freecad.svg will be added to the thumbnail.
Maximum number of backup files to keep when resaving document If checked, backup files will be kept when saving the document. You can specify the number of backup files to keep. Backup files are previously saved versions of the document. The first backup file will have the file suffix .FCStd1, the second .FCStd2 and so on.
Use date and FCBak extension If checked, backup files will get the extension .FCbak and their file names get a date suffix according to the specified Date format. For a description of the date format see Date & time formats cheatsheet.

With the default settings a backup file will for example get this name TD-Cube.20200315-215654.FCBak (original filename is TD-Cube.FCStd).

Allow duplicate object labels in one document If checked, objects can have the same label.
Disable partial loading of external linked objects If partial loading of external linked objects is enabled, only the referenced objects and their dependencies will be loaded when the linked document is auto opened together with the main document. Such a partially loaded document cannot be edited. Double click the document icon in the tree view to reload it in full. A more detailed explanation of this feature can be found on the Assembly3 documentation page.
Author name All created documents will get the specified author name. Keep the author field blank if you do not want to include this information. If the option Set on save is checked, the field Last modified by will be set to the specified author when saving the file. This field can be viewed using the File → Project information menu option.
Company All created documents will get the specified company name.
Default license Specifies the license for new documents. For predefined licenses the License URL will automatically be set accordingly. Select Other for a custom license.
License URL Specifies an URL describing the license selected in Default license.

Preferences General Tab Document.png

Selection

On the Selection tab (introduced in version 0.19) 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.

Preferences General Tab Selection.png

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.

Preferences General Tab Cache.png

编辑器

These preferences control the behavior of the Macro editor. This editor can be opened using the Macro → Macros... → Edit or Create menu option.

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

On the Editor tab you can specify the following:

Name Description
Enable line numbers If checked, the code lines will be numbered.
Enable block cursor If checked, the cursor will have a block shape.
Tab size Specifies the tabulator raster (how many spaces). If it is for example set to 6, pressing Tab will jump to character 7 or 13 or 19 etc., depending on the current cursor position. This setting is only used if Keep tabs is selected.
Indent size Specifies how many spaces will be inserted when pressing Tab. This setting is only used if Insert spaces is selected.
Keep tabs If selected, pressing Tab will insert a tabulator with the raster defined by Tab size.
Insert spaces If selected, pressing Tab will insert the amount of spaces defined by Indent size.
Display Items Specifies the code type the color and font settings will be applied to. The result can be checked in the Preview field.
Family Specifies the font family that should be used for the selected code type.
Size Specifies the font size that should be used for the selected code type.
Color Specifies the color that should be used for the selected code type.

Preferences General Tab Editor.png

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.

Preferences General Tab Python console.png

输出窗口

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

On the Output window tab you can specify the following:

Name Description
Record normal messages If checked, normal messages will be recorded. They will be displayed in the Report view with the color set in Normal messages.
Record log messages If checked, log messages will be recorded. They will be displayed in the Report view with the color set in Log messages.
Record warnings If checked, warnings will be recorded. They will be displayed in the Report view with the color set in Warnings.
Record error messages If checked, error messages will be recorded. They will be displayed in the Report view with the color set in Errors.
Show report view on error If checked, the Report view will be shown automatically when an error is recorded.
Show report view on warning 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.
Show report view on log message 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.
Normal messages Specifies the font color for normal messages.
Log messages Specifies the font color for log messages.
Warnings Specifies the font color for warning messages.
Errors Specifies the font color for error messages.
Redirect internal Python output to report view If checked, internal Python output will be redirected from the Python console to the Report view.
Redirect internal Python errors to report view If checked, internal Python error messages will be redirected from the Python console to the Report view.

Preferences General Tab Output window.png

宏脚本

On the Macro tab you can specify the following:

Name Description
Run macros in local environment If checked, variables defined by macros are created as local variables, otherwise as global Python variables.
Macro path Specifies the path for macro files.
Record GUI commands If checked, recorded macros will also contain user interface commands.
Record as comment 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.
Show script commands in python console If checked, the commands executed by macro scripts are shown in the Python console. This console can be opened using the View → Panels → Python console menu option.
Size of recent macro list Controls the number of recent macros to display in the menu.
Shortcut count Controls the number of recent macros that get dynamically assigned shortcuts.
Keyboard Modifiers 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.

Preferences General Tab Macro.png

单位

Freecad一直在不断发展,因此这些屏幕的内容可能与上述截图不同。这些设置通常是不言自明的,因此您不会有任何困难去配置FreeCad以满足您的需要。

Name Description
Unit system Specifies the unit system to be used for all parts of FreeCAD.
Number of decimals The number of decimals that should be shown for numbers and dimensions.
Minimum fractional inch Minimum fractional inch that should be displayed. This setting is only available if the unit system Building US (ft-in/sqft/cuft) is used.

Preferences General Tab Units.png

Help

This tab is only available if the Help Addon has been installed.

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.

Preferences General Tab Help.png

显示设置

显示设置会影响显示的外观和鼠标手势。在“3D”选项卡上设置常规外观和鼠标手势;可以在“颜色”选项卡上修改颜色。

3D视图设置

在光标处缩放=

如果设置,缩放操作将在鼠标指针的中心位置。 如果未设置,缩放操作将在当前视图的中心位置。

反转缩放=

反转缩放操作的方向。

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 introduced in version 0.19 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.
Remember active workbench by tab introduced in version 0.19 If checked, the application will remember the active workbench for each tab in the Main view area independently. When switching to a tab this workbench will be restored automatically.
Use software OpenGL introduced in version 0.19 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 introduced in version 0.19 "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 introduced in version 0.19 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 active for objects whose Lighting property (on the View tab) is set to One side. If disabled, back sides of faces of objects in One side lighting mode will be black.

The related Intensity setting specifies the intensity of the backlight.

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

Preferences Display Tab 3D View.png

Navigation

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.

Corner defines where the Navigation cube is displayed in the 3D view.

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

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:
  • Trackball: Moving the mouse horizontally will rotate the view around the Y-axis.
  • Turntable: Moving the mouse horizontally will rotate the view around the Z-axis.
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).

Preferences Display Tab Navigation.png

颜色

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 in parts 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 selected color.
Color gradient If selected, the background of the 3D view will have a vertical color gradient. The first color is the color at the top of the 3D view, the second the color at the bottom.
Middle color This option is only enabled if Color gradient is selected. If checked, the color gradient will get the selected color as the middle color.
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.

Preferences Display Tab Colors.png

Mesh view

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 ViewLighting 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 ViewSelection 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.

Preferences Display Tab Mesh view.png

Workbenches

This preferences section has a single tab: Available Workbenches.

Available Workbenches

To preserve resources, FreeCAD does not automatically load all available workbenches. And only if a workbench has been loaded will its preferences, if any, appear in the Preferences editor.

In FreeCAD version 0.19 the tab has a different label: Unloaded Workbenches, and the tab displays a list of installed workbenches that have not yet been loaded. To load one or more workbenches select them in the list and then press the Load Selected button.

In FreeCAD version 0.20 the Available Workbenches tab displays a list of all installed workbenches. To load a workbench press its Load now button. If you check a workbench's Autoload checkbox it will autoload when FreeCAD starts up. Loading more workbenches will make the startup slower, but switching between workbenches that have already been loaded is faster.

If a newly loaded workbench has dedicated preference they will appear in a new section in the Preferences editor. Some workbenches add support for additional import and export formats. If there are any related preferences they will appear on one or more new tabs in the Import-Export section of the Preferences editor.

For a list of workbench related preferences see Workbench related preferences

Preferences Workbenches Tab Available Workbenches.png

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 GitPython) If checked, the Addon manager will check for updates when it is launched. GitPython and 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 (one per line) Custom repositories can be specified here. They should include the name of the branch you intend to use (typically "master" or "main").
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.
Show option to change branches (requires GitPython) For developers and beta-testers, the Addon manager can provide 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 the Addon may result in instability and compatibility issues. GitPython must be installed for this to work. Use with caution.

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


Arrow-left.svg Previous: 文档结构