Preferences Editor/pt-br: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(26 intermediate revisions by 2 users not shown)
Line 8: Line 8:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
==Introdução==
==Introdução==


To start the '''Preferences editor''' select the {{MenuCommand|Edit → Preferences...}} option from the menu. On the Mac OS the {{MenuCommand|Preferences...}} option appears in the {{MenuCommand|FreeCAD}} menu instead (this is the default place for preferences on the Mac).
To start the '''Preferences editor''' select the {{MenuCommand|Edit → Preferences...}} option from the menu. On macOS the {{MenuCommand|Preferences...}} option appears in the {{MenuCommand|FreeCAD}} menu instead (this is the default place for preferences on the Mac).


FreeCAD uses a workbench concept, where each workbench is responsible for specific tasks and functions. A workbench can have its own preferences. These will only appear in the Preferences editor if the workbench has been loaded in the current FreeCAD session. See [[#Workbenches|Workbenches]] below for more information.
FreeCAD uses a workbench concept, where each workbench is responsible for specific tasks and functions. A workbench can have its own preferences. These will only appear in the Preferences editor, usually in a dedicated section, if the workbench has been loaded in the current FreeCAD session. Some workbenches add support for specific import and export formats. If there are any related preferences they will appear on one or more additional tabs in the [[#Import-Export|Import-Export]] section of the Preferences editor.


To preserve resources, FreeCAD does not automatically load all available workbenches. See [[#Workbenches|Workbenches]] for more information. For a list of workbench related preferences see [[#Workbench_related_preferences|Workbench related preferences]].
If no workbench is loaded, four sections appear in the Preferences editor: [[#General_settings|General]], [[#Display_settings|Display]], [[#Workbenches|Workbenches]], and [[#Import-Export_settings|Import-Export]]. Any workbenches that have been loaded, and have their own preferences, will appear below these.


If no workbench is loaded, six sections appear in the Preferences editor: [[#General|General]], [[#Display|Display]], [[#Workbenches|Workbenches]], [[#Python|Python]], [[#Addon_Manager|Addon Manager]] and [[#Import-Export|Import-Export]]. Any workbenches that have been loaded, and have their own preferences, will appear below these.
Please note that pressing the {{Button|Reset}} button in the lower left corner of the Preferences dialog will reset '''all''' FreeCAD preferences to their default values.

Pressing the {{Button|Reset}} button in the lower left corner of the Preferences dialog opens a menu ({{Version|0.22}}) with options to reset preferences to their default values. You can reset the current tab, the current group, or all preferences. In {{VersionMinus|0.21}} the button will reset '''all''' preferences.


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


==General settings==
==General==


This preferences section has 7 tabs: General, Document, Selection, Editor, Output window, Macro, and Units.
This preferences section has seven tabs: General, Document, Selection, Cache, Notification Area, Report view and Help.


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

<span id="General"></span>
===Geral===
===Geral===


Line 40: Line 46:
|-
|-
| {{MenuCommand|Ativar fundo em mosaico}}
| {{MenuCommand|Ativar fundo em mosaico}}
| If checked, the background of FreeCAD's main window will by default consist of tiles of this image [[FileBackground.png|64px]]
| If checked, the background of FreeCAD's main window will by default consist of tiles of this image [[File:Background.png|64px]]
</div>
</div>

Optionally, imported files can be excluded from this list, and exported files can be included. See [[Fine-tuning|Fine-tuning]].
|-
| {{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.
This option only has an effect if no {{MenuCommand|Style sheet}} is selected.
Line 51: Line 62:
{{FileName|$HOME/.FreeCAD}} (on Linux) or
{{FileName|$HOME/.FreeCAD}} (on Linux) or


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


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 83: Line 94:
</div>
</div>


[[Image:Preferences_General_Tab_General_pt-br.png]]
[[Image:Preferences_General_Tab_General.png]]


<span id="Document"></span>
===Documento===
===Documento===


Line 119: Line 131:
|-
|-
| {{MenuCommand|Adicionar o logotipo do programa à miniatura gerada}}
| {{MenuCommand|Adicionar o logotipo do programa à miniatura gerada}}
| If checked, the FreeCAD program logo [[imageFreeCAD-logo.svg|24px]] will be added to the thumbnail.
| If checked, the FreeCAD program logo [[Image:FreeCAD-logo.svg|24px]] will be added to the thumbnail.
|-
|-
| {{MenuCommand|Número máximo de arquivos de backup a manter quando salvar novamente o documento}}
| {{MenuCommand|Número máximo de arquivos de backup a manter quando salvar novamente o documento}}
Line 148: Line 160:
</div>
</div>


[[Image:Preferences_General_Tab_Document_pt-br.png]]
[[Image:Preferences_General_Tab_Document.png]]


<span id="Selection"></span>
===Seleção===
===Seleção===


On the ''Selection'' tab ({{Version|0.19}}) you can specify the following:
On the ''Selection'' tab you can specify the following:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 176: Line 189:
</div>
</div>


[[Image:Preferences_General_Tab_Selection_pt-br.png]]
[[Image:Preferences_General_Tab_Selection.png]]


===Editor===
===Cache===


These preferences are related to the cache directory where FreeCAD stores temporary files.
The editor preferences settings affect the behavior of the macro editor. This editor can be opened using the menu {{MenuCommand|Macro → Macros... → Edit/Create}}.


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


{| class="wikitable float-right mw-collapsible mw-collapsed"
On the ''Editor'' tab you can specify the following:
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Location}}
| 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|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'''
|-
| {{MenuCommand|Current cache size}}
| 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]]

===Notification Area===

These preferences control the Notification Area and its notifications.

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


<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|Name
!style="width: 33%;"|Name
!style="width 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Ativar números de linha}}
| {{MenuCommand|Enable Notification Area}}
| If checked, the code lines will be numbered
| If checked, the Notification Area will appear in the status bar.
|-
|-
| {{MenuCommand|Tamanho da tabulação}}
| {{MenuCommand|Enable non-intrusive notifications}}
| If checked, non-intrusive notifications will appear next to the Notification Area in the status bar.
| 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 on the current cursor position. This setting is only used if {{MenuCommand|Manter abas}} is selected.
|-
|-
| {{MenuCommand|Tamanho da indentação}}
| {{MenuCommand|Errors}}
| If checked, errors will appear in the Notification Area.
| Specification of how many spaces will be inserted when pressing {{KEY|Tab}}. This setting is only used if {{MenuCommand|Inserir espaços}} is selected.
|-
|-
| {{MenuCommand|Manter abas}}
| {{MenuCommand|Warnings}}
| If checked, warnings will appear in the Notification Area.
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tamanho da tabulação}}
|-
|-
| {{MenuCommand|Inserir espaços}}
| {{MenuCommand|Maximum Duration}}
| Maximum duration during which notifications are shown (unless mouse buttons are clicked).
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Tamanho da indentação}}
|-
|-
| {{MenuCommand|Display Items}}
| {{MenuCommand|Minimum Duration}}
| Minimum duration (idem).
| Selection of the code type. The color and font settings will be applied to the selected type. The result can be checked in the '''Preview''' field.
|-
|-
| {{MenuCommand|Família}}
| {{MenuCommand|Maximum Number of Notifications}}
| Maximum number of notifications shown simultaneously.
| Specification of the font family that should be used for the selected code type
|-
|-
| {{MenuCommand|Tamanho}}
| {{MenuCommand|Notification width}}
| Width of the Notification Area in pixels.
| Specification of the font size that should be used for the selected code type
|-
|-
| {{MenuCommand|Cor}}
| {{MenuCommand|Hide when other window is activated}}
| If checked, open notifications will disappear when another window is activated.
| Specification of the color that should be used for the selected code type
|-
| {{MenuCommand|Do not show when inactive}}
| If checked, notifications will not appear if the FreeCAD window is not the active window.
|-
| {{MenuCommand|Maximum Messages (0 &#61; no limit)}}
| The maximum number of messages kept in the list. Set to 0 for no limit.
|-
| {{MenuCommand|Auto-remove User Notifications}}
| If checked, notifications will be removed from the message list when the '''Maximum Duration''' has elapsed.
|}
|}
</div>


[[Image:Preferences_General_Tab_Editor_pt-br.png]]
[[Image:Preferences_General_Tab_Notification_Area.png]]


===Janela de saída===
===Report view===


The output preferences affect the behavior of the [[Report_view|Report view]]. This panel is shown using the menu {{MenuCommand|View → Panels → Report view}}.
These preferences control the behavior of the [[Report_view|Report view]]. This panel can be opened using the {{MenuCommand|View → Panels → Report view}} menu option.


On the ''Output'' tab you can specify the following:
On the ''Report view'' tab you can specify the following:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 283: Line 338:
</div>
</div>


[[Image:Preferences_General_Tab_Output_window_pt-br.png]]
[[Image:Preferences_General_Tab_Report_view.png]]


===Macro===
===Help===


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


<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|Name
!style="width: 33%;"|Name
!style="width 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Executar macros no ambiente local}}
| {{MenuCommand|Help location}}
| Specifies the location of the Help files. The options are:
| If checked, variables defined by macros are created as local variables, otherwise as global Python variables
* {{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|Caminho de macro}}
| {{MenuCommand|Display}}
| Specifies where the documentation should be displayed. The options are:
| Specification of the path for macro files
* {{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|Gravar comandos na GUI}}
| {{MenuCommand|Custom stylesheet}}
| Specifies an optional custom stylesheet. Not used for the Wiki URL.
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands
|-
| {{MenuCommand|Gravar como comentário}}
| 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|Mostrar os comandos de script no console python}}
| If checked, the commands executed by macro scripts are shown in the Python console. This console is shown using the {{MenuCommand|View → Panels → Python console}} menu option.
|-
| {{MenuCommand|Size of recent macros list}}
| Controls the number of recent macros to display in the menu
|-
| {{MenuCommand|Contagem de atalhos}}
| Controls the number of recent macros that get dynamically assigned shortcuts
|-
| {{MenuCommand|Modificadores de Teclado}}
| Controls which keyboard modifiers are used for the shortcuts, example '''Ctrl+Shift+''' creates shortcuts in the form of '''Ctrl+Shift+1''', '''Ctrl+Shift+2''', etc.
|}
|}
</div>


[[Image:Preferences_General_Tab_Macro_pt-br.png]]
[[Image:Preferences_General_Tab_Help.png]]


===Unidades===
==Display==

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

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|Name
!style="width 66%;"|Description
|-
| {{MenuCommand|User system}}
| Selection of the unit system to be used for all parts of FreeCAD
|-
| {{MenuCommand|Número de casas decimais}}
| The number of decimals that should be shown for numbers and dimensions
|-
| {{MenuCommand|Fração mínima das polegadas}}
| Fração mínima das polegadas that should be displayed. This setting is only available if the unit system '''Building US (ft-in/sqft/cuft)''' is used.
|}
</div>

[[Image:Preferences_General_Tab_Units_pt-br.png]]

==Display settings==


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


<span id="3D_View"></span>
===Vista 3D===
===Vista 3D===


Line 357: Line 380:
|-
|-
| {{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}}
| {{MenuCommand|Show axis cross by default}}
| If checked, the axis cross will be shown by default at file opening or creation
| 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|Use software OpenGL}}
| 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 software OpenGL}} {{Version|0.19}}
| If checked, [https://en.wikipedia.org/wiki/OpenGL OpenGL] will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application.
| If checked, [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)}}
| {{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 this webpage].
| If checked, [https://en.wikipedia.org/wiki/Vertex_Buffer_Object Vertex Buffer Objects] (VBO) will be used. A VBO is an [https://en.wikipedia.org/wiki/OpenGL OpenGL] feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects Understanding OpenGL Objects].
|-
|-
| {{MenuCommand|Render Cache}} {{Version|0.19}}
| {{MenuCommand|Render Cache}}
| "Render Cache" or "Render Acceleration" is explained in more detail in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link#render-caching FreeCAD_assembly3 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}}
| 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 the {{MenuCommand|Pick radius}}.
| 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)}}
| {{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.
| 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 the 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 used for objects whose Lighting property (on the View tab) is set to '''One side'''. If disabled, the back side of the faces of those objects will be black.
The related {{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:Preferences_Display_Tab_3D_View.png]]


<span id="Navigation"></span>
===Navegação===
===Navegação===


On the ''Navigation'' tab you can specify the following:
On the ''Navigation'' tab you can specify the following:
Line 419: Line 440:
|-
|-
| {{MenuCommand|Navigation cube}}
| {{MenuCommand|Navigation cube}}
| If checked, the [[Navigation_Cube|Navigation cube]] will always be shown.
| 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|Steps by turn}} defines the number of steps required for a full rotation when using the Navigation cube rotation arrows.


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

If {{MenuCommand|Rotate to nearest}} is checked, the 3D view is rotated to the nearest most logical state when a cube face is clicked. When it is off, clicking to a cube face will and up always to the same position, no matter in what cube state you were when you clicked the face. {{Version|0.20}}


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

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

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

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

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

|-
|-
| {{MenuCommand|3D Navigation}}
| {{MenuCommand|3D Navigation}}
| Selection of a [[Mouse_navigation|navigation settings set]]. To see what each set defines, select it and then press the {{Button|Mouse...}} button.
| 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}}
| Specifies the rotation orbit style used when in rotation mode. The options are:
| Selection of the rotation orbit style. When viewing a part in the x-y plane and 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.
* '''Turntable''': Moving the mouse will divide the rotation in steps, rotations around the different axes are performed sequentially.
* '''Trackball''': Rotations around the different axes are performed simultaneously.
* '''Free Turntable''': Like '''Trackball''', but if possible the rotation axis is kept collinear with the global 3D view axis. {{Version|0.21}}
|-
|-
| {{MenuCommand|Rotation mode}}
| {{MenuCommand|Rotation mode}}
| Defines the rotation center. Select '''Window center''', '''Drag at cursor''', or '''Object center'''.
| Defines the rotation center. The options are:
* '''Window center'''
* '''Drag at cursor'''
* '''Object center'''
|-
|-
| {{MenuCommand|Default camera orientation}}
| {{MenuCommand|Default camera orientation}}
| Selection of the camera orientation for new documents. This setting is also used by the [[Std_ViewHome|Std ViewHome]] command.
| Specifies the camera orientation for new documents. This setting is also used by the [[Std_ViewHome|Std ViewHome]] command.
|-
|-
| {{MenuCommand|New document scale}}
| {{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. Default is 100 mm. It also sets the initial size of origin features (base planes in new [[PartDesign_Body|PartDesign Bodies]]).
| 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 are 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|Enable rotation center indication}}
| If checked, the rotation center of the view is shown when dragging. {{Version|0.22}}
|}
|}


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


<span id="Colors"></span>
===Cores===
===Cores===


Line 468: Line 510:
|-
|-
| {{MenuCommand|Enable preselection highlighting}}
| {{MenuCommand|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.
| If checked, preselection is turned on and the specified color will be used for it. Preselection means that for example edges of objects will be highlighted while hovering over them with the mouse to indicate they can be selected.
|-
|-
| {{MenuCommand|Enable selection highlighting}}
| {{MenuCommand|Enable selection highlighting}}
| If checked, selection highlighting is turned on and the specified color will be used for it
| If checked, selection highlighting is turned on and the specified color will be used for it.
|-
|-
| {{MenuCommand|Simple color}}
| {{MenuCommand|Simple color}}
| If selected, the background of the [[3D_view|3D view]] will have the selected color
| If selected, the background of the [[3D_view|3D view]] will have the specified color.
|-
|-
| {{MenuCommand|Color gradient}}
| {{MenuCommand|Linear gradient}}
| If selected, the background of the [[3D_view|3D view]] will have a vertical color gradient. The first color is the color at the top of the 3D view, the second the color at the bottom.
| If selected, the background of the [[3D_view|3D view]] will have a vertical color gradient defined by the specified '''Top''' and '''Bottom''' colors. if enabled, a '''Middle''' color can also be specified. Press the {{Button|[[Image:Button_sort.svg|16px]]}} button ({{Version|0.21}}) to switch the top and bottom colors.
|-
|-
| {{MenuCommand|Middle color}}
| {{MenuCommand|Radial gradient}} {{Version|0.21}}
| If selected, the background of the [[3D_view|3D view]] will have a radial color gradient defined by the specified '''Central''' and '''End''' colors. if enabled, a '''Midway''' color can also be specified. Press the {{Button|[[Image:Button_sort.svg|16px]]}} button to switch the central and end colors.
| Is only enabled if {{MenuCommand|Color gradient}} is selected. If checked, the color gradient will get the selected color as 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 an [[PartDesign_Body#Active_Status|active PartDesign Body]] will get the selected background color.
| 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:Preferences_Display_Tab_Colors.png]]
[[Image:Preferences_Display_Tab_Colors.png]]


<span id="Mesh_view"></span>
===Vista de malhas===
===Vista de malhas===


Line 502: Line 545:
|-
|-
| {{MenuCommand|Default mesh color}}
| {{MenuCommand|Default mesh color}}
| Selection of the default shape color
| Specifies the default face color.
|-
|-
| {{MenuCommand|Default line color}}
| {{MenuCommand|Default line color}}
| Selection of the default line color
| Specifies the default line color.
|-
|-
| {{MenuCommand|Mesh transparency}}
| {{MenuCommand|Mesh transparency}}
| Specification of the default mesh transparency
| Specifies the default mesh transparency.
|-
|-
| {{MenuCommand|Line transparency}}
| {{MenuCommand|Line transparency}}
| Specification of the default line transparency
| Specifies the default line transparency.
|-
|-
| {{MenuCommand|Two-side rendering}}
| {{MenuCommand|Two-side rendering}}
| If checked, the color of the interior side of faces will be the same as the exterior side. If not checked either the [[#3D_View|backlight color]], if enabled, or black will be used instead.
| 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|Show bounding-box for highlighted or selected meshes}}
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}}
| If checked, a yellow bounding box will be displayed for highlighted or selected meshes
| If checked, the default value for the {{PropertyView|Selection Style}} property is {{value|BoundBox}} instead of {{value|Shape}}. {{value|BoundBox}} means a highlighted bounding box is displayed if meshes are highlighted or selected. {{value|Shape}} means the shape itself is then highlighted.
|-
|-
| {{MenuCommand|Define normal per vertex}}
| {{MenuCommand|Define normal per vertex}}
| If checked, [https://en.wikipedia.org/wiki/Phong_shading Phong shading] is used, otherwise flat shading. Shading defines the appearance of surfaces. With flat shading the surface normals are not defined per vertex. This leads to an unrealistic appearance for curved surfaces. While Phong shading leads to a more realistic, smoother appearance.
| 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|Crease angle}}
| {{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.
| 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, facet shading is used.
:If face angle < crease angle, smooth shading is used
:If face angle < crease angle, smooth shading is used.
|}
|}


[[Image:Preferences_Display_Tab_Mesh_view.png]]
[[Image:Preferences_Display_Tab_Mesh_view.png]]


<span id="Workbenches"></span>
===Bancadas de trabalho===
===Bancadas de trabalho===


This preferences section has a single tab: Available Workbenches.
This preferences section has a single tab: Available Workbenches.


<span id="Available_Workbenches"></span>
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
===Bancadas de trabalho descarregadas===
===Bancadas de trabalho descarregadas===
</div>
</div>


These preferences control workbench loading.
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.


On the ''Available Workbenches'' tab you can specify the following:
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.


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


[[Image:Preferences_Workbenches_Tab_Available_Workbenches.png]]
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_settings|Import-Export settings]] section of the Preferences editor.


==Python==
For a list of workbench preferences see [[#Workbench_preferences|Workbench preferences]]


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


===Macro===
==Import-Export settings==


On the ''Macro'' tab you can specify the following:
The Import-Export settings affect how files are imported and exported. They are described on the [[Import_Export_Preferences|Import Export Preferences]] page.


<div class="mw-translate-fuzzy">
==Preferências da bancada de trabalho==
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|Name
!style="width 66%;"|Description
|-
| {{MenuCommand|Executar macros no ambiente local}}
| If checked, variables defined by macros are created as local variables, otherwise as global Python variables
|-
| {{MenuCommand|Caminho de macro}}
| Specification of the path for macro files
|-
| {{MenuCommand|Gravar comandos na GUI}}
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands
|-
| {{MenuCommand|Gravar como comentário}}
| 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|Mostrar os comandos de script no console python}}
| If checked, the commands executed by macro scripts are shown in the Python console. This console is shown using the {{MenuCommand|View → Panels → Python console}} menu option.
|-
| {{MenuCommand|Size of recent macros list}}
| Controls the number of recent macros to display in the menu
|-
| {{MenuCommand|Contagem de atalhos}}
| Controls the number of recent macros that get dynamically assigned shortcuts
|-
| {{MenuCommand|Modificadores de Teclado}}
| Controls which keyboard modifiers are used for the shortcuts, example '''Ctrl+Shift+''' creates shortcuts in the form of '''Ctrl+Shift+1''', '''Ctrl+Shift+2''', etc.
|}
</div>


[[Image:Preferences_Python_Tab_Macro.png]]
{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each core workbench}}


===Python console===
Preferences for the more common workbenches are linked below.

Some workbenches have no preferences.
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.
Other optional workbenches may not be listed. These links are also listed in [[:Category:Preferences]]

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:Preferences_Python_Tab_Python_console.png]]

===Editor===

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:

<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width 33%;"|Name
!style="width 66%;"|Description
|-
| {{MenuCommand|Ativar números de linha}}
| If checked, the code lines will be numbered
|-
| {{MenuCommand|Tamanho da tabulação}}
| 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 on the current cursor position. This setting is only used if {{MenuCommand|Manter abas}} is selected.
|-
| {{MenuCommand|Tamanho da indentação}}
| Specification of how many spaces will be inserted when pressing {{KEY|Tab}}. This setting is only used if {{MenuCommand|Inserir espaços}} is selected.
|-
| {{MenuCommand|Manter abas}}
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tamanho da tabulação}}
|-
| {{MenuCommand|Inserir espaços}}
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Tamanho da indentação}}
|-
| {{MenuCommand|Display Items}}
| Selection of the code type. The color and font settings will be applied to the selected type. The result can be checked in the '''Preview''' field.
|-
| {{MenuCommand|Família}}
| Specification of the font family that should be used for the selected code type
|-
| {{MenuCommand|Tamanho}}
| Specification of the font size that should be used for the selected code type
|-
| {{MenuCommand|Cor}}
| Specification of the color that should be used for the selected code type
|}
</div>

[[Image:Preferences_Python_Tab_Editor.png]]

==Addon Manager==

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

===Addon manager options===

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

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

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

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

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

[[Image:Preferences_Addon_Manager_Tab_Addon_manager_options.png]]

==Import-Export==

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

<span id="Workbench_related_preferences"></span>
<div class="mw-translate-fuzzy">
==Preferências da bancada de trabalho==
</div>

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


* [[Arch_Preferences|Arch Preferences]]
* [[Arch_Preferences|Arch Preferences]]
* [[Draft_Preferences|Draft Preferences]]
* [[Draft_Preferences|Draft Preferences]]
* Drawing Preferences (none) {{Obsolete|0.16}}
* [[FEM_Preferences|FEM Preferences]]
* [[FEM_Preferences|FEM Preferences]]
* Image Preferences (none)
* Inspection Preferences (none)
* Inspection Preferences (none)
* Mesh Design Preferences (none)
* [[Mesh_Workbench#Preferences|Mesh Design Preferences]]
* [[OpenSCAD_Preferences|OpenSCAD Preferences]]
* [[OpenSCAD_Preferences|OpenSCAD Preferences]]
<!--The PartDesign preferences are defined in the Part workbench and both the PartDesign workbench and the Part workbench use them-->
<!--The PartDesign preferences are defined in the Part workbench and both the PartDesign workbench and the Part workbench use them-->
Line 574: Line 805:
* [[PartDesign_Preferences|PartDesign Preferences]]
* [[PartDesign_Preferences|PartDesign Preferences]]
* [[Path_Preferences|Path Preferences]]
* [[Path_Preferences|Path Preferences]]
* Plot Preferences (none)
* Points Preferences (none)
* Points Preferences (none)
* [[Raytracing_Preferences|Raytracing Preferences]]
* [[Raytracing_Preferences|Raytracing Preferences]]
Line 580: Line 810:
* Robot Preferences (none)
* Robot Preferences (none)
* [[Sketcher_Preferences|Sketcher Preferences]]
* [[Sketcher_Preferences|Sketcher Preferences]]
* Spreadsheet Preferences (none)
* [[Spreadsheet_Preferences|Spreadsheet Preferences]]
* [[Start_Preferences|Start Preferences]]
* [[Start_Preferences|Start Preferences]]
* Surface Preferences (none)
* Surface Preferences (none)
Line 586: Line 816:
* Test Framework Preferences (none)
* Test Framework Preferences (none)
* Web Preferences (none)
* Web Preferences (none)

===Bancadas de Trabalho Externas===

{{VeryImportantMessage|This section is incomplete and requires mentioning the preference pages of each [[External_workbenches|External workbench]]}}

* [[A2plus_Workbench#Preferences|A2plus Preferences]]
* Ship Preferences (none)


==Scripting==
==Scripting==

Latest revision as of 23:45, 27 October 2023

Other languages:

Introdução

To start the Preferences editor select the Edit → Preferences... option from the menu. On macOS the Preferences... option appears in the FreeCAD menu instead (this is the default place for preferences on the Mac).

FreeCAD uses a workbench concept, where each workbench is responsible for specific tasks and functions. A workbench can have its own preferences. These will only appear in the Preferences editor, usually in a dedicated section, if the workbench has been loaded in the current FreeCAD session. Some workbenches add support for specific import and export formats. If there are any related preferences they will appear on one or more additional tabs in the Import-Export section of the Preferences editor.

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

If no workbench is loaded, six sections appear in the Preferences editor: General, Display, Workbenches, Python, Addon Manager and Import-Export. Any workbenches that have been loaded, and have their own preferences, will appear below these.

Pressing the Reset button in the lower left corner of the Preferences dialog opens a menu (introduced in version 0.22) with options to reset preferences to their default values. You can reset the current tab, the current group, or all preferences. In version 0.21 and below the button will reset all preferences.

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

General

This preferences section has seven tabs: General, Document, Selection, Cache, Notification Area, Report view and Help.

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

Geral

On the General tab you can specify the following:

Name Description
Alterar idioma Selection of the language of the FreeCAD user interface
Tamanho da lista de arquivos recentes Specification how many files should be listed in the recent files list
Ativar fundo em mosaico If checked, the background of FreeCAD's main window will by default consist of tiles of this image

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

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

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

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

%APPDATA%/FreeCAD (on Windows),

$HOME/.FreeCAD (on Linux) or

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

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

Folha de estilo Selection of a style sheet. Folha de estilos define how the user interface of FreeCAD looks. For technical details about the style sheets, see themes.
Tamanho dos ícones da barra de ferramentas Selection of the size for the toolbar icons
Modo de visualização em árvore 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-carregar módulo ao iniciar Selection what workbench will be used directly after starting FreeCAD
Mostrar a tela de splash ao iniciar 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 Ativar fundo em mosaico.

Permitir quebra de linha 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.

Documento

On the Document tab you can specify the following:

Name Description
Criar um novo documento ao iniciar If checked, FreeCAD will create a new document when started
Document save compression level Specification of 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.
Usar Desfazer/Refazer em documentos If checked, all changes in documents are stored so that they can be undone/redone
Número máximo de operações Desfazer/Refazer Specification how many Undo/Redo steps should be recorded
Permitir abortação de recálculo If checked, recomputations can be aborted by pressing Esc. This may slightly increase the recomputation time.
Executar Auto Recuperação ao iniciar 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.
Salvar informações de Auto Recuperação a cada Specification how often a recovery file is written.
Salvar miniatura no arquivo quando salvar um documento 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 the powers of two 128, 256, 512.
Adicionar o logotipo do programa à miniatura gerada If checked, the FreeCAD program logo will be added to the thumbnail.
Número máximo de arquivos de backup a manter quando salvar novamente o documento 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.
Usar a data e a extensão FCBak 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].

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

Permitir rótulos de objetos duplicados em um documento If checked, objects can have the same label.
Desativar carregamento parcial de objetos externos vinculados 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]
Nome do autor 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 Salvar 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.
Empresa All created documents will get the specified company name
Licença padrão Selection of the license for new documents. For predefined licenses the URL da licença will automatically be set accordingly. Select Other for a custom license.
URL da licença Specification of an URL describing the license selected in Licença padrão

Seleção

On the Selection tab you can specify the following:

Name Description
Ir automaticamente para a vista 3D que contém o item selecionado Enables the Tree view SyncView mode
Expande automaticamente o item na árvore quando o objeto correspondente for selecionado na vista 3D Enables the Tree view SyncSelection mode
Pré-selecionar o objeto na vista 3D quando o mouse passa sobre o item na árvore Enables the Tree view PreSelection mode
Lembrar a seleção na árvore para voltar/avançar usando os botões de navegação Enables the Tree view RecordSelection mode
Adicionar caixas de seleção para seleção na árvore do documento Each document tree item will get a checkbox. This is for example useful for selecting multiple items on a touchscreen.

Cache

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

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

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

Notification Area

These preferences control the Notification Area and its notifications.

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

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

Report view

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

On the Report view tab you can specify the following:

Name Description
Gravar mensagens normais If checked, normal messages will be recorded. They will be displayed in the Report view with the color set in Mensagens normais.
Gravar mensagens de log If checked, log messages will be recorded. They will be displayed in the Report view with the color set in Mensagens de log.
Gravar advertências If checked, warnings will be recorded. They will be displayed in the Report view with the color set in Advertências.
Gravar mensagens de erro If checked, error messages will be recorded. They will be displayed in the Report view with the color set in Erros.
Mostrar visualização de relatório em caso de erro If checked, the Report view will be shown automatically when an error is recorded
Mostrar visualização de relatório no aviso If checked, the Report view will be shown automatically when a warning is recorded
Mostrar painel de relatório em notificações If checked, the Report view will be shown automatically when a normal message is recorded
Mostrar painel de relatório nas mensagens de registro If checked, the Report view will be shown automatically when a log message is recorded
Incluir uma marca temporal para cada entrada If checked, each message and warning will receive a timecode
Mensagens normais Specification of the font color for normal messages
Mensagens de log Specification of the font color for log messages
Advertências Specification of the font color for warning messages
Erros Specification of the font color for error messages
Redirecionar a saída interna de Python para a janela de relatório If checked, internal Python output will be redirected from the Python console to the Report view
Redirecionar erros internos do Python para a janela de relatório If checked, internal Python error messages will be redirected from the Python console to the Report view

Help

On the Help tab you can specify the following:

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

Display

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

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

The related Intensity setting specifies the intensity of the backlight.

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

Navegação

On the Navigation tab you can specify the following:

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

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

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

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

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

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

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

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

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

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

Cores

On the Colors tab you can specify the following:

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

Vista de malhas

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 VistaLighting 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 VistaSelection 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.

Bancadas de trabalho

This preferences section has a single tab: Available Workbenches.

Bancadas de trabalho descarregadas

These preferences control workbench loading.

On the Available Workbenches tab you can specify the following:

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

Python

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

Macro

On the Macro tab you can specify the following:

Name Description
Executar macros no ambiente local If checked, variables defined by macros are created as local variables, otherwise as global Python variables
Caminho de macro Specification of the path for macro files
Gravar comandos na GUI If checked, recorded macros will also contain user interface commands
Gravar como comentário 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.
Mostrar os comandos de script no console python If checked, the commands executed by macro scripts are shown in the Python console. This console is shown using the View → Panels → Python console menu option.
Size of recent macros list Controls the number of recent macros to display in the menu
Contagem de atalhos Controls the number of recent macros that get dynamically assigned shortcuts
Modificadores de Teclado Controls which keyboard modifiers are used for the shortcuts, example Ctrl+Shift+ creates shortcuts in the form of Ctrl+Shift+1, Ctrl+Shift+2, etc.

Python console

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

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

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

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

Editor

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
Ativar números de linha If checked, the code lines will be numbered
Tamanho da tabulação Specification of 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 Manter abas is selected.
Tamanho da indentação Specification of how many spaces will be inserted when pressing Tab. This setting is only used if Inserir espaços is selected.
Manter abas If selected, pressing Tab will insert a tabulator with the raster defined by Tamanho da tabulação
Inserir espaços If selected, pressing Tab will insert the amount of spaces defined by Tamanho da indentação
Display Items Selection of the code type. The color and font settings will be applied to the selected type. The result can be checked in the Preview field.
Família Specification of the font family that should be used for the selected code type
Tamanho Specification of the font size that should be used for the selected code type
Cor Specification of the color that should be used for the selected code type

Addon Manager

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

Addon manager options

These preferences control the behavior of the Addon manager.

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

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

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

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

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

Import-Export

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

Preferências da bancada de trabalho

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


User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Preferences_Editor/pt-br&oldid=1316059"