Preferences Editor/pt-br: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(101 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{docnav|Document structure|Interface Customization}} |
|||
{{Docnav |
|||
<div style="float:right; clean:both; margin-left:0.5em;">__TOC__</div> |
|||
|[[Interface_Customization/pt-br|Personalização da interface]] |
|||
|[[Import_Export_Preferences/pt-br|Preferências de exportação e importação]] |
|||
}} |
|||
{{TOCright}} |
|||
The preferences system of FreeCAD is located in the {{MenuCommand|Edit menu → Preferences}}. |
|||
<span id="Introduction"></span> |
|||
FreeCAD functionality is divided into different modules, each module being responsible for the working of a specific [[Workbenches|workbench]]. FreeCAD also uses a concept called late loading, which means that components are loaded only when they are needed. You may have noticed that when you select a workbench on the FreeCAD toolbar, that workbench and all its components get loaded at that moment. This includes its preferences settings. |
|||
==Introdução== |
|||
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). |
|||
Without any module loaded, you will have access to two configuration sections, responsible for the general application settings and for the display settings. When you are in a certain workbench the preferences of this workbench will appear as new section and file formats supported by the workbench will appear as new tab in the section {{MenuCommand|Import-Export}}. |
|||
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. |
|||
Clicking the {{Button|Reset}} button in the lower left corner of any preferences display will set '''all''' of the FreeCAD preferences to their default values. |
|||
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]]. |
|||
==General Settings== |
|||
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. |
|||
This preferences section has 6 tabs: |
|||
Pressing the {{Button|Reset}} button in the lower left corner of the Preferences dialog opens a menu ({{Version|1.0}}) 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. |
|||
===General=== |
|||
Some advanced preferences can only be changed in the [[Std_DlgParameter|Parameter editor]]. The [[Fine-tuning|Fine-tuning]] page lists some of them. |
|||
In the ''General'' tab you can specify the following: |
|||
==General== |
|||
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=== |
|||
On the ''General'' 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 |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Alterar idioma}} |
||
| |
| Selection of the language of the FreeCAD user interface |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Tamanho da lista de arquivos recentes}} |
||
| Specification how many files should be listed in the recent files list |
| Specification how many files should be listed in the recent files list |
||
|- |
|||
| {{MenuCommand|Ativar fundo em mosaico}} |
|||
| If checked, the background of FreeCAD's main window will by default consist of tiles of this image [[File:Background.png|64px]] |
|||
</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}} |
| {{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]] |
|||
| If checked, the background of FreeCAD's main window will by default consist of tiles of this image: [[File:Background.png|64px]]<br/>This option only has an effect if in {{MenuCommand|Style sheet}}/''No style sheet'' is selected.<br/>The image can be changed by adding the folders {{FileName|Gui/Images}} in the folder<br/>[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ {{FileName|%APPDATA%]/FreeCAD}} (on Windows),<br/>{{FileName|$HOME/.FreeCAD}} (on Linux) or<br/>{{FileName|$HOME/Library/Preferences/FreeCAD}} (on MacOS).<br/>Put there a file named {{FileName|background.png}} and uncheck/check this option to see the changed file. |
|||
This option only has an effect if no {{MenuCommand|Style sheet}} is selected. |
|||
The image can be changed by adding the folders {{FileName|Gui/Images}} in the folder: |
|||
{{FileName|[https://www.howtogeek.com/318177/what-is-the-appdata-folder-in-windows/ %APPDATA%]/FreeCAD}} (on Windows), |
|||
{{FileName|$HOME/.FreeCAD}} (on Linux) or |
|||
{{FileName|$HOME/Library/Preferences/FreeCAD}} (on macOS). |
|||
<div class="mw-translate-fuzzy"> |
|||
Place a file named {{FileName|background.png}} in the {{FileName|Images}} folder, and uncheck/check this option to see the changed file. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Folha de estilo}} |
||
| Selection of a style sheet. |
| Selection of a style sheet. Folha de estilos define how the user interface of FreeCAD looks. For technical details about the style sheets, see [[Interface_Customization#Themes|themes]]. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Tamanho dos ícones da barra de ferramentas}} |
||
| Selection of the size for the toolbar icons |
| Selection of the size for the toolbar icons |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|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. |
|||
|- |
|||
| {{MenuCommand|Auto-carregar módulo ao iniciar}} |
|||
| Selection what workbench will be used directly after starting FreeCAD |
| Selection what workbench will be used directly after starting FreeCAD |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Mostrar a tela de splash ao iniciar}} |
||
| If checked, a splash screen is shown when starting FreeCAD. |
|||
| 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. |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
The splash screen image can be changed by placing a file named {{FileName|splash_image.png}} in the {{FileName|Images}} folder already mentioned under {{MenuCommand|Ativar fundo em mosaico}}. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Permitir quebra de linha}} |
||
| Words will be wrapped when |
| 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}}. |
||
|} |
|} |
||
</div> |
|||
[[Image: |
[[Image:Preferences_General_Tab_General.png]] |
||
{{clear}} |
|||
= |
<span id="Document"></span> |
||
===Documento=== |
|||
On the ''Document'' 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 |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Criar um novo documento ao iniciar}} |
||
| If checked, FreeCAD will create a new document when started |
| If checked, FreeCAD will create a new document when started |
||
|- |
|- |
||
Line 64: | Line 112: | ||
| Specification of the compression level for {{FileName|FCStd}} files. {{FileName|FCStd}} files are ZIP-compressed files. Therefore you can rename their suffix {{FileName|.FCStd}} to {{FileName|.zip}} and open them with a ZIP archive program. |
| Specification of the compression level for {{FileName|FCStd}} files. {{FileName|FCStd}} files are ZIP-compressed files. Therefore you can rename their suffix {{FileName|.FCStd}} to {{FileName|.zip}} and open them with a ZIP archive program. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Usar Desfazer/Refazer em documentos}} |
||
| If checked, all changes in documents are stored so that they can be undone/redone |
| If checked, all changes in documents are stored so that they can be undone/redone |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Número máximo de operações Desfazer/Refazer}} |
||
| Specification how many Undo/Redo steps should be recorded |
| Specification how many Undo/Redo steps should be recorded |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Permitir abortação de recálculo}} |
||
| If checked, recomputations can be aborted by pressing {{KEY|Esc}}. This may slightly increase the recomputation time. |
|||
|- |
|||
| {{MenuCommand|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. |
| If there is a recovery file available FreeCAD will automatically run a file recovery when it is started. This way files can be restored if a crash occurred. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Salvar informações de Auto Recuperação a cada}} |
||
| Specification how often a recovery file is written. |
| Specification how often a recovery file is written. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Salvar miniatura no arquivo quando salvar um documento }} |
||
| If checked, |
| If checked, a thumbnail will be stored when the document is saved. The thumbnail will for example be shown in the list of recent files in the [[Start_Workbench|Start workbench]]. It is possible to select a '''Size''' between 128×128 and 512×512 pixels for the thumbnail. Common sizes are the powers of two 128, 256, 512. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Adicionar o logotipo do programa à miniatura gerada}} |
||
| If checked, the FreeCAD program logo [[ |
| If checked, the FreeCAD program logo [[Image:FreeCAD-logo.svg|24px]] will be added to the thumbnail. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|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 |
| If checked, backup files will be kept when saving the document. You can specify the number of backup files to keep. Backup files are previously saved versions of the document. The first backup file will have the file suffix {{FileName|.FCStd1}}, the second {{FileName|.FCStd2}} and so on. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Usar a data e a extensão FCBak}} |
||
| If checked, backup files will get the extension {{FileName|.FCbak}} and their file names get a date suffix according to the specified date format. For a description of the date format see [https//devhints.io/datetime this site]. |
|||
| If checked, objects can have the same label/name. For example different parts or features can then have the same name in the same document. |
|||
With the default settings a backup file will for example get this name {{FileName|TD-Cube.20200315-215654.FCBak}} (original filename is {{FileName|TD-Cube.FCStd}}). |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Permitir rótulos de objetos duplicados em um documento}} |
||
| If checked, objects can have the same label. |
|||
| 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| |
| {{MenuCommand|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] |
|||
| All documents that will be created will get the specified company name |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|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 {{MenuCommand|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 {{MenuCommand|File → Project information}} menu option. |
|||
| Selection of a default license for new documents. For predefined license the {{MenuCommand|License URL}} will automatically be set accordingly. Select 'Other' for an own or special license. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Empresa}} |
||
| All created documents will get the specified company name |
|||
| Specification of an URL describing the license selected in {{MenuCommand|Default license}} |
|||
|- |
|||
| {{MenuCommand|Licença padrão}} |
|||
| Selection of the license for new documents. For predefined licenses the {{MenuCommand|URL da licença}} will automatically be set accordingly. Select '''Other''' for a custom license. |
|||
|- |
|||
| {{MenuCommand|URL da licença}} |
|||
| Specification of an URL describing the license selected in {{MenuCommand|Licença padrão}} |
|||
|} |
|} |
||
</div> |
|||
[[Image: |
[[Image:Preferences_General_Tab_Document.png]] |
||
{{clear}} |
|||
<span id="Selection"></span> |
|||
===Editor=== |
|||
===Seleção=== |
|||
On the ''Selection'' tab you can specify the following: |
|||
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}}. |
|||
<div class="mw-translate-fuzzy"> |
|||
In the ''Editor'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Ir automaticamente para a vista 3D que contém o item selecionado}} |
||
| Enables the [[Std_TreeSyncView|Tree view SyncView mode]] |
|||
| 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|Expande automaticamente o item na árvore quando o objeto correspondente for selecionado na vista 3D}} |
|||
| {{MenuCommand|Family}} |
|||
| Enables the [[Std_TreeSyncSelection|Tree view SyncSelection mode]] |
|||
| Specification of the font family that should be used for the selected code type |
|||
|- |
|- |
||
| {{MenuCommand|Pré-selecionar o objeto na vista 3D quando o mouse passa sobre o item na árvore}} |
|||
| {{MenuCommand|Size}} |
|||
| Enables the [[Std_TreePreSelection|Tree view PreSelection mode]] |
|||
| Specification of the font size that should be used for the selected code type |
|||
|- |
|||
| {{MenuCommand|Enable line numbers}} |
|||
| If checked, the code lines will be numbered |
|||
|- |
|||
| {{MenuCommand|Tab size}} |
|||
| Specification of the tabulator raster (how many spaces). If it is for example set to '6', pressing {{KEY|Tab}} will jump to character 7 or 13 or 19 etc., depending the current cursor position. This setting is only used if {{MenuCommand|Keep tabs}} is selected. |
|||
|- |
|||
| {{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. |
|||
|- |
|- |
||
| {{MenuCommand|Lembrar a seleção na árvore para voltar/avançar usando os botões de navegação}} |
|||
| {{MenuCommand|Keep tabs}} |
|||
| Enables the [[Std_TreeRecordSelection|Tree view RecordSelection mode]] |
|||
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tab size}} |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Adicionar caixas de seleção para seleção na árvore do documento}} |
||
| Each [[Tree_view|document tree]] item will get a checkbox. This is for example useful for selecting multiple items on a touchscreen. |
|||
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Indent size}} |
|||
|} |
|} |
||
</div> |
|||
[[Image: |
[[Image:Preferences_General_Tab_Selection.png]] |
||
{{clear}} |
|||
=== |
===Cache=== |
||
These preferences are related to the cache directory where FreeCAD stores temporary files. |
|||
On the ''Cache'' tab ({{Version|0.20}}) you can specify the following: |
|||
In the ''Output '' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width: 33%;"|Name |
!style="width: 33%;"|Name |
||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Location}} |
||
| Specifies the path of the cache directory. |
|||
| If checked, also log messages will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Log messages}}. This panel is shown using the menu {{MenuCommand|View → Panels → Report view}}. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Check periodically at program start}} |
||
| Controls the frequency with which the directory size is checked. The options are: |
|||
| If checked, warnings will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Warnings}}. |
|||
* '''Always''' |
|||
|- |
|||
* '''Daily''' |
|||
| {{MenuCommand|Record error messages}} |
|||
* '''Weekly''' |
|||
| If checked, error messages will be recorded. They will be output in the Report view panel with the color set in {{MenuCommand|Errors}} |
|||
* '''Monthly''' |
|||
|- |
|||
* '''Yearly''' |
|||
| {{MenuCommand|Normal messages}} |
|||
* '''Never''' |
|||
| Specification of the font color for normal messages in the Report view panel. |
|||
|- |
|||
| {{MenuCommand|Log messages}} |
|||
| Specification of the font color for log messages in the Report view panel. |
|||
|- |
|||
| {{MenuCommand|Warnings}} |
|||
| Specification of the font color for warning messages in the Report view panel. |
|||
|- |
|||
| {{MenuCommand|Errors}} |
|||
| Specification of the font color for error messages in the Report view panel. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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: |
|||
| If checked, internal Python output will be redirected from the Python console to the Report view panel. The Python console is shown using the menu {{MenuCommand|View → Panels → Python console}} |
|||
* '''100 MB''' |
|||
* '''300 MB''' |
|||
* '''500 MB''' |
|||
* '''1 GB''' |
|||
* '''2 GB''' |
|||
* '''3 GB''' |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Current cache size}} |
||
| Shows the current size of the directory, if available. Press the {{Button|Check now...}} button to update the value. |
|||
| If checked, Python error messages will be redirected from the Python console to the Report view panel. |
|||
|} |
|} |
||
[[Image: |
[[Image:Preferences_General_Tab_Cache.png]] |
||
{{clear}} |
|||
=== |
===Notification Area=== |
||
These preferences control the Notification Area and its notifications. |
|||
On the ''Notification Area'' tab ({{Version|0.21}}) 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" |
||
!style="width: 33%;"|Name |
!style="width: 33%;"|Name |
||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Enable Notification Area}} |
||
| If checked, the Notification Area will appear in the status bar. |
|||
| If checked, variables defined by macros are created as local variables, otherwise as global Python variable |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Enable non-intrusive notifications}} |
||
| If checked, non-intrusive notifications will appear next to the Notification Area in the status bar. |
|||
| Specification of a path to macro files |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Errors}} |
||
| |
| If checked, errors will appear in the Notification Area. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Warnings}} |
||
| If checked, warnings will appear in the Notification Area. |
|||
| If checked, [[Std_DlgMacroRecord|recorded macros]] will also contain user interface commands but as comments. This is useful if you don't want to execute visible actions when running the macro but to see what could be done visibly. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Maximum Duration}} |
||
| Maximum duration during which notifications are shown (unless mouse buttons are clicked). |
|||
| 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}}. |
|||
|} |
|||
[[Image:Preference_General_Tab_05.png]] |
|||
{{clear}} |
|||
===Units=== |
|||
In the ''Units'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Name |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Minimum Duration}} |
||
| Minimum duration (idem). |
|||
| Selection of a unit system that should be used for all parts of FreeCAD |
|||
|- |
|- |
||
| {{MenuCommand|Number of |
| {{MenuCommand|Maximum Number of Notifications}} |
||
| |
| Maximum number of notifications shown simultaneously. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Notification width}} |
||
| Width of the Notification Area in pixels. |
|||
| Minimum fractional inch that should be displayed. This setting is only available if the unit system '''Building US (ft-in/sqft/cuft)''' is used. |
|||
|- |
|||
| {{MenuCommand|Hide when other window is activated}} |
|||
| If checked, open notifications will disappear when another window is activated. |
|||
|- |
|||
| {{MenuCommand|Do not show when inactive}} |
|||
| If checked, notifications will not appear if the FreeCAD window is not the active window. |
|||
|- |
|||
| {{MenuCommand|Maximum Messages (0 = 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. |
|||
|} |
|} |
||
[[Image: |
[[Image:Preferences_General_Tab_Notification_Area.png]] |
||
{{clear}} |
|||
== |
===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. |
|||
This preferences section has up to 3 tabs: |
|||
On the ''Report view'' tab you can specify the following: |
|||
===3D View=== |
|||
<div class="mw-translate-fuzzy"> |
|||
In the ''3D View'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Gravar mensagens normais}} |
||
| If checked, normal messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Mensagens normais}}. |
|||
| If checked, the main coordinate system will always be shown at the lower right in opened files |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Gravar mensagens de log}} |
||
| If checked, log messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Mensagens de log}}. |
|||
| 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| |
| {{MenuCommand|Gravar advertências}} |
||
| If checked, the [[ |
| If checked, warnings will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Advertências}}. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Gravar mensagens de erro}} |
||
| If checked, error messages will be recorded. They will be displayed in the [[Report_view|Report view]] with the color set in {{MenuCommand|Erros}}. |
|||
| 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]. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Mostrar visualização de relatório em caso de erro}} |
||
| If checked, the [[Report_view|Report view]] will be shown automatically when an error is recorded |
|||
| 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| |
| {{MenuCommand|Mostrar visualização de relatório no aviso}} |
||
| If checked, the [[Report_view|Report view]] will be shown automatically when a warning is recorded |
|||
| Selection of a navigation settings set. To see what each set defines, select a set and press the button {{Button|Mouse...}}. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Mostrar painel de relatório em notificações}} |
||
| If checked, the [[Report_view|Report view]] will be shown automatically when a normal message is recorded |
|||
| 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| |
| {{MenuCommand|Mostrar painel de relatório nas mensagens de registro}} |
||
| If checked, the [[Report_view|Report view]] will be shown automatically when a log message is recorded |
|||
| Selection if and what kind of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing Multisample anti-aliasing] is used |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Incluir uma marca temporal para cada entrada}} |
||
| If checked, each message and warning will receive a timecode |
|||
| Selection of the camera orientation for new documents |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Mensagens normais}} |
||
| Specification of the font color for normal messages |
|||
| 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| |
| {{MenuCommand|Mensagens de log}} |
||
| Specification of the font color for log messages |
|||
| If checked, the direction of zoom operations will be inverted. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Advertências}} |
||
| Specification of the font color for warning messages |
|||
| If checked, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the {{MenuCommand|3D Navigation}} set ''Gesture''. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Erros}} |
||
| Specification of the font color for error messages |
|||
| 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. |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|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|Python console]] to the [[Report_view|Report view]] |
|||
| Selection of the size of [[Glossary#Vertex|vertices]] (points) in the [[Sketcher_Workbench|Sketcher workbench]] |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Redirecionar erros internos do Python para a janela de relatório}} |
||
| If checked, internal Python error messages will be redirected from the [[Python_console|Python console]] to the [[Report_view|Report view]] |
|||
| 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]. |
|||
|} |
|} |
||
</div> |
|||
[[Image: |
[[Image:Preferences_General_Tab_Report_view.png]] |
||
{{clear}} |
|||
=== |
===Help=== |
||
On the ''Help'' tab you can specify the following: |
|||
In the ''Colors'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width: 33%;"|Name |
!style="width: 33%;"|Name |
||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Help location}} |
||
| Specifies the location of the Help files. The options are: |
|||
| 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. |
|||
* {{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| |
| {{MenuCommand|Display}} |
||
| Specifies where the documentation should be displayed. The options are: |
|||
| If checked, selection highlighting is turned on and the specified color will be used for it |
|||
* {{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| |
| {{MenuCommand|Custom stylesheet}} |
||
| Specifies an optional custom stylesheet. Not used for the Wiki URL. |
|||
| 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. |
|||
|- |
|||
| {{MenuCommand|Simple color}} |
|||
| If selected, the background for parts will have the selected color |
|||
|- |
|||
| {{MenuCommand|Color gradient}} |
|||
| If selected, the background for parts will have the selected color gradient |
|||
|- |
|||
| {{MenuCommand|Middle color}} |
|||
| Is only enabled if {{MenuCommand|Color gradient}} is selected. If checked, the color gradient will get the selected color as middle color. |
|||
|- |
|||
| {{MenuCommand|Object being edited}} |
|||
| Selection of the background color for objects in the tree view that are currently edited |
|||
|- |
|||
| {{MenuCommand|Active container}} |
|||
| Selection of the background color for active containers in the tree view. For example if there are several parts in the tree view and one part is toggled as [[PartDesign_Body#Active_Status|active body]], it will get the selected background color in the tree view. |
|||
|} |
|} |
||
[[Image: |
[[Image:Preferences_General_Tab_Help.png]] |
||
{{clear}} |
|||
== |
==Display== |
||
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 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. |
|||
<span id="3D_View"></span> |
|||
===Vista 3D=== |
|||
On the ''3D View'' tab you can specify the following: |
|||
In the ''Part colors'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width: 33%;"|Name |
!style="width: 33%;"|Name |
||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Show coordinate system in the corner}} |
||
| If checked, the main coordinate system will be shown in the lower right corner of the [[3D_view|3D view]]. |
|||
| Selection of the default color for new shapes. If the option {{MenuCommand|Random shape color}} is set, a random color is used instead. |
|||
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| |
| {{MenuCommand|Show axis cross by default}} |
||
| If checked, the axis cross will be shown by default in the [[3D_view|3D view]]. |
|||
| Selection of the default line color for new shapes |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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 be shown in the lower left corner of the [[3D_view|3D view]]. |
|||
| Specification of the default line thickness for new shapes |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Use software OpenGL}} |
||
| If checked, [https://en.wikipedia.org/wiki/OpenGL OpenGL] will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application. |
|||
| Selection of the default color for new [[Glossary#Vertex|vertices]] |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Use OpenGL VBO (Vertex Buffer Object)}} |
||
| If checked, [https://en.wikipedia.org/wiki/Vertex_Buffer_Object Vertex Buffer Objects] (VBO) will be used. A VBO is an [https://en.wikipedia.org/wiki/OpenGL OpenGL] feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see [https://www.haroldserrano.com/blog/understanding-opengl-objects Understanding OpenGL Objects]. |
|||
| Specification of the default size for new [[Glossary#Vertex|vertices]] |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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]. The options are: |
|||
| Selection of the color of [[Property_editor#View|bounding boxes]] in the 3D view |
|||
* '''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. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Anti-Aliasing}} |
||
| Specifies if and what type of [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multisample anti-aliasing] is used |
|||
| 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}}. |
|||
|} |
|||
[[Image:Preference_Display_Tab_03.png]] |
|||
{{clear}} |
|||
==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| |
| {{MenuCommand|Transparent objects}} |
||
| Specifies the render type of transparent objects. The options are: |
|||
| All dimensions in the file will be scaled with the specified factor |
|||
* '''One pass''': Rendering is done in one pass (default). This can lead to triangular artifacts. If these occur the type '''Backface pass''' can be used to avoid them. |
|||
* '''Backface pass''': Rendering is done in two passes. Back-facing polygons are rendered in the first pass and front-facing polygons in the second pass. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Marker size}} |
||
| Specifies the size of [[Glossary#Vertex|vertices]] (points) in the [[Sketcher_Workbench|Sketcher Workbench]]. The clickable area of points can be additionally enlarged by increasing the {{MenuCommand|Pick radius}}. |
|||
| 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| |
| {{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. |
|||
| The tessellation value to use with the ''Builtin'' and the ''Mefisto'' meshing program. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Eye to eye distance for stereo modes}} |
||
| Specifies the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the [[Property_editor#View|bounding box]] size of the 3D object that is currently displayed. |
|||
| 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| |
| {{MenuCommand|Backlight color}} |
||
| If checked, backlight is enabled with the defined color. Backlight is used for rendering the back sides of faces. Usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly. It is only used for objects whose Lighting property (on the View tab) is set to '''One side'''. If disabled, the back side of the faces of those objects will be black. |
|||
| The maximum number of segments per edge |
|||
The related {{MenuCommand|Intensity}} setting specifies the intensity of the backlight. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Camera type}} |
||
| Specifies the camera projection type. The options are: |
|||
| The number of segments per radius |
|||
* '''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]. |
|||
| {{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] |
|||
|} |
|} |
||
[[Image:Preferences_Display_Tab_3D_View.png]] |
|||
===DWG=== |
|||
<span id="Navigation"></span> |
|||
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]]. |
|||
===Navegação=== |
|||
On the ''Navigation'' tab you can specify the following: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 417: | Line 439: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Navigation cube}} |
||
| If checked, the [[Navigation_Cube|Navigation cube]] will be shown in the [[3D_view|3D view]]. |
|||
| Sets the path to the ODA file converter |
|||
|} |
|||
{{MenuCommand|Steps by turn}} defines the number of steps required for a full rotation when using the Navigation cube rotation arrows. |
|||
===DXF=== |
|||
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}} |
|||
[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. |
|||
{{MenuCommand|Cube size}} defines the size of the cube. {{Version|0.20}} |
|||
For the DXF format you can specify the following: |
|||
{{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}} |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Name |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|3D Navigation}} |
||
| Specifies a [[Mouse_navigation|mouse navigation style]]. To see the details of each style, select it and then press the {{Button|Mouse...}} button. |
|||
| This preferences dialog will be shown when importing or exporting DXF files |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Orbit style}} |
||
| Specifies the rotation orbit style used when in rotation mode. The options are: |
|||
| If checked, the Python importer is used, otherwise the newer C++ one. The C++ importer is faster, but has not as many features yet. |
|||
* '''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| |
| {{MenuCommand|Rotation mode}} |
||
| Defines the rotation center. The options are: |
|||
| 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. |
|||
* '''Window center''' |
|||
* '''Drag at cursor''' |
|||
* '''Object center''' |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Default camera orientation}} |
||
| Specifies the camera orientation for new documents. This setting is also used by the [[Std_ViewHome|Std ViewHome]] command. |
|||
| 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| |
| {{MenuCommand|Camera zoom}} |
||
| Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in [[3D_view|3D view]]. The default is 100 mm. It also sets the initial size of origin features (base planes in new [[PartDesign_Body|PartDesign Bodies]] and [[Std_Part|Std Parts]]). |
|||
| 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| |
| {{MenuCommand|Enable animation}} |
||
| If checked, and {{MenuCommand|3D Navigation}} is set to '''CAD''', rotations can be animated. If the mouse is moved while the scroll wheel and the right mouse button are pressed, the view is rotated. If one keeps the mouse moving while releasing the right mouse button, the rotation will continue. To end this animation left-click with the mouse. |
|||
| 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| |
| {{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, colors will be retrieved from the DXF objects whenever possible. Otherwise default colors will be applied. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Invert zoom}} |
||
| If checked, the direction of zoom operations will be inverted. |
|||
| If checked, FreeCAD will try to join coincident objects into wires. Note that this can take a while. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Disable touchscreen tilt gesture}} |
||
| If checked, and {{MenuCommand|3D Navigation}} is set to '''Gesture''', the tilting gesture will be disabled for pinch-zooming (two-finger zooming). |
|||
| 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| |
| {{MenuCommand|Enable rotation center indication}} |
||
| |
| If checked, the rotation center of the view is shown when dragging. {{Version|1.0}} |
||
|} |
|} |
||
[[Image:Preferences_Display_Tab_Navigation.png]] |
|||
===IGES=== |
|||
<span id="Colors"></span> |
|||
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. |
|||
===Cores=== |
|||
On the ''Colors'' tab you can specify the following: |
|||
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" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 493: | Line 509: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{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 of objects will be highlighted while hovering over them with the mouse to indicate they can be selected. |
|||
| Selection what unit will be used when exporting IGES files |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Enable selection highlighting}} |
||
| If checked, selection highlighting is turned on and the specified color will be used for it. |
|||
| 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| |
| {{MenuCommand|Simple color}} |
||
| If selected, the background of the [[3D_view|3D view]] will have the specified color. |
|||
| If checked, blank [https://wiki.eclipse.org/IGES_file_Specification#Entities entities] will not be imported |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Linear gradient}} |
||
| If selected, the background of the [[3D_view|3D view]] will have a vertical color gradient defined by the specified '''Top''' and '''Bottom''' colors. if enabled, a '''Middle''' color can also be specified. Press the {{Button|[[Image:Button_sort.svg|16px]]}} button ({{Version|0.21}}) to switch the top and bottom colors. |
|||
| If not empty, the entered text will be used in the IGES file header for the company |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| If not empty, the entered text will be used in the IGES file header for the author |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Object being edited}} |
||
| |
| Specifies the background color for objects in the tree view that are currently edited. |
||
|- |
|||
| {{MenuCommand|Active container}} |
|||
| 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]] |
|||
===IFC=== |
|||
<span id="Mesh_view"></span> |
|||
[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. |
|||
===Vista de malhas=== |
|||
This tab is only available if the [[Mesh_Workbench|Mesh Workbench]] has been loaded. |
|||
For the IFC format you can specify the following: |
|||
On 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" |
||
Line 522: | Line 544: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Default mesh color}} |
||
| Specifies the default face color. |
|||
| Shows verbose debug messages during import and export of IFC files in the ''Report view'' [[Std_Panels|panel]] |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Default line color}} |
||
| Specifies the default line color. |
|||
| 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| |
| {{MenuCommand|Mesh transparency}} |
||
| Specifies the default mesh transparency. |
|||
| What will be created in FreeCAD for arch IFC objects |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Line transparency}} |
||
| Specifies the default line transparency. |
|||
| What will be created in FreeCAD for struct IFC objects |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Two-side rendering}} |
||
| If checked, the default value for the {{PropertyView|Lighting}} property is {{value|Two side}} instead of {{value|One side}}. {{value|Two side}} means the color of the interior side of faces is the same as the color of the exterior side. {{value|One side}} means their color is either the [[#3D_View|backlight color]], if enabled, or black. |
|||
| 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| |
| {{MenuCommand|Show bounding-box for highlighted or selected meshes}} |
||
| If checked, the default value for the {{PropertyView|Selection Style}} property is {{value|BoundBox}} instead of {{value|Shape}}. {{value|BoundBox}} means a highlighted bounding box is displayed if meshes are highlighted or selected. {{value|Shape}} means the shape itself is then highlighted. |
|||
| If checked, openings will be imported as subtractions, otherwise wall shapes will already have their openings subtracted |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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, the importer will try to detect extrusions. Note that this might slow things down. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| Split walls made of multiple layers |
|||
:If face angle ≥ crease angle, facet shading is used. |
|||
|- |
|||
:If face angle < crease angle, smooth shading is used. |
|||
| {{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]. |
|||
|} |
|} |
||
[[Image:Preferences_Display_Tab_Mesh_view.png]] |
|||
===INP=== |
|||
<span id="Workbenches"></span> |
|||
===Bancadas de trabalho=== |
|||
This preferences section has a single tab: Available Workbenches. |
|||
<span id="Available_Workbenches"></span> |
|||
<div class="mw-translate-fuzzy"> |
|||
===Bancadas de trabalho descarregadas=== |
|||
</div> |
|||
These preferences control workbench loading. |
|||
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]]. |
|||
On the ''Available Workbenches'' tab you can specify the following: |
|||
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" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 599: | Line 591: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Workbench list}} |
||
| The list displays all installed workbenches. The list can be reordered by drag and drop ({{Version|0.21}}) and sorted by right-clicking the list and selecting {{MenuCommand|Sort alphabetically}} ({{Version|1.0}}). The order of the list also determines the order of the [[Std_Workbench|Workbench selector]]. |
|||
| 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. |
|||
* {{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| |
| {{MenuCommand|Start up workbench}} |
||
| The workbench that is activated when FreeCAD starts. |
|||
| 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. |
|||
|- |
|||
| {{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]] |
|||
===Mesh formats=== |
|||
==Python== |
|||
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]. |
|||
This preferences section ({{Version|0.21}}) has three tabs: Macro, Python console and Editor. |
|||
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: |
|||
===Macro=== |
|||
On the ''Macro'' 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 |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Executar macros no ambiente local}} |
||
| If checked, variables defined by macros are created as local variables, otherwise as global Python variables |
|||
| Specification of the maximal deviation between the mesh and the object |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Caminho de macro}} |
||
| Specification of the path for macro files |
|||
| If checked, ZIP compression is used when writing a mesh file in AMF format |
|||
|- |
|||
| {{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]] |
|||
===OCA=== |
|||
===Python console=== |
|||
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. |
|||
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. |
|||
For the OCA format you can specify the following: |
|||
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" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 635: | Line 665: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Enable word wrap}} |
||
| If checked, |
| 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]] |
|||
===STEP=== |
|||
===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 [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 color and font settings are also used by the [[#Python_console|Python console]]. |
|||
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: |
|||
On the ''Editor'' 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 |
!style="width 33%;"|Name |
||
!style="width |
!style="width 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Ativar números de linha}} |
||
| If checked, the code lines will be numbered |
|||
| Selection what unit will be used when exporting STEP files |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| 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| |
| {{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. |
|||
| 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| |
| {{MenuCommand|Manter abas}} |
||
| If selected, pressing {{KEY|Tab}} will insert a tabulator with the raster defined by {{MenuCommand|Tamanho da tabulação}} |
|||
| If checked, a [[Glossary#Compound|compound]] merge will be done during file reading. This is slower but results in higher details. |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Inserir espaços}} |
||
| If selected, pressing {{KEY|Tab}} will insert the amount of spaces defined by {{MenuCommand|Tamanho da indentação}} |
|||
| If not empty, the entered text will be used in the STEP file header for the company |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| If not empty, the entered text will be used in the STEP file header for the author |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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]] |
|||
===SVG=== |
|||
==Addon Manager== |
|||
[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. |
|||
This preferences section has a single tab: Addon manager options. |
|||
For the SVG format you can specify the following: |
|||
===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" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 681: | Line 735: | ||
!style="width: 66%;"|Description |
!style="width: 66%;"|Description |
||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| 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| |
| {{MenuCommand|Download Macro metadata (approximately 10MB)}} |
||
| If checked, |
| If checked, macro metadata is downloaded for display in the Addon manager's main addon listing. This data is cached locally. |
||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Cache update frequency}} |
||
| Controls the frequency with which the locally cached addon availability and metadata information is updated. The options are: |
|||
| 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). |
|||
* '''Manual (no automatic updates)''' |
|||
* '''Daily''' |
|||
* '''Weekly''' |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{MenuCommand|Hide Addons marked Python 2 Only}} |
||
| If checked, |
| 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| |
| {{MenuCommand|Hide Addons marked Obsolete}} |
||
| If checked, addons marked as "Obsolete" are not included in the listing. |
|||
| 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. |
|||
| |
|- |
||
| {{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}} |
|||
===VTK=== |
|||
To remove a repository select it in the list and press the {{Button|[[Image:List-remove.svg|16px]]}} button. {{Version|0.21}} |
|||
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. |
|||
|- |
|||
| {{MenuCommand|Proxy}} |
|||
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: |
|||
| The Addon manager includes experimental support for proxies requiring authentication, set up as user-defined proxies. |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Name |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| {{MenuCommand| |
| {{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. |
|||
| 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. |
|||
|- |
|||
| {{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== |
|||
==Workbench preferences== |
|||
Preferences for the more common workbenches are linked below. |
|||
Some workbenches have no preferences. |
|||
Other optional workbenches may not be listed. |
|||
[[A2plus_Workbench#Preferences|A2plus Preferences]] |
|||
[[Arch Preferences]] |
|||
[[Draft Preferences]] |
|||
Drawing Preferences (none) |
|||
[[Fem Preferences]] |
|||
Image Preferences (none) |
|||
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]] |
|||
The Import-Export preferences affect how files are imported and exported. They are described on the [[Import_Export_Preferences|Import Export Preferences]] page. |
|||
Reverse Engineering Preferences (none) |
|||
<span id="Workbench_related_preferences"></span> |
|||
Robot Preferences (none) |
|||
<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. |
|||
Ship Preferences (none) |
|||
[[ |
* [[Arch_Preferences|Arch Preferences]] |
||
* [[Draft_Preferences|Draft Preferences]] |
|||
* [[FEM_Preferences|FEM Preferences]] |
|||
* Inspection Preferences (none) |
|||
* [[Mesh_Workbench#Preferences|Mesh Design 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--> |
|||
* Part Preferences: the Part workbench also uses the [[PartDesign_Preferences|PartDesign Preferences]] |
|||
* [[PartDesign_Preferences|PartDesign Preferences]] |
|||
* [[Path_Preferences|Path Preferences]] |
|||
* Points Preferences (none) |
|||
* [[Raytracing_Preferences|Raytracing Preferences]] |
|||
* Reverse Engineering Preferences (none) |
|||
* Robot Preferences (none) |
|||
* [[Sketcher_Preferences|Sketcher Preferences]] |
|||
* [[Spreadsheet_Preferences|Spreadsheet Preferences]] |
|||
* [[Start_Preferences|Start Preferences]] |
|||
* Surface Preferences (none) |
|||
* [[TechDraw_Preferences|TechDraw Preferences]] |
|||
* Test Framework Preferences (none) |
|||
* Web Preferences (none) |
|||
==Scripting== |
|||
Spreadsheet Preferences (none) |
|||
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
|||
Surface Preferences (none) |
|||
For a scripting example see [[Std_DlgParameter|Std DlgParameter]]. |
|||
[[TechDraw Preferences#Preferences|TechDraw Preferences]] |
|||
==Related== |
|||
Test Framework Preferences (none) |
|||
* [[Std_DlgParameter|Parameter editor]] |
|||
* [[Fine-tuning|Fine-tuning]] |
|||
Web Preferences (none) |
|||
{{Docnav |
|||
{{docnav/pt-br|Document structure/pt-br|Interface Customization/pt-br}} |
|||
|[[Interface_Customization/pt-br|Personalização da interface]] |
|||
|[[Import_Export_Preferences/pt-br|Preferências de exportação e importação]] |
|||
}} |
|||
[[Category: |
[[Category:Preferences{{#translation:}}]] |
||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 09:26, 21 April 2024
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 1.0) 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
|
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:
|
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:
|
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:
|
Display | Specifies where the documentation should be displayed. The options are:
|
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:
|
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:
|
Marker size | Specifies the size of vertices (points) in the Sketcher Workbench. The clickable area of points can be additionally enlarged by increasing the Pick radius. |
Pick radius (px) | Sets the area for picking elements in the 3D view. Larger value makes it easier to pick things, but can make some small features impossible to select. |
Eye to eye distance for stereo modes | Specifies the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the bounding box size of the 3D object that is currently displayed. |
Backlight color | If checked, backlight is enabled with the defined color. Backlight is used for rendering the back sides of faces. Usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly. It is only used for objects whose Lighting property (on the View tab) is set to One side. If disabled, the back side of the faces of those objects will be black.
The related Intensity setting specifies the intensity of the backlight. |
Camera type | Specifies the camera projection type. The options are:
|
On the Navigation tab you can specify the following:
Name | Description |
---|---|
Navigation cube | If checked, the Navigation cube will be shown in the 3D view.
Steps by turn defines the number of steps required for a full rotation when using the Navigation cube rotation arrows. If Rotate to nearest is checked, the 3D view is rotated to the nearest most logical position, based on the current orientation of the cube, when a cube face is clicked. Else clicking a face will always result in the same rotation. introduced in version 0.20 Cube size defines the size of the cube. introduced in version 0.20 Color sets the base color for all elements. introduced in version 0.21 Corner defines where the Navigation cube is displayed in the 3D view. The options are:
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:
|
Rotation mode | Defines the rotation center. The options are:
|
Default camera orientation | Specifies the camera orientation for new documents. This setting is also used by the Std ViewHome command. |
Camera zoom | Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in 3D view. The default is 100 mm. It also sets the initial size of origin features (base planes in new PartDesign Bodies and Std Parts). |
Enable animation | If checked, and 3D Navigation is set to CAD, rotations can be animated. If the mouse is moved while the scroll wheel and the right mouse button are pressed, the view is rotated. If one keeps the mouse moving while releasing the right mouse button, the rotation will continue. To end this animation left-click with the mouse. |
Zoom at cursor | If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise zoom operations will be performed at the center of the current view. The Zoom step defines how much will be zoomed. A zoom step of 1 means a factor of 7.5 for every zoom step. |
Invert zoom | If checked, the direction of zoom operations will be inverted. |
Disable touchscreen tilt gesture | If checked, and 3D Navigation is set to Gesture, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). |
Enable rotation center indication | If checked, the rotation center of the view is shown when dragging. introduced in version 1.0 |
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.
|
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 1.0). The order of the list also determines the order of the Workbench selector.
|
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:
|
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:
|
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 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.
- Arch Preferences
- Draft Preferences
- FEM Preferences
- Inspection Preferences (none)
- Mesh Design Preferences
- OpenSCAD Preferences
- Part Preferences: the Part workbench also uses the PartDesign Preferences
- PartDesign Preferences
- Path Preferences
- Points Preferences (none)
- Raytracing Preferences
- Reverse Engineering Preferences (none)
- Robot Preferences (none)
- Sketcher Preferences
- Spreadsheet Preferences
- Start Preferences
- Surface Preferences (none)
- TechDraw Preferences
- Test Framework Preferences (none)
- Web Preferences (none)
Scripting
See also: FreeCAD Scripting Basics.
For a scripting example see Std DlgParameter.
Related
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub