Editor de Preferências
To start the Preferences editor select the Edit → Preferences... option from the menu. On the Mac OS 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 if the workbench has been loaded in the current FreeCAD session. See Workbenches below for more information.
If no workbench is loaded, four sections appear in the Preferences editor: General, Display, Workbenches, and Import-Export. Any workbenches that have been loaded, and have their own preferences, will appear below these.
Please note that pressing thebutton in the lower left corner of the Preferences dialog will reset all FreeCAD preferences to their default values.
This preferences section has 8 tabs: General, Document, Selection, Cache, Editor, Output window, Macro, and Units.
On the General tab you can specify the following:
|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
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.|
On the Document tab you can specify the following:
|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. 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|
On the Selection tab (introduced in version 0.19) you can specify the following:
|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.|
On the Cache tab (introduced in version 0.20) you can specify the following:
|Check periodically at program start||??|
|Cache size limit||??|
|Current cache size||??|
The editor preferences settings affect the behavior of the macro editor. This editor can be opened using the menu Macro → Macros... → Edit/Create.
The color and font settings also affect the Python console. This console is shown using the menu View → Panels → Python console.
On the Editor tab you can specify the following:
|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, pressingwill 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. This setting is only used if Inserir espaços is selected.|
|Manter abas||If selected, pressingwill insert a tabulator with the raster defined by Tamanho da tabulação|
|Inserir espaços||If selected, pressingwill 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|
Janela de saída
The output preferences affect the behavior of the Report view. This panel is shown using the menu View → Panels → Report view.
On the Output tab you can specify the following:
|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|
On the Macro tab you can specify the following:
|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.|
On the Units tab you can specify the following:
|User system||Selection of the unit system to be used for all parts of FreeCAD|
|Número de casas decimais||The number of decimals that should be shown for numbers and dimensions|
|Fração mínima das polegadas||Fração mínima das polegadas that should be displayed. This setting is only available if the unit system Building US (ft-in/sqft/cuft) is used.|
This preferences section has three standard tabs: 3D View, Navigation and Colors. A fourth tab, Mesh view, is added if the Mesh Workbench has been loaded.
On the 3D View tab you can specify the following:
|Show coordinate system in the corner||If checked, the main coordinate system will always be shown at the lower right in opened files.
The Relative size introduced in version 0.20 defines the size of the representation as a percentage of the viewport size (the minimum of its height and width).
|Show axis cross by default introduced in version 0.19||If checked, the axis cross will be shown by default at file opening or creation|
|Show counter of frames per second||If checked, the time needed for the last operation and the resulting frame rate will always be shown at the lower left in opened files|
|Remember active workbench by tab introduced in version 0.19||If checked, the application will remember the active workbench for each tab in the Main view area independently. When switching to a tab this workbench will be restored automatically.|
|Use software OpenGL introduced in version 0.19||If checked, OpenGL will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application.|
|Use OpenGL VBO (Vertex Buffer Object)||If checked, Vertex Buffer Objects (VBO) will be used. A VBO is an OpenGL feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see this webpage.|
|Render Cache introduced in version 0.19||"Render Cache" or "Render Acceleration" is explained in more detail in FreeCAD_assembly3 render-caching. There are 3 options:
|Anti-Aliasing||Selection if and what kind of multisample anti-aliasing is used|
|Transparent objects introduced in version 0.19||Render type of transparent objects. The types are:
|Marker size||Selection of 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||Specification of the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the bounding box size of the 3D object that is currently displayed.|
|Backlight color||If checked, backlight is enabled with the defined color. Backlight is used for rendering back sides of faces. Usually, you don't see them in solids, unless you slice one with a clipping plane, or if the faces aren't oriented correctly. It is only active for objects whose Lighting property (on the View tab) is set to One side. If disabled, back sides of faces of objects in One side lighting mode will be black.
The related Intensity setting specifies the intensity of the backlight.
|Camera type||Selection of the camera projection type.|
On the Navigation tab you can specify the following:
|Navigation cube||If checked, the Navigation cube will always be shown.
Steps by turn defines the number of steps required for a full rotation when using the Navigation cube rotation arrows.
Corner defines where the Navigation cube is displayed on the screen when creating or opening a document.
If Rotate to nearest is checked, the 3D view is rotated to the nearest most logical state when a cube face is clicked. When it is off, clicking to a cube face will and up always to the same position, no matter in what cube state you were when you clicked the face. introduced in version 0.20
Cube size defines the size of the cube. introduced in version 0.20
|3D Navigation||Selection of a navigation settings set. To see what each set defines, select it and then press the button.|
|Orbit style||Selection of the rotation orbit style. When viewing a part in the x-y plane and being in the rotation mode of the 3D navigation, the difference is: If Trackball is selected, moving the mouse horizontally will rotate the part around the y-axis, if Turntable is selected the part will be rotated around the z-axis.|
|Rotation mode||Defines the rotation center. Select Window center, Drag at cursor, or Object center.|
|Default camera orientation||Selection of the camera orientation for new documents. This setting is also used by the Std ViewHome command.|
|New document scale||Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in 3D view. Default is 100 mm. It also sets the initial size of origin features (base planes in new PartDesign Bodies).|
|Enable animation||If checked, rotations can be animated. If for example the 3D Navigation set CAD is used and the mouse is moved while the scroll wheel and the right mouse button are pressed, parts are rotated. If one keeps the mouse moving while releasing e.g. the right mouse button, the rotation will continue as animation. To end the animation left-click with the mouse.|
|Zoom at cursor||If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise zoom operations will be performed at the center of the current view. The Zoom step defines how much will be zoomed. A zoom step of 1 means a factor of 7.5 for every zoom step.|
|Invert zoom||If checked, the direction of zoom operations will be inverted|
|Disable touchscreen tilt gesture||If checked, the tilting gesture will be disabled for pinch-zooming (two-finger zooming). This only affects the 3D Navigation set Gesture.|
On the Colors tab you can specify the following:
|Enable preselection highlighting||If checked, preselection is turned on and the specified color will be used for it. Preselection means that for example edges in parts will be highlighted while hovering over them with the mouse to indicate they can be selected.|
|Enable selection highlighting||If checked, selection highlighting is turned on and the specified color will be used for it|
|Simple color||If selected, the background of the 3D view will have the selected color|
|Color gradient||If selected, the background of the 3D view will have a vertical color gradient. The first color is the color at the top of the 3D view, the second the color at the bottom.|
|Middle color||Is only enabled if Color gradient is selected. If checked, the color gradient will get the selected color as the middle color.|
|Object being edited||Selection of the background color for objects in the tree view that are currently edited|
|Active container||Selection of the background color for active containers in the tree view. For example an active PartDesign Body will get the selected background 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:
|Default mesh color||Selection of the default shape color|
|Default line color||Selection of the default line color|
|Mesh transparency||Specification of the default mesh transparency|
|Line transparency||Specification of the default line transparency|
|Two-side rendering||If checked, the color of the interior side of faces will be the same as the exterior side. If not checked either the backlight color, if enabled, or black will be used instead.|
|Show bounding-box for highlighted or selected meshes||If checked, a yellow bounding box will be displayed for highlighted or selected meshes|
|Define normal per vertex||If checked, Phong shading is used, otherwise flat shading. Shading defines the appearance of surfaces. With flat shading the surface normals are not defined per vertex. 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
To preserve resources, FreeCAD does not automatically load all available workbenches. And only if a workbench has been loaded will its preferences, if any, appear in the Preferences editor.
In FreeCAD version 0.19 the tab has a different label: Unloaded Workbenches, and the tab displays a list of installed workbenches that have not yet been loaded. To load one or more workbenches select them in the list and then press thebutton.
In FreeCAD version 0.20 the Available Workbenches tab displays a list of all installed workbenches. To load a workbench press itsbutton. If you check a workbench's Autoload checkbox it will autoload when FreeCAD starts up. Loading more workbenches will make the startup slower, but switching between workbenches that have already been loaded is faster.
If a newly loaded workbench has dedicated preference they will appear in a new section in the Preferences editor. Some workbenches add support for additional import and export formats. If there are any related preferences they will appear on one or more new tabs in the Import-Export settings section of the Preferences editor.
For a list of workbench preferences see Workbench preferences
The Import-Export settings 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 more common workbenches are linked below. Some workbenches have no preferences. Other optional workbenches may not be listed. These links are also listed in Category:Preferences
- Arch Preferences
- Draft Preferences
- Drawing Preferences (none) obsolete in version 0.16
- FEM Preferences
- Image Preferences (none)
- Inspection Preferences (none)
- Mesh Design Preferences (none)
- OpenSCAD Preferences
- Part Preferences: the Part workbench also uses the PartDesign Preferences
- PartDesign Preferences
- Path Preferences
- Plot Preferences (none)
- Points Preferences (none)
- Raytracing Preferences
- Reverse Engineering Preferences (none)
- Robot Preferences (none)
- Sketcher Preferences
- Spreadsheet Preferences (none)
- Start Preferences
- Surface Preferences (none)
- TechDraw Preferences
- Test Framework Preferences (none)
- Web Preferences (none)
Bancadas de Trabalho Externas
- A2plus Preferences
- Ship Preferences (none)
See also: FreeCAD Scripting Basics.
For a scripting example see Std DlgParameter.