Preferences Editor/zh-cn: Difference between revisions

From FreeCAD Documentation
(Created page with "Image工作台首选项 (不存在)")
(Updating to match new version of source page)
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav
{{docnav|Document structure|Interface Customization}}
|[[Document_structure|Document structure]]
|[[Import_Export_Preferences|Import Export Preferences]]
}}


==Introduction==
FreeCAD的首选项系统位于{{MenuCommand|Edit menu → Preferences}}。


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

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


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


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


<div class="mw-translate-fuzzy">
==通用设置==
==通用设置==
</div>


<div class="mw-translate-fuzzy">
本首选项部分包含6个选项卡:
本首选项部分包含6个选项卡:
</div>


===General===
===General===


<div class="mw-translate-fuzzy">
[[Image:Preference_General_Tab_01.png]]
{{clear}}
在''General''选项卡中,您可以指定下列内容:
在''General''选项卡中,您可以指定下列内容:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
Line 42: Line 57:
|-
|-
| {{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.<br/>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.
| 如果选中此项, 则在FreeCAD开启时展示启动画面。<br/>可通过向{{FileName|%APPDATA%/FreeCAD}} %APPDATA%是用户在操作系统中为FreeCAD指定的应用文件夹)添加{{FileName|Gui/Images}}文件夹来修改启动画面。将作为启动画面的图像命名为{{FileName|splash_image.png}}并重启FreeCAD即可看到效果。
|-
|-
| {{MenuCommand|Enable word wrap}}
| {{MenuCommand|Enable word wrap}}
| Words will be wrapped when the exceed the available horizontal space in the Python console. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
| 利用此选项可实现在Python控制台中令超出一行中的文本自动换行。利用{{MenuCommand|View → Panels → Python console}}菜单来开启Python控制台。
|}
|}
</div>

This option only has an effect if in {{MenuCommand|Style sheet}}/''No style sheet'' is selected.

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|$HOME/.FreeCAD}} (on Linux) or

{{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.
|-
| {{MenuCommand|Style sheet}}
| Selection of a style sheet. The style sheets define how the user interface of FreeCAD looks.
|-
| {{MenuCommand|Size of toolbar icons}}
| Selection of the size for the toolbar icons
|-
| {{MenuCommand|Tree view mode}}
| Customization how the tree view is shown in the panel (restart required). The options are:
* '''Combo View''': combine tree view and property view into one panel.
* '''TreeView and PropertyView''': split tree view and property view into separate panel.
* '''Both''': keep all three panels, and you can have two sets of tree view and property view.
|-
| {{MenuCommand|Auto load module after start up}}
| Selection what workbench will be used directly after starting FreeCAD
|-
| {{MenuCommand|Enable splash screen at start up}}
| If checked, the splash screen of FreeCAD is shown when starting.

The splash screen image can be changed by adding the folders {{FileName|Gui/Images}} in the folder {{FileName|%APPDATA%/FreeCAD}} (where %APPDATA% is the the user-specific application folder of FreeCAD of your operating system). Put there a file named {{FileName|splash_image.png}} and restart FreeCAD to see the changed splash screen.
|-
| {{MenuCommand|Enable word wrap}}
| 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]]


===Document===
===Document===


<div class="mw-translate-fuzzy">
[[Image:Preference_General_Tab_02.png]]
{{clear}}
在''Document''选项卡中,您可以指定以下内容:
在''Document''选项卡中,您可以指定以下内容:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
Line 76: Line 129:
|-
|-
| {{MenuCommand|Save thumbnail into project file when saving document}}
| {{MenuCommand|Save thumbnail into project file when saving document}}
| 如果选中此选项,在保存文档时,也将存储一份项目的缩略图。此缩略图将显示在[[Start_Workbench|启动工作台]]中的最近打开文件列表中。
| 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]].
|-
|-
| {{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.
| 如果选中此选项,则会将FreeCAD程序的logo [[image:FreeCAD-logo.svg|24px]]添加至缩略图中。此选项仅在开启{{MenuCommand|Save thumbnail into project file when saving document}}选项后才会生效。
|-
|-
| {{MenuCommand|Maximum number of backup files to keep when resaving document}}
| {{MenuCommand|Maximum number of backup files to keep when resaving document}}
| 如果选中此选项,在保存文档时也会保留备份文件。您可以指定保留备份文件的数量。这些文件中保存的是此前(previously)的文档版本。第一个备份文件的后缀为 {{FileName|.FCStd1}}, 第二个后缀为{{FileName|.FCStd2}},并以此类推。
| 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.
|-
|-
| {{MenuCommand|Allow duplicate object labels in one document}}
| {{MenuCommand|Allow duplicate object labels in one document}}
| 如果选中此选项,则不同的对象可以使用相同的标签/名称。例如,同一文档中的不同零件与features可用相同的名字。
| 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.
|-
|-
| {{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}}.
| 创建的所有文档均采用此指定的作者名。对于匿名作者而言,作者名字的区域为空白内容。若开启了{{MenuCommand|Set on save}}选项,则在保存文件时将''Last modified by''的内容设置为此作者名。可通过{{MenuCommand|File → Project information}}菜单来查看该文本域。
|-
|-
| {{MenuCommand|Company}}
| {{MenuCommand|Company}}
| 将所有创建的文档都指定为此公司名称。
| 将创建的所有文档都指定为此公司名称。
|-
|-
| {{MenuCommand|Default license}}
| {{MenuCommand|Default license}}
| 为新文档所指定的默认许可证。For predefined license the {{MenuCommand|License URL}} will automatically be set accordingly. Select 'Other' for an own or special license.
| 为新文档所指定的默认许可证。对于预定义的许可证而言,{{MenuCommand|License URL}}将自动做出对应的设置。而针对自定义许可证或特殊许可证来讲,可选择'Other(其他)'项。
|-
|-
| {{MenuCommand|License URL}}
| {{MenuCommand|License URL}}
| Specification of an URL describing the license selected in {{MenuCommand|Default license}}
| 指定URL来描述{{MenuCommand|Default license}}中所选的许可证。
|}
|}
</div>

[[Image:Preference_General_Tab_02.png]]


===Editor===
===Editor===


<div class="mw-translate-fuzzy">
[[Image:Preference_General_Tab_03.png]]
编辑器首选项设置影响的是宏编辑器的行为。此编辑器可通过{{MenuCommand|Macro → Macros... → Edit/Create}}菜单打开。<br/>'''请注意:''' 这里的颜色和字体设置也会影响到[https://en.wikipedia.org/wiki/Python_(programming_language) Python]控制台。此控制台可通过{{MenuCommand|View → Panels → Python console}}菜单打开。
{{clear}}
</div>
The editor preferences settings affect the behavior of the macro editor. This editor can be opened using the menu {{MenuCommand|Macro → Macros... → Edit/Create}}.<br/>'''Note:''' the color and font settings also affect the [https://en.wikipedia.org/wiki/Python_(programming_language) Python] console. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.


The color and font settings also affect the [[Python console|Python console]]. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
In the ''Editor'' tab you can specify the following:

<div class="mw-translate-fuzzy">
在''Editor''选项卡中,您可以指定以下内容:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|名称
!style="width: 66%;"|Description
!style="width: 66%;"|描述
|-
|-
| {{MenuCommand|Display Items}}
| {{MenuCommand|Display Items}}
| 选择代码类型。此处的颜色与字体设置将应用于所选的代码类型。可以从'''Preview'''框中预览效果。
| 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.
|-
|-
| {{MenuCommand|Family}}
| {{MenuCommand|Family}}
| 指定应用于所选代码类型的字体系列(font family)。
| Specification of the font family that should be used for the selected code type
|-
|-
| {{MenuCommand|Size}}
| {{MenuCommand|Size}}
| 指定应用于所选代码类型的字体大小。
| Specification of the font size that should be used for the selected code type
|-
|-
| {{MenuCommand|Enable line numbers}}
| {{MenuCommand|Enable line numbers}}
| 若开启此项,将显示代码行号。
| If checked, the code lines will be numbered
|-
|-
| {{MenuCommand|Tab size}}
| {{MenuCommand|Tab size}}
| 指定一个tab符占多少空格位置。若将此值设置为'6',则多次按下{{KEY|Tab}}键后,将根据当前光标位置,依次跳至其后的第7个字符、第13个字符或第19个字符等处。只有在选中{{MenuCommand|Keep tabs}}后,本选项才可生效。
| 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.
|-
|-
| {{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.
| 指定在按下{{KEY|Tab}}键后将会插入多少个空格。只有在选中{{MenuCommand|Insert spaces}}后,本选项才会生效。
|-
|-
| {{MenuCommand|Keep tabs}}
| {{MenuCommand|Keep tabs}}
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tab size}}
| 如果选择本项,则按下{{KEY|Tab}}键将插入占空为{{MenuCommand|Tab size}}的tab符。
|-
|-
| {{MenuCommand|Insert spaces}}
| {{MenuCommand|Insert spaces}}
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Indent size}}
| 如果选择本项,则按下{{KEY|Tab}}键将插入数量为{{MenuCommand|Indent size}}的空格符。
|}
|}
</div>

[[Image:Preference_General_Tab_03.png]]


===Output window===
===Output window===


The output preferences affect the behavior of the [[Report view|Report view]].
[[Image:Preference_General_Tab_04.png]]

{{clear}}
In the ''Output '' 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
Line 153: Line 215:
| {{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 output in the Report view panel with the color set in {{MenuCommand|Errors}}
|-
| {{MenuCommand|Show report view on error or warning}}
| If checked, the [[Report_view|report view]] panel will show up automatically when an error or warning is logged.
|-
|-
| {{MenuCommand|Normal messages}}
| {{MenuCommand|Normal messages}}
Line 170: Line 235:
|-
|-
| {{MenuCommand|Redirect internal Python errors to report view}}
| {{MenuCommand|Redirect internal Python errors to report view}}
| If checked, 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 to the Report view panel.
|}
|}

[[Image:Preference_General_Tab_04.png]]


===Macro===
===Macro===


These options control certain aspects of running [[macros|macros]].
[[Image:Preference_General_Tab_05.png]]

{{clear}}
In the ''Macro'' tab you can specify the following:
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"
Line 195: Line 262:
|-
|-
| {{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 the macro scripts are shown in the Python console. This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|-
| {{MenuCommand|Size of recent macros 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]]


===Units===
===Units===


This tab configures how [[Units|Units]] are shown.
[[Image:Preference_General_Tab_06.png]]

{{clear}}
In the ''Units'' tab you can specify the following:
In the ''Units'' tab you can specify the following:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
Line 217: Line 295:
|}
|}


[[Image:Preference_General_Tab_06.png]]


==Display settings==
==Display settings==


This preferences section has up to 3 tabs:
This preferences section has two general tabs, 3D View and Colors, and further tabs depending in the used workbenches.


===3D View===
===3D View===


This tab is always available, and controls certain characteristics of the [[3D view|3D view]].
[[Image:Preference_Display_Tab_01.png]]

{{clear}}
In 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"
Line 233: Line 312:
| {{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 always be shown at the lower right in opened files
|-
| {{MenuCommand|Show axis cross by default}} {{Version|0.19}}
| If checked, the axis cross will be shown by default at file opening or creation
|-
|-
| {{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 always be shown at the lower left in opened files
|-
|-
| {{MenuCommand|Show navigation cube}}
| {{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 [[Navigation_Cube|navigation cube]] will always be shown at the selected {{MenuCommand|Corner}} in opened files
|-
|-
| {{MenuCommand|Use OpenGL Vertex Buffer Object}}
| {{MenuCommand|Use OpenGL 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 video device. VBOs offer substantial performance gains because the data resides in the video device memory rather than the system memory and so it can be rendered directly by the video device. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects this webpage].
| If checked, [https://en.wikipedia.org/wiki/Vertex_Buffer_Object Vertex Buffer Objects] (VBO) will be used. A VBO is an [https://en.wikipedia.org/wiki/OpenGL OpenGL] feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by GPU. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects this webpage].
|-
|-
| {{MenuCommand|Enable animation}}
| {{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:
| 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.
* '''Auto''' (default), let Coin3D decide where to cache.
* '''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.
|-
| {{MenuCommand|Anti-Aliasing}}
| Selection if and what kind of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used
|-
| {{MenuCommand|Transparent objects}} {{Version|0.19}}
| Render type of transparent objects. The types 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.
* '''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.
|-
| {{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).
|-
| {{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.
|-
| {{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.
The related {{MenuCommand|Intensity}} setting specifies the intensity of the backlight.
|-
| {{MenuCommand|Camera type}}
| Selection of the camera projection type.

* '''Perspective rendering''', objects will appear in a [https://en.wikipedia.org/wiki/Perspective_projection perspective projection].
* '''Orthographic rendering''', objects will be projected in [https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].
|}


[[Image:Preference_Display_Tab_01.png]]

===Navigation===


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"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{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
|-
|-
| {{MenuCommand|3D Navigation}}
| {{MenuCommand|3D Navigation}}
| Selection of a navigation settings set. To see what each set defines, select a set and press the button {{Button|Mouse...}}.
| Selection of a [[Mouse_Model|navigation settings set]]. To see what each set defines, select a set and press the button {{Button|Mouse...}}.
|-
|-
| {{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.
| Selection of the rotation orbit style. When viewing a part in the x-y plane an being in the rotation mode of the 3D navigation, the difference is: If '''Trackball''' is selected, moving the mouse horizontally will rotate the part around the y-axis, if '''Turntable''' is selected the part will be rotated around the z-axis.
|-
| {{MenuCommand|Anti-Aliasing}}
| Selection if and what kind of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing Multisample anti-aliasing] is used
|-
|-
| {{MenuCommand|New Document Camera Orientation}}
| {{MenuCommand|New Document Camera Orientation}}
| Selection of the camera orientation for new documents
| Selection of the camera orientation for new documents
|-
| {{MenuCommand|New Document Scale}}
| 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).
|-
| {{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.
|-
|-
| {{MenuCommand|Zoom at cursor}}
| {{MenuCommand|Zoom at cursor}}
Line 267: Line 397:
| 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, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the {{MenuCommand|3D Navigation}} set ''Gesture''.
|-
|-
| {{MenuCommand|Drag at cursor}}
| {{MenuCommand|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.
| 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.
|-
| {{MenuCommand|Marker size}}
| Selection of the size of [[Glossary#Vertex|vertices]] (points) in the [[Sketcher_Workbench|Sketcher workbench]]
|-
| {{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.
|-
| {{MenuCommand|Enable backlight color}}
| If checked, backlight is enabled with the defined color
|-
| {{MenuCommand|Intensity of backlight}}
| Specification of the intensity of the backlight. This setting is only enabled if {{MenuCommand|Enable backlight color}} is checked.
|-
| {{MenuCommand|Camera type}}
| Selection of the camera projection type.<br/>If '''Perspective rendering''' is selected, objects will appear in a [https://en.wikipedia.org/wiki/Perspective_projection perspective projection].<br/>If '''Orthographic rendering''' is selected, objects will be projected in [https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].
|}
|}

[[Image:Preference_Navigation_Tab.png]]


===Colors===
===Colors===


This tab is always available.
[[Image:Preference_Display_Tab_02.png]]

{{clear}}
In 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"
Line 302: Line 419:
|-
|-
| {{MenuCommand|Pick radius}}
| {{MenuCommand|Pick radius}}
| Sets the area of confusion for picking elements in 3D view. Larger value makes it easier to pick stuff, but will make some small features impossible to select.
| 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}}
Line 308: Line 425:
|-
|-
| {{MenuCommand|Color gradient}}
| {{MenuCommand|Color gradient}}
| If selected, the background for parts will have the selected 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.
|-
|-
| {{MenuCommand|Middle color}}
| {{MenuCommand|Middle color}}
Line 319: Line 436:
| 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.
| 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.
|}
|}

[[Image:Preference_Display_Tab_02.png]]


===Part colors===
===Part colors===


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


[[Image:Preference_Display_Tab_03.png]]
{{clear}}
In the ''Part colors'' 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"
Line 331: Line 448:
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Default shape color}}
| {{MenuCommand|Shape color}}
| Selection of the default color for new shapes. If the option {{MenuCommand|Random shape color}} is set, a random color is used instead.
| Color for new shapes. If the option {{MenuCommand|Random}} is set, a random color is used instead.
|-
|-
| {{MenuCommand|Default line color}}
| {{MenuCommand|Line color}}
| Selection of the default line color for new shapes
| Line color for new shapes
|-
|-
| {{MenuCommand|Default line width}}
| {{MenuCommand|Line width}}
| Specification of the default line thickness for new shapes
| Line thickness for new shapes
|-
|-
| {{MenuCommand|Default vertex color}}
| {{MenuCommand|Vertex color}}
| Selection of the default color for new [[Glossary#Vertex|vertices]]
| Color for new [[Glossary#Vertex|vertices]]
|-
|-
| {{MenuCommand|Default vertex size}}
| {{MenuCommand|Vertex size}}
| Specification of the default size for new [[Glossary#Vertex|vertices]]
| Size for new [[Glossary#Vertex|vertices]]
|-
|-
| {{MenuCommand|Bounding box color}}
| {{MenuCommand|Bounding box color}}
| Selection of the color of [[Property_editor#View|bounding boxes]] in the 3D view
| Color of [[Property_editor#View|bounding boxes]] in the 3D view
|-
|-
| {{MenuCommand|Default text color}}
| {{MenuCommand|Two-side rendering}}
| 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.
| Selection of the default text color for document annotations. There is currently no dialog to add annotations to documents. Annotations can only be added using the Python console with this command:<br/>''obj=App.ActiveDocument.addObject("App::Annotation","Label")''<br/>This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|}

==Import-Export settings==

The Import-Export settings affect how files are imported and exported to and from FreeCAD. Note that the Import-Export preferences dialog offers file type settings for most workbenches but not every workbench is able to import/export all file types.

FreeCAD supports many file formats. For the following file formats it offers to apply special settings:

===DAE===

The [http://en.wikipedia.org/wiki/COLLADA Collada] DAE (Digital Asset Exchange) format is a standard file format for exchange of Mesh data. The [[Arch Module|Arch workbench]] can import meshes from {{FileName|.dae}} files, and export Arch and other [[Part Module|Shape]]-based objects to the {{FileName|.dae}} format. The Collada import functionality in the Arch module depends on [http://pycollada.github.io/ pycollada]. If it is not installed on your system, Collada import/export will be disabled.

For the DAE format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Scaling factor}}
| {{MenuCommand|Text color}}
| 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:
| All dimensions in the file will be scaled with the specified factor
|-
| {{MenuCommand|Mesher}}
| Sets the meshing program that should be used. If using ''Netgen'', make sure that it is available. This can be checked by using the [[Mesh_Workbench|Mesh module]] and [[Mesh_MeshFromShape|creating a mesh]] using Netgen. If it is not available another version of FreeCAD, compiled with Netgen, must be installed.
|-
| {{MenuCommand|Tessellation}}
| The tessellation value to use with the ''Builtin'' and the ''Mefisto'' meshing program.
|-
| {{MenuCommand|Grading}}
| The grading value to use for meshing using ''Netgen''. This value describes how fast the mesh size decreases. The gradient of the local mesh size h(x) is bounded by &<nowiki />#124;Δh(x)&<nowiki />#124; ≤ 1/''value''.
|-
| {{MenuCommand|Segments per edge}}
| The maximum number of segments per edge
|-
| {{MenuCommand|Segments per radius}}
| The number of segments per radius
|-
| {{MenuCommand|Second order}}
| Allow a second order mesh
|-
| {{MenuCommand|Optimize}}
| Allows optimization
|-
| {{MenuCommand|Allow quads}}
| Allow [https://en.wikipedia.org/wiki/Types_of_mesh#Two-dimensional quadrilateral faces]
|}


<code>obj=App.ActiveDocument.addObject("App::Annotation", "Label")</code>
===DWG===


This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
DWG (from drawing) is a proprietary binary file format used for storing two- and three- dimensional design data and metadata. Since it is a closed source file format it cannot be directly supported by FreeCAD. Therefore the external file converter [[FreeCAD and DWG Import|ODA is required]].

For the DWG format you can only specify the path to ODA. '''note:''' All settings for DXF file format also apply to DWG.

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Path to ODA (formerly Teigha) File Converter}}
| Sets the path to the ODA file converter
|}
|}


[[Image:Preference_Display_Tab_03.png]]
===DXF===


===Mesh view===
[https://en.wikipedia.org/wiki/AutoCAD_DXF AutoCAD DXF] (Drawing eXchange Format) is a proprietary format to exchange CAD data between AutoCAD and other programs.


This tab is only shown if you are in the [[Mesh_Workbench|Mesh Workbench]] or if you have been in this workbench before.
For the DXF format 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|Show this dialog when importing and exporting}}
| {{MenuCommand|Default mesh color}}
| Selection of the default color for new meshes
| This preferences dialog will be shown when importing or exporting DXF files
|-
|-
| {{MenuCommand|Use legacy python importer}}
| {{MenuCommand|Default line color}}
| Selection of the default line color for new meshes
| If checked, the Python importer is used, otherwise the newer C++ one. The C++ importer is faster, but has not as many features yet.
|-
|-
| {{MenuCommand|Allow FreeCAD to automatically download and update the DXF libraries}}
| {{MenuCommand|Mesh transparency}}
| Specification of the default mesh transparency for new meshes
| By checking this, you will allow FreeCAD to download the [https://github.com/yorikvanhavre/Draft-dxf-importer Python converter] for DXF import and export. This converter cannot be bundled with FreeCAD because it has a different software license.
|-
|-
| {{MenuCommand|Import}}
| {{MenuCommand|Line transparency}}
| Specification of the default line transparency for new meshes
| Select what will be imported.<br/>If '''texts and dimensions''' is unchecked, texts and [https://www.autodesk.com/techpubs/autocad/acad2000/dxf/mtext_dxf_06.htm mtexts] won't be imported.<br/>If '''layouts''' is checked, paper space objects will be imported too.<br/>Check '''*blocks''' if you want the non-named blocks (beginning with a *) to be imported too.
|-
|-
| {{MenuCommand|Create}}
| {{MenuCommand|Two-side rendering}}
| 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.
| Select what will be created.<br/>If '''simple Part shapes''' is selected, only standard Part objects will be created. This is the fastest.<br/>If '''Draft objects''' is selected, parametric Draft objects will be created whenever possible.<br/>If '''Sketches''' is selected, sketches will be created whenever possible.
|-
|-
| {{MenuCommand|Scale factor to apply to imported files}}
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
| If checked, a yellow bounding box will be displayed for highlighted or selected meshes.
| Scale factor to apply to DXF files on import. The factor is the conversion between the unit of your DXF file and millimeters. Example: for files in millimeters: 1, in centimeters: 10, in meters: 1000, in inches: 25.4, in feet: 304.8
|-
|-
| {{MenuCommand|Get original colors from the DXF file}}
| {{MenuCommand|Define normal per vertex}}
| If checked, [https://en.wikipedia.org/wiki/Phong_shading Phong shading] is used, otherwise flat shading. Shading defines the appearance of surfaces.
| If checked, colors will be retrieved from the DXF objects whenever possible. Otherwise default colors will be applied.
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|Join geometry}}
| {{MenuCommand|Crease angle}}
| The crease angle is a threshold angle between two faces. It can only be set if the option {{MenuCommand|Define normal per vertex}} is used.
| If checked, FreeCAD will try to join coincident objects into wires. Note that this can take a while.
:If face angle ≥ crease angle, facet shading is used
|-
:If face angle < crease angle, smooth shading is used
| {{MenuCommand|Group layers into blocks}}
| If checked, objects from the same layers will be joined into Draft Blocks, turning the display faster, but making them less easily editable ??The Draft Wiki pages don't mention Draft blocks??
|-
| {{MenuCommand|Use standard font size for texts}}
| If checked, imported texts will get the standard [[Draft_Text|Draft Text]] size, instead of the size they have in the DXF document
|-
| {{MenuCommand|Use VisGroups}}
| If checked, DXF layers will be imported as [[Draft_VisGroup|Draft VisGroups]]
|-
| {{MenuCommand|Import hatch boundaries as wires}}
| If checked, hatches will be converted into simple wires
|-
| {{MenuCommand|Render polylines with width}}
| If checked, when polylines have a width defined, they will be rendered as closed wires with the correct width
|-
| {{MenuCommand|Treat ellipses and splines as polylines}}
| The export of ellipses and splines is poorly supported. ??Still the case?? Use this option to export them as polylines instead.<br/>The setting '''Max Spline Segment''' is then the maximum length of each of the polyline segments. If it is set to '0' the whole spline is treated as a straight segment.
|-
| {{MenuCommand|Export 3D objects as polyface meshes}}
| If checked, all objects containing faces will be exported as 3D polyfaces
|-
| {{MenuCommand|Export Drawing Views as blocks}}
| If this is checked, Drawing Views will be exported as blocks. This might fail for post DXF R12 templates.
|-
| {{MenuCommand|Project exported objects along current view direction}}
| If checked, the exported objects will be projected to reflect the current view direction
|}
|}


[[Image:Mesh View Preferences.png]]
===IGES===


==Import-Export Settings==
The [https://en.wikipedia.org/wiki/IGES Initial Graphics Exchange Specification] (IGES) file format is a file format that allows the digital exchange of information among CAD systems. Since the specification for the [[Preferences_Editor#STEP|STEP]] file format was published, the development of IGES was stopped in 1996. It is nevertheless still supported by many CAD programs.

The tab ''IGES'' is only shown in the preferences if you are in the [[Part_Module|Part]] or [[PartDesign_Workbench|PartDesign]] workbench or if you have been in these workbenches before.<br/>For the IGES format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Units for export of IGES}}
| Selection what unit will be used when exporting IGES files
|-
| {{MenuCommand|Write solids and shells as}}
| Selection how solids and shells should be output.<br/>If '''Groups of Trimmed Surfaces (type 144)''' is selected, they will be exported as [https://wiki.eclipse.org/IGES_file_Specification#Trimmed_Surface_.28Type_144.29 trimmed surface].<br/>If '''Solids (type 186) and Shells (type 514) / B-REP mode''' is selected, solids will be exported as [https://wiki.eclipse.org/IGES_file_Specification#Manifold_Solid_B-Rep_Object_.28Type_186.29 manifold solid B-Rep object], shells as [https://wiki.eclipse.org/IGES_file_Specification#Shell_.28Type_514.29 shell].
|-
| {{MenuCommand|Skip blank entities}}
| If checked, blank [https://wiki.eclipse.org/IGES_file_Specification#Entities entities] will not be imported
|-
| {{MenuCommand|Company}}
| If not empty, the entered text will be used in the IGES file header for the company
|-
| {{MenuCommand|Author}}
| If not empty, the entered text will be used in the IGES file header for the author
|-
| {{MenuCommand|Product}}
| If not empty, the entered text will be used in the IGES file header for the product
|}

===IFC===

[http://en.wikipedia.org/wiki/Industry_Foundation_Classes Industry Foundation Classes] (IFC) is a wide spread format to interchange data between [http://en.wikipedia.org/wiki/Building_Information_Modeling BIM] applications, used in architecture and engineering.

For the IFC format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Show debug messages}}
| Shows verbose debug messages during import and export of IFC files in the ''Report view'' [[Std_Panels|panel]]
|-
| {{MenuCommand|Create clones when objects have shared geometry}}
| IFC objects can share a same geometry definition between several objects, only their placement is different. So when this option is enabled, clones are used to achieve the same result in FreeCAD. One object is the base object, the others are clones.
|-
| {{MenuCommand|Import arch IFC objects as}}
| What will be created in FreeCAD for arch IFC objects
|-
| {{MenuCommand|Import struct IFC objects as}}
| What will be created in FreeCAD for struct IFC objects
|-
| {{MenuCommand|Root element}}
| Only subtypes of the specified element will be imported. Keep the predefied element ''[http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifckernel/lexical/ifcproduct.htm IfcProduct]'' to import all building elements.
|-
| {{MenuCommand|Separate openings}}
| If checked, openings will be imported as subtractions, otherwise wall shapes will already have their openings subtracted
|-
| {{MenuCommand|Detect extrusions}}
| If checked, the importer will try to detect extrusions. Note that this might slow things down.
|-
| {{MenuCommand|Split multilayer walls}}
| Split walls made of multiple layers
|-
| {{MenuCommand|Prefix names with ID number}}
| If checked, object names will be prefixed with the [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcutilityresource/lexical/ifcgloballyuniqueid.htm IFC ID] number
|-
| {{MenuCommand|Merge materials with same name}}
| If several materials with the same name are found in the IFC file, they will be treated as one.
|-
| {{MenuCommand|Import Ifc Properties in spreadsheet}}
| If checked, each object will have their [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcpropertyresource/lexical/ifcproperty.htm IFC properties] stored in a spreadsheet object.
|-
| {{MenuCommand|Exclude list}}
| A comma-separated list of [http://www.buildingsmart-tech.org/ifc/IFC2x3/TC1/html/alphabeticalorder_entities.htm IFC entities] to be excluded from imports
|-
| {{MenuCommand|Fit view while importing}}
| Fit view during import on the imported objects. This will slow down the import, but one can watch the import.
|-
| {{MenuCommand|Force export as Brep}}
| Some IFC viewers don't like objects exported as extrusions. Use this to force all objects to be exported as [https://en.wikipedia.org/wiki/Boundary_representation BREP] geometry.
|-
| {{MenuCommand|Use DAE triangulation options}}
| Use triangulation options set in the DAE options page
|-
| {{MenuCommand|Join coplanar facets when triangulating}}
| Curved shapes that cannot be represented as curves in IFC are decomposed into flat facets. If this is checked, some additional calculation is done to join coplanar facets.
|-
| {{MenuCommand|Store IFC universal ID in FreeCAD objects}}
| When exporting objects without [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcutilityresource/lexical/ifcgloballyuniqueid.htm universal ID] (UID), the generated UID will be stored inside the FreeCAD object for reuse next time that object is exported. This leads to smaller differences between file versions.
|-
| {{MenuCommand|Use IfcOpenShell serializer if available}}
| [[Extra_python_modules#IfcOpenShell|IFCOpenShell]] is a library that allows to import IFC files. Its ''serializer'' functionality allows to give it an [[Glossary#OCC|OCC]] shape and it will produce an adequate IFC geometry: [https://en.wikipedia.org/wiki/Non-uniform_rational_B-spline NURBS], faceted, or anything else. Note that the serializer this is still an experimental feature.
|-
| {{MenuCommand|Export 2D objects as IfcAnnotations}}
| If checked, 2D objects will be exported as [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcproductextension/lexical/ifcannotation.htm IfcAnnotation]
|-
| {{MenuCommand|Export full FreeCAD parametric model}}
| If checked, all FreeCAD object properties will be stored inside the exported objects, allowing to recreate a full parametric model on reimport.
|-
| {{MenuCommand|Reuse similar entities}}
| If checked, similar entities will be used only once in the file if possible. This can reduce the file size a lot, but will make it less easily readable by humans.
|-
| {{MenuCommand|Disable IfcRectangleProfileDef}}
| When possible, IFC objects that are extruded rectangles are exported as [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcprofileresource/lexical/ifcrectangleprofiledef.htm IfcRectangleProfileDef]. However, some other applications have problems importing that entity. If this is your case, you can disable this and then all profiles will be exported as [http://www.buildingsmart-tech.org/ifc/IFC4/Add1/html/schema/ifcprofileresource/lexical/ifcarbitraryclosedprofiledef.htm IfcArbitraryClosedProfileDef].
|}

===INP===

INP is the input file format for the FEM software [https://en.wikipedia.org/wiki/Abaqus Abaqus]. It is used for the solver [[FEM_CalculiX|CalculiX]] in the [[FEM_Module|FEM workbench]].

The tab ''Abaqus INP'' is only shown in the preferences if you are or if you have been in the [[FEM_Module|FEM workbench]] before.<br/>For the INP format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Which mesh elements to export}}
| Selection what mesh element parameters should be exported.<br/>If '''All''' is selected, all elements will be exported.<br/>If '''Highest''' is selected, only the highest elements will be exported. This means for means volumes for a volume mesh and faces for a shell mesh.<br/>If '''FEM''' is selected, only FEM elements will be exported. This means only edges not belonging to faces and faces not belonging to volumes.
|-
| {{MenuCommand|Export group data}}
| If checked, mesh groups are exported too. Every constraint and, if there are different materials, material consists of two mesh groups, faces and nodes where the constraint or material is applied.
|}

===Mesh formats===

Meshes are a special type of 3D object, composed of triangular faces connected by their [[Glossary#Vertex|vertices]] and edges. They are widely used for [https://en.wikipedia.org/wiki/3D_printing additive manufacturing]. The FreeCAD provides the [[Mesh_Workbench|Mesh workbench]] to create and handle meshes.
FreeCAD supports the file formats [https://en.wikipedia.org/wiki/Additive_manufacturing_file_format AMF] and its predecessor [https://en.wikipedia.org/wiki/STL_(file_format) STL], [https://en.wikipedia.org/wiki/Wavefront_.obj_file OBJ], [https://en.wikipedia.org/wiki/OFF_(file_format) OFF], [https://en.wikipedia.org/wiki/PLY_(file_format) PLY] and [http://people.sc.fsu.edu/~jburkardt/data/smf/smf.html SMF].

The tab ''Mesh formats'' is only shown in the preferences if you are in the [[Mesh_Workbench|Mesh workbench]] or if you have been in this workbench before.<br/>For the Mesh formats you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Maximum mesh deviation}}
| Specification of the maximal deviation between the mesh and the object
|-
| {{MenuCommand|Export AMF files using compression}}
| If checked, ZIP compression is used when writing a mesh file in AMF format
|}

===OCA===

The [http://groups.google.com/group/open_cad_format OCA] file format is a community project to create a free, simple and open CAD file format.
OCA is largely based on the GCAD file format generated by [http://www.gcad3d.org/ gCAD3D]. Both formats can be imported in FreeCAD and the OCA files exported by FreeCAD can be opened in gCAD3D.

For the OCA format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Import OCA areas}}
| If checked, the areas (3D faces) will be imported too
|}

===STEP===

The [https://en.wikipedia.org/wiki/ISO_10303 standard for the exchange of product model data] (STEP) file format is an ISO standard for the computer-interpretable representation and exchange of product manufacturing information. STEP is therefore commonly used to exchange 3D data between CAD software. STEP files have the suffix {{FileName|.step}} or sometimes {{FileName|.stp}}.

The tab ''STEP'' is only shown in the preferences if you are in the [[Part_Module|Part]] or [[PartDesign_Workbench|PartDesign]] workbench or if you have been in these workbenches before.<br/>For the STEP format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Units for export of STEP}}
| Selection what unit will be used when exporting STEP files
|-
| {{MenuCommand|Write out curves in parametric space of surface}}
| If checked, parametric curves (curves in parametric space of surface) will be written into the STEP file. Unchecking the option can be helpful to minimize the size of the resulting STEP file.
|-
| {{MenuCommand|Scheme}}
| Selection what STEP application protocol (AP) will be used for the export.<br/>'''AP 203''' is the protocol for configuration controlled 3D designs of mechanical parts and assemblies.<br/>'''AP 204''' is the protocol for core data for automotive mechanical design processes.
|-
| {{MenuCommand|Enable STEP Compound merge}}
| If checked, a [[Glossary#Compound|compound]] merge will be done during file reading. This is slower but results in higher details.
|-
| {{MenuCommand|Company}}
| If not empty, the entered text will be used in the STEP file header for the company
|-
| {{MenuCommand|Author}}
| If not empty, the entered text will be used in the STEP file header for the author
|-
| {{MenuCommand|Product}}
| If not empty, the entered text will be used in the STEP file header for the product
|}

===SVG===

[https://en.wikipedia.org/wiki/Scalable_Vector_Graphics Scalable Vector Graphics] (SVG) is a [https://en.wikipedia.org/wiki/Vector_graphics vector image] format for two-dimensional graphics. The vectors make SVG are very useful for technical drawing programs like FreeCAD's [[TechDraw_Module|TechDraw]] because a vector image can be scaled to any size without losing its shape or amount of details. SVG can be scaled to any required resolution and converted to bitmap formats like PNG or JPEG for printing.

For the SVG format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Import style}}
| Selection how SVG object colors and line widths will be imported.<br/>If '''None (fastest)''' is selected no color and line width settings will be imported.<br/>If '''Use default color and linewidth''' is selected FreeCAD will use its default color and line width.<br/>If '''Original color and linewidth''' is selected FreeCAD will use the color and linewidth from the SVG objects.
|-
| {{MenuCommand|Disable units scaling}}
| If checked, no units conversion will occur. One unit in the SVG file will translate as one millimeter.
|-
| {{MenuCommand|Export style}}
| Selection how Sketches are exported to SVG.<br/>If '''Translated (for print & display)''' is selected, SVG objects are encapsulated in a group that is scaled and moved to the correct place in the SVG document to fit into a printable area.<br/>If '''Raw (for CAM)''' is selected, SVG objects are placed as they are - at the same coordinates as in the FreeCAD model (1:1 export).
|-
| {{MenuCommand|Translate white line color to black}}
| If checked, all white lines will appear in black in the SVG for better readability against white backgrounds
|-
| {{MenuCommand|Max segment length for discretized arcs}}
| Older versions of [[Glossary#Open_CASCADE|Open CASCADE]] than version 6.8 don't support arc projection. In this case arcs will be discretized into small line segments. This value is the maximum segment length.
|}

===VTK===

The [https://en.wikipedia.org/wiki/VTK Visualization Toolkit] (VTK) is an open-source, freely available software system for 3D computer graphics, image processing and visualization. VTK files are used by the [[FEM_Module|FEM workbench]] for the [[FEM_Post_Processing_based_on_VTK|post processing]] of simulation results.

The tab ''VTK'' is only shown in the preferences if you are or if you have been in the [[FEM_Module|FEM workbench]] before.<br/>For the VTK format you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Which object to import into}}
| Selection what objects should be imported.<br/>If '''VTK result object''' is selected, a FreeCAD FEM VTK result object will be imported (equals to the object which was exported).<br/>If '''FEM mesh object''' is selected, the results in the VTK file will be omitted, only the mesh data will be imported and a FreeCAD FEM mesh object will be created.<br/>If '''FreeCAD result object''' is selected, the imported data will be converted into a FreeCAD FEM Result object. '''Note:''' this setting needs the exact result component names and thus it only works properly with VTK files exported from FreeCAD.
|}


The Import-Export settings affect how files are imported and exported to and from FreeCAD. They are described in the page [[Import_Export_Preferences|Import Export Preferences]].


<div class="mw-translate-fuzzy">
==工作台首选项==
==工作台首选项==
下列为常用工作台的首选项。部分工作台并没有对应的首选项。其他可选工作台可能也未列入其中。
下列为常用工作台的首选项。部分工作台并没有对应的首选项。其他可选工作台可能也未列入其中。
</div>




{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each core workbench}}
[[A2plus_Workbench#Preferences|A2plus工作台首选项]]

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">
[[Arch Preferences|Arch工作台首选项]]
[[Arch Preferences|Arch工作台首选项]]
</div>


=== External workbenches ===
[[Draft Preferences|Draft工作台首选项]]


Drawing工作台首选项 (不存在)


{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each [[External Workbenches|External workbench]]}}
[[Fem Preferences|Fem工作台首选项]]


<div class="mw-translate-fuzzy">
Image工作台首选项 (不存在)
[[A2plus_Workbench#Preferences|A2plus工作台首选项]]

</div>
Inspection Preferences (none)

Mesh Design Preferences (none)

[[OpenSCAD_Module#Preferences|OpenSCAD Preferences]]

Part Preferences (none)

Part Design Preferences (none)

[[Path_Workbench#Preferences|Path Preferences]]

Plot Preferences (none)

Points Preferences (none)

[[Raytracing_Module#Preferences|Raytracing Préférences]]

Reverse Engineering Preferences (none)

Robot Preferences (none)

Ship Preferences (none)

[[Sketcher_Workbench#Preferences|Sketcher Preferences]]

Spreadsheet Preferences (none)

Surface Preferences (none)

[[TechDraw Preferences#Preferences|TechDraw Preferences]]

Test Framework Preferences (none)


Web Preferences (none)


{{Docnav
{{docnav|Document structure|Interface Customization}}
|[[Document_structure|Document structure]]
|[[Import_Export_Preferences|Import Export Preferences]]
}}


[[Category:User Documentation/zh-cn]]
[[Category:Preferences{{#translation:}}]]
{{Userdocnavi{{#translation:}}}}

Revision as of 21:44, 13 September 2020

Introduction

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

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

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

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

通用设置

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

General

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

名称 描述
Change language 选择FreeCAD的用户界面语言
Size of recent file list 指定有多少最近用过的文件显示在recent files列表中
Enable tiled background 如果选中此复选框,则FreeCAD的主窗口背景将默认由以下图片填充:
本选项只有在Style sheet/No style sheet被选中时才会生效。
将图片加入到下列路径中的Gui/Images文件夹下即可改变贴图内容
%APPDATA%/FreeCAD (在Windows上),
$HOME/.FreeCAD (在Linux上) or
$HOME/Library/Preferences/FreeCAD (在MacOS上)。
将图片文件命名为background.png,再依次取消/选中本选项来查看效果。
Style sheet 选择样式表。样式表定义了FreeCAD用户界面的外观。
Size of toolbar icons 选择工具栏图标的大小。
Auto load module after start up 选择FreeCAD开启后将直接打开的工作台。
Enable splash screen at start up 如果选中此项, 则在FreeCAD开启时展示启动画面。
可通过向%APPDATA%/FreeCAD( %APPDATA%是用户在操作系统中为FreeCAD指定的应用文件夹)添加Gui/Images文件夹来修改启动画面。将作为启动画面的图像命名为splash_image.png并重启FreeCAD即可看到效果。
Enable word wrap 利用此选项可实现在Python控制台中令超出一行中的文本自动换行。利用View → Panels → Python console菜单来开启Python控制台。

This option only has an effect if in Style sheet/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).

Put there a file named background.png and uncheck/check this option to see the changed file. |- | Style sheet | Selection of a style sheet. The style sheets define how the user interface of FreeCAD looks. |- | Size of toolbar icons | Selection of the size for the toolbar icons |- | Tree view mode | Customization how the tree view is shown in the panel (restart required). The options are:

  • Combo View: combine tree view and property view into one panel.
  • TreeView and PropertyView: split tree view and property view into separate panel.
  • Both: keep all three panels, and you can have two sets of tree view and property view.

|- | Auto load module after start up | Selection what workbench will be used directly after starting FreeCAD |- | Enable splash screen at start up | If checked, the splash screen of FreeCAD is shown when starting.

The splash screen image can be changed by adding the folders Gui/Images in the folder %APPDATA%/FreeCAD (where %APPDATA% is the the user-specific application folder of FreeCAD of your operating system). Put there a file named splash_image.png and restart FreeCAD to see the changed splash screen. |- | 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 View → Panels → Python console. |}

Document

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

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

Editor

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

The color and font settings also affect the Python console. This console is shown using the menu View → Panels → Python console.

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

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

Output window

The output preferences affect the behavior of the Report view.

In the Output tab you can specify the following:

Name Description
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 Log messages. This panel is shown using the menu View → Panels → Report view.
Record warnings If checked, warnings will be recorded. They will be output in the Report view panel with the color set in Warnings.
Record error messages If checked, error messages will be recorded. They will be output in the Report view panel with the color set in Errors
Show report view on error or warning If checked, the report view panel will show up automatically when an error or warning is logged.
Normal messages Specification of the font color for normal messages in the Report view panel.
Log messages Specification of the font color for log messages in the Report view panel.
Warnings Specification of the font color for warning messages in the Report view panel.
Errors Specification of the font color for error messages in the Report view panel.
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 View → Panels → Python console
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.

Macro

These options control certain aspects of running macros.

In 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 variable
Macro path Specification of a path to macro files
Recording 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 visible actions when running the macro but to see what could be done visibly.
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 View → Panels → Python console.
Size of recent macros 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.

Units

This tab configures how Units are shown.

In the Units tab you can specify the following:

Name Description
User system Selection of a unit system that should be used for all parts of FreeCAD
Number of decimals The number of decimals that should be shown for numbers and dimensions in FreeCAD
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.

Display settings

This preferences section has two general tabs, 3D View and Colors, and further tabs depending in the used workbenches.

3D View

This tab is always available, and controls certain characteristics of the 3D view.

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

Name Description
Show coordinate system in the corner If checked, the main coordinate system will always be shown at the lower right in opened files
Show axis cross by default introduced in version 0.19 If checked, the axis cross will be shown by default at file opening or creation
Show counter of frames per second If checked, the time needed for the last operation and the resulting frame rate will always be shown at the lower left in opened files
Remember active workbench by tab introduced in 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 multiple-document interface (MDI) view.
Use OpenGL 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 GPU. For more background info see this webpage.
Render Cache introduced in version 0.19 "Render Cache" or "Render Acceleration" is explained in more detail in Link#render-caching. There are 3 options:
  • Auto (default), let Coin3D decide where to cache.
  • 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 Selection if and what kind of multisample anti-aliasing is used
Transparent objects introduced in version 0.19 Render type of transparent objects. The types are:
  • One pass (default), rendering is done in one pass. For non-solid objects like faces or meshes this can lead to artifacts. This image shows such an artifact (black triangle) and that the type Backface pass avoids this.
  • 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.
Marker size Selection of the size of vertices (points) in the Sketcher workbench. The clickable area of points can be additionally enlarged by increasing Pick radius (on Colors tab).
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 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 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.

The related Intensity setting specifies the intensity of the backlight.

Camera type Selection of the camera projection type.


Navigation

This tab is always available, and controls the behavior of the navigation tools.


In the Navigation tab you can specify the following:

Name Description
Navigation cube If checked, the navigation cube will always be shown. Related Steps by turn defines how many steps (notches) will be applied when using the Navigation cube rotation arrows. Related Corner defines where the Navigation cube is displayed on the screen when creating/opening a document
3D Navigation Selection of a navigation settings set. To see what each set defines, select a set and press the button Mouse....
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.
New Document Camera Orientation Selection of the camera orientation for new documents
New Document Scale 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).
Enable animation If checked, rotations can be animated. If for example the 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.
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, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the 3D Navigation set Gesture.
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.

Colors

This tab is always available.

In the Colors tab you can specify the following:

Name Description
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.
Enable selection highlighting If checked, selection highlighting is turned on and the specified color will be used for it
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.
Simple color If selected, the background for parts will have the selected color
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.
Middle color Is only enabled if Color gradient is selected. If checked, the color gradient will get the selected color as middle color.
Object being edited Selection of the background color for objects in the tree view that are currently edited
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 active body, it will get the selected background color in the tree view.

Part colors

This tab is only shown if you are in the Part or PartDesign Workbench or if you have been in these workbenches before.

In the Part colors tab you can specify the following:

Name Description
Shape color Color for new shapes. If the option Random is set, a random color is used instead.
Line color Line color for new shapes
Line width Line thickness for new shapes
Vertex color Color for new vertices
Vertex size Size for new vertices
Bounding box color Color of bounding boxes in the 3D view
Two-side rendering 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.
Text color 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:

obj=App.ActiveDocument.addObject("App::Annotation", "Label")

This console is shown using the menu View → Panels → Python console.

Mesh view

This tab is only shown if you are in the Mesh Workbench or if you have been in this workbench before.

In the Mesh view tab you can specify the following:

Name Description
Default mesh color Selection of the default color for new meshes
Default line color Selection of the default line color for new meshes
Mesh transparency Specification of the default mesh transparency for new meshes
Line transparency Specification of the default line transparency for new meshes
Two-side rendering 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 Enable backlight color (see section 3D view). Either the backlight color will be used or black.
Show bounding-box for highlighted or selected meshes If checked, a yellow bounding box will be displayed for highlighted or selected meshes.
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 that leads to a unreal appearance for curved surfaces while using Phong shading leads to a 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

Import-Export Settings

The Import-Export settings affect how files are imported and exported to and from FreeCAD. They are described in the page Import Export Preferences.

工作台首选项

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


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

External workbenches

This section is incomplete and requires mentioning the preference pages of each External workbench