Draft Preferences: Difference between revisions

From FreeCAD Documentation
(New screenshots. Images out of translation.)
(Undo revision 1444975 by Roy 043 (talk)copy-paste error.)
Tag: Undo
 
Line 2: Line 2:
<translate>
<translate>


<!--T:1-->
<!--T:22-->
{{Docnav
{{Docnav
|[[Draft_Pattern|Pattern]]
|[[Preferences_Editor|Preferences Editor]]
|[[Draft_DXF|Autodesk .DXF .DWG]]
|[[Start_up_and_Configuration|Start up and Configuration]]
|[[Draft_Module|Draft]]
|IconL=
|IconR=
|IconC=Workbench_Draft.svg
}}
}}


Line 12: Line 16:
<translate>
<translate>


==Introduction== <!--T:221-->
<!--T:1-->
The preferences for the [[Draft_Workbench|Draft Workbench]] can be found in the [[Preferences Editor|Preferences Editor]]. In the menu select {{MenuCommand|Edit → Preferences...}} and then {{MenuCommand|Draft}}.


<!--T:11-->
<!--T:2-->
There are five pages: [[#General|General]], [[#Interface|Interface]], [[#Grid_and_snapping|Grid and snapping]], [[#Visual|Visual]] and [[#Texts_and_dimensions|Texts and dimensions]].
FreeCAD can import and export many file formats. For some formats dedicated preferences exist. These can be found in the [[Preferences_Editor|Preferences editor]]. In the menu select {{MenuCommand|Edit → Preferences...}} and then {{MenuCommand|Import-Export}}.


<!--T:228-->
<!--T:151-->
Some advanced preferences can only be changed in the [[Std_DlgParameter|Parameter editor]]. See [[Fine-tuning#Draft Workbench|Fine-tuning]].
Not all import and export preferences tabs are available by default. For some a workbench has to be loaded first.


==Notes== <!--T:237-->
<!--T:152-->
This page has been updated for version 1.0.


===TechDraw pages=== <!--T:229-->
<!--T:153-->
In {{VersionMinus|0.21}} some preferences may appear on a different page, and in some cases FreeCAD must be restarted after changing a preference.


<!--T:230-->
== General == <!--T:3-->
The DXF and SVG preferences listed here are not used by the [[File:TechDraw_ExportPageSVG.svg|24px]] [[TechDraw_ExportPageSVG|Export Page as SVG]] and [[File:TechDraw_ExportPageDXF.svg|24px]] [[TechDraw_ExportPageDXF|Export Page as DXF]] commands of the [[Image:Workbench_TechDraw.svg|24px]] [[TechDraw_Workbench|TechDraw Workbench]], or by the [[TechDraw_Workbench|TechDraw]] export option: {{MenuCommand|File → Export → Technical Drawing (*.svg *.dxf *.pdf)}}.


</translate>
===OpenSCAD files=== <!--T:238-->
[[Image:Preferences_Draft_Page_General.png|400px]]
<translate>


<!--T:239-->
<!--T:154-->
On the this page you can specify the following:
The import and export preferences for OpenSCAD files are listed in a different part of the [[Preferences_Editor|Preferences editor]]. See the [[OpenSCAD_Preferences|OpenSCAD Preferences]].


==Related== <!--T:224-->
<!--T:25-->
{| class="wikitable float-right mw-collapsible mw-uncollapsed"

<!--T:225-->
See the following pages for additional information:
* [[Import_Export|Import Export]]: A table listing all supported file formats.
* [[FreeCAD_Howto_Import_Export|FreeCAD Howto Import Export]]: A list of tutorials that can help users convert data from one format to another.

==Available preferences== <!--T:231-->

===DAE=== <!--T:146-->

<!--T:147-->
The [http://en.wikipedia.org/wiki/COLLADA Collada] DAE (Digital Asset Exchange) format is a standard file format for exchange of Mesh data. FreeCAD can import meshes from {{FileName|.dae}} files, and export [[Part_Workbench|Shape]]-based objects to the {{FileName|.dae}} format.

<!--T:241-->
Note for Linux users: To handle this file format FreeCAD requires the [[Extra_python_modules|pyCollada module]].

<!--T:148-->
For the DAE format you can specify the following:

<!--T:149-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description

<!--T:27-->
|-
|-
| {{MenuCommand|Scaling factor}}
| {{MenuCommand|Internal precision level}}
| The number of decimals used in internal coordinate operations (for example 3 = 0.001). Values between 6 and 8 are usually considered the best trade-off.
| All dimensions in the file will be scaled with the specified factor.

<!--T:26-->
|-
|-
| {{MenuCommand|Mesher}}
| {{MenuCommand|Default working plane}}
| The default [[Draft_SelectPlane|working plane]] for new views. The options are:
| Sets the meshing program that should be used. If using ''Netgen'', make sure that it is available. This can be checked by using the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]] and [[Mesh_FromPartShape|creating a mesh]] using Netgen. If it is not available another version of FreeCAD, compiled with Netgen, must be installed.
* {{MenuCommand|Automatic}}: If set to {{MenuCommand|Automatic}} the working plane will automatically align with the current view whenever a command is started. Additionally it will align to preselected planar faces, or when points on planar faces are picked during commands.
* {{MenuCommand|XY (Top)}}
* {{MenuCommand|XZ (Front)}}
* {{MenuCommand|YZ (Side)}}

<!--T:115-->
|-
|-
| {{MenuCommand|Tessellation}}
| {{MenuCommand|Show working plane tracker}}
| If checked, a widget indicating the current working plane orientation appears when picking points.
| The tessellation value to use with the ''Builtin'' and the ''Mefisto'' meshing program.

<!--T:31-->
|-
|-
| {{MenuCommand|Grading}}
| {{MenuCommand|Include groups in layer list}}
| If checked, the layers drop-down list also includes groups. Objects can then automatically be added to groups as well. See [[Draft_AutoGroup|Draft AutoGroup]].
| 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 {{incode|h(x)}} is bound by {{incode|abs(Δh(x)) ≤ 1/value}}.

<!--T:155-->
|-
|-
| {{MenuCommand|Segments per edge}}
| {{MenuCommand|Show prompts in the Report view}}
| If checked, instructions are displayed in the [[Report_view|Report view]] when using Draft commands. {{Version|1.0}}
| The maximum number of segments per edge.

<!--T:32-->
|-
|-
| {{MenuCommand|Segments per radius}}
| {{MenuCommand|Set focus on Length instead of X coordinate}}
| If checked, Length input, instead of the X coordinate, will have the initial focus. This allows to indicate a direction and then type a distance.
| The number of segments per radius.

<!--T:33-->
|-
|-
| {{MenuCommand|Second order}}
| {{MenuCommand|Select base objects after copying}}
| If checked, base objects, instead of created copies, are selected after copying.
| Allow a second order mesh.

<!--T:38-->
|-
|-
| {{MenuCommand|Optimize}}
| {{MenuCommand|Create Part primitives if possible}}
| If checked, Draft commands will create [[Part_Primitives|Part primitives]] instead of Draft objects. Note that this is not fully supported, and many objects will not be editable with Draft modification commands.
| Allow optimization.

<!--T:121-->
|-
|-
| {{MenuCommand|Allow quads}}
| {{MenuCommand|Keep face colors during downgrade/upgrade}}
| If checked, [[Draft_Downgrade|Draft Downgrade]] and [[Draft_Upgrade|Draft Upgrade]] will keep face colors. Only for the splitFaces and makeShell options.
| Allow [https://en.wikipedia.org/wiki/Types_of_mesh#Two-dimensional quadrilateral faces].
|}


<!--T:122-->
</translate>
|-
[[Image:Preferences_Import-Export_Page_DAE.png|400px]]
| {{MenuCommand|Keep face names during downgrade/upgrade}}
<translate>
| If checked, [[Draft_Downgrade|Draft Downgrade]] and [[Draft_Upgrade|Draft Upgrade]] will keep face names. Only for the splitFaces and makeShell options.


===DWG=== <!--T:150-->
<!--T:169-->
|-
| {{MenuCommand|Mouse delay}}
| This is the delay in seconds during which the mouse is inactive after entering a number in one of the Draft task panel input fields. During the delay moving the mouse won't change the entered value. Set to 0 to disable the delay.


<!--T:151-->
<!--T:102-->
|-
DWG (from drawing) is a proprietary, closed source, binary file format for storing 2D and 3D design data and metadata. FreeCAD requires external converters to process DWG files.
| {{MenuCommand|Max. number of editable objects}}
| The maximum number of objects [[Draft_Edit|Draft Edit]] is allowed to process at the same time.


<!--T:152-->
<!--T:104-->
|-
'''Note:''' All settings for the DXF file format also apply to DWG.
| {{MenuCommand|Edit node pick radius}}
| The pick radius of edit nodes.


<!--T:263-->
<!--T:39-->
|-
For the DWG format you can specify the following:
| {{MenuCommand|Label prefix for clones}}
| The default prefix added to the label of new [[Draft_Clone|clones]].


<!--T:153-->
<!--T:40-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Conversion method}}
| {{MenuCommand|Construction group label}}
| The default label for the [[Draft_ToggleConstructionMode|construction geometry group]].
| Select the DWG converter to use:
* '''Automatic''': FreeCAD will try to find a converter automatically following the order of the rest of this list. {{Version|0.21}}: For LibreDWG the OS search path is searched ({{Incode|os.getenv("PATH")}}), for the other converters default installation paths are assumed.
* '''LibreDWG''': [https://www.gnu.org/software/libredwg/ LibreDWG] is an open-source DWG reading and writing library. It lacks support for several DWG entities, and may not always give faithful results.
* '''ODA Converter''': The [https://www.opendesign.com/guestfiles/oda_file_converter ODA File Converter] is a free utility provided by the Open Design Alliance. It gives very good and reliable results.
* '''QCAD pro''': [https://qcad.org/en/qcad-command-line-tools#dwg2dwg QCAD pro] is the paid version of the open-source QCAD DXF-based 2D CAD platform. Its DWG converter uses the Teigha libraries from the OpenDesign Alliance and therefore gives the same good results as the ODA File Converter.


<!--T:264-->
<!--T:41-->
{{Version|0.20}}
|-
|-
| {{MenuCommand|Path to file converter}}
| {{MenuCommand|Construction geometry color}}
| The default color for Draft objects in construction mode.
| If FreeCAD is unable to find a converter you need to specify a path here:
|}
* LibreDWG: {{FileName|dwg2dxf}} or {{FileName|dxf2dwg}} on Linux and macOS, {{FileName|dwg2dxf.exe}} or {{FileName|dxf2dwg.exe}} on Windows. Either filename can be specified for both the conversion from DWG and to DWG.
* ODA Converter: {{FileName|ODAFileConverter}} on Linux and macOS, {{FileName|ODAFileConverter.exe}} on Windows.
* QCAD pro: {{FileName|dwg2dwg}} (a bash script) on Linux and macOS, {{FileName|dwg2dwg.bat}} on Windows.


<!--T:265-->
== Interface == <!--T:44-->
{{Version|0.20}}

<!--T:269-->
{{Version|0.21}}: The path must contain the correct filename.
|}


</translate>
</translate>
[[Image:Preferences_Import-Export_Page_DWG.png|400px]]
[[Image:Preferences_Draft_Page_Interface.png|400px]]
<translate>
<translate>

===DXF=== <!--T:154-->

<!--T:155-->
AutoCAD [[DXF|DXF]] (Drawing eXchange Format) is a proprietary format to exchange CAD data between AutoCAD and other programs.


<!--T:156-->
<!--T:156-->
For the DXF format you can specify the following:
On the this page you can specify the following:


<!--T:157-->
<!--T:46-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description

<!--T:47-->
|-
|-
| {{MenuCommand|Show this dialog when importing and exporting}}
| {{MenuCommand|In-command shortcuts}}
| These shortcuts only work when a [[Draft_Workbench|Draft]] or [[Arch Workbench|Arch]] command is active. Note that not all commands support all shortcuts.
| If checked, this preferences dialog will be shown when importing or exporting DXF files.

<!--T:49-->
|-
|-
| {{MenuCommand|Use legacy python importer}}
| {{MenuCommand|Relative}}
| Shortcut to toggle relative mode. If relative mode is on, coordinates are relative to the last point, if available, else they are relative to the coordinate system origin.
| If checked, the Python importer is used, otherwise the newer C++ one. The C++ importer is faster, but has not as many features yet.


<!--T:243-->
<!--T:62-->
The Python importer uses the {{MenuCommand|Edit → Preferences... → Draft → General settings → Internal precision level}} preference. For an accurate import result set this value to 8 or higher.
|-
|-
| {{MenuCommand|Use legacy python exporter}}
| {{MenuCommand|Global}}
| Shortcut to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the [[Draft SelectPlane|working plane]] coordinate system. {{Version|0.20}}
| If checked, the Python exporter is used, otherwise the newer C++ one. The C++ exporter is faster, but has not as many features yet.

<!--T:58-->
|-
|-
| {{MenuCommand|Allow FreeCAD to automatically download and update the DXF libraries}}
| {{MenuCommand|Length}}
| Shortcut to change the focus from the X coordinate input box to the Length input box and vice versa.
| By checking this, you will allow FreeCAD to download the [[FreeCAD_and_DXF_Import|Python converter]] for DXF import and export. This converter cannot be bundled with FreeCAD because it has a different software license.

<!--T:54-->
|-
|-
| {{MenuCommand|Import}}
| {{MenuCommand|Fill}}
| Shortcut to toggle filled mode. If filled mode is on, the created object will have {{PropertyData|Make Face}} set to {{TRUE}}.
| Select what will be imported.


<!--T:244-->
<!--T:56-->
|-
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.
| {{MenuCommand|Select edge}}
| Shortcut to press the {{Button|Select edge}} button. See [[Draft_Dimension|Draft Dimension]].


<!--T:194-->
<!--T:53-->
|-
If '''points''' is unchecked, points won't be imported.
| {{MenuCommand|Subelement mode}}
| Shortcut to toggle subelement mode. If subelement mode is on, the command will use the selected subelements instead of the whole objects.


<!--T:195-->
<!--T:52-->
|-
If '''layouts''' is checked, paper space objects will be imported too.
| {{MenuCommand|Copy}}
| Shortcut to toggle copy mode. If copy mode is on, the command will create modified copies instead of modifying the original objects.


<!--T:240-->
<!--T:149-->
Check '''*blocks''' if you want anonymous blocks (which have names beginning with a *) to be imported too.
|-
|-
| {{MenuCommand|Create}}
| {{MenuCommand|Undo}}
| Shortcut to press the {{Button|Undo}} button.
| Select what will be created.


<!--T:245-->
<!--T:59-->
|-
If '''simple Part shapes''' is selected, only standard Part objects will be created. This is the fastest.
| {{MenuCommand|Wipe}}
| Shortcut to press the {{Button|Wipe}} button.


<!--T:196-->
<!--T:51-->
|-
If '''Draft objects''' is selected, parametric Draft objects will be created whenever possible.
| {{MenuCommand|Close}}
| Shortcut to press the {{Button|Close}} button.


<!--T:197-->
<!--T:55-->
If '''Sketches''' is selected, sketches will be created whenever possible.
|-
|-
| {{MenuCommand|Scale factor to apply to imported files}}
| {{MenuCommand|Exit}}
| Shortcut to press the {{Button|Finish}} button.
| Scale factor to apply to DXF files on import. The factor is the conversion between the units 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.

<!--T:50-->
|-
|-
| {{MenuCommand|Get original colors from the DXF file}}
| {{MenuCommand|Continue}}
| Shortcut to toggle continue mode. If continue mode is on, commands will restart after finishing.
| If checked, colors will be retrieved from the DXF objects whenever possible. Otherwise default colors will be applied.

<!--T:61-->
|-
|-
| {{MenuCommand|Join geometry}}
| {{MenuCommand|Cycle snap}}
| Shortcut to change snap priority to an object that is obscured by other geometry. See [[Draft_Snap|Draft Snap]].
| If checked, FreeCAD will try to join coincident objects into wires. Note that this can take a while!

<!--T:57-->
|-
|-
| {{MenuCommand|Group layers into blocks}}
| {{MenuCommand|Add hold}}
| Shortcut to insert a "hold point" at the current location of the cursor. See [[Draft_Snap|Draft Snap]].
| If checked, objects from the same layers will be joined into Draft Blocks, which display faster, but are less easily editable. <!-- Draft Blocks are internal elements in Draft, basically a Part.Compound; they aren't exposed in the graphical interface; see Draft.makeBlock in the source code.-->

<!--T:60-->
|-
|-
| {{MenuCommand|Use standard font size for texts}}
| {{MenuCommand|Set working plane}}
| Shortcut to press the {{Button|Set WP}} button.
| If checked, imported texts will get the standard [[Draft_Text|Draft Text]] size, instead of the size they have in the DXF document.

<!--T:63-->
|-
|-
| {{MenuCommand|Use Layers}}
| {{MenuCommand|Snap}}
| Shortcut to toggle [[Draft_Snap|Draft snapping]].
| If checked, DXF layers will be imported as [[Draft_Layer|Draft Layers]].

<!--T:64-->
|-
|-
| {{MenuCommand|Import hatch boundaries as wires}}
| {{MenuCommand|Increase radius}}
| Shortcut to increase the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines. See [[Draft_SelectPlane|Draft SelectPlane]].
| If checked, hatches will be converted to simple wires.

<!--T:65-->
|-
|-
| {{MenuCommand|Render polylines with width}}
| {{MenuCommand|Decrease radius}}
| Shortcut to decrease the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines.
| If checked, if polylines have a width defined, they will be rendered as closed wires with the correct width.

<!--T:66-->
|-
|-
| {{MenuCommand|Treat ellipses and splines as polylines}}
| {{MenuCommand|Restrict X}}
| Shortcut to constrain the movement of the cursor to the X axis. See [[Draft_Constrain|Draft Constrain]].
| The export of ellipses and splines is poorly supported. Use this option to export them as polylines instead.


<!--T:198-->
<!--T:67-->
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}}
| {{MenuCommand|Restrict Y}}
| Shortcut to constrain the movement of the cursor to the Y axis.
| If checked, all objects containing faces will be exported as 3D polyfaces.

<!--T:68-->
|-
|-
| {{MenuCommand|Export Drawing Views as blocks}}
| {{MenuCommand|Restrict Z}}
| Shortcut to constrain the movement of the cursor to the Z axis.
| If this is checked, Drawing Views will be exported as blocks. This might fail for post DXF R12 templates.

<!--T:157-->
|-
|-
| {{MenuCommand|Project exported objects along current view direction}}
| {{MenuCommand|Only show the Draft snap toolbar during commands}}
| If checked, the Draft snap toolbar will only be visible during commands. {{Version|1.0}}
| If checked, the exported objects will be projected to reflect the current view direction. This option only works if the legacy Python exporter is used.
|}


<!--T:70-->
</translate>
[[Image:Preferences_Import-Export_Page_DXF.png|400px]]
<translate>

===IFC=== <!--T:162-->

<!--T:163-->
[http://en.wikipedia.org/wiki/Industry_Foundation_Classes Industry Foundation Classes] (IFC) is a wide spread format to exchange data between [http://en.wikipedia.org/wiki/Building_Information_Modeling BIM] applications. It is used in architecture and engineering.

<!--T:242-->
Note for Linux users: To handle this file format FreeCAD requires the [[Extra_python_modules|IfcOpenShell module]].

====IFC import==== <!--T:246-->

<!--T:164-->
For import of the IFC format you can specify the following:

<!--T:165-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Show this dialog when importing}}
| If checked, this preferences dialog will be shown when importing IFC files.
|-
| {{MenuCommand|Show debug messages}}
| Shows verbose debug messages during import and export of IFC files in the [[Report view|Report view]].
|-
| {{MenuCommand|Create clones when objects have shared geometry}}
| IFC objects can share a same geometry definition between several objects, only their placement is different. 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|Number of cores to use (experimental)}}
| Specify the number of CPU cores to use for IFC import. The maximum number should be smaller than the number of actually available cores. Use '''0''' to disable this feature.
|-
| {{MenuCommand|Import arch IFC objects as}}
| What will be created in FreeCAD for arch IFC objects.
|-
| {{MenuCommand|Import struct IFC objects as}}
| What will be created in FreeCAD for struct IFC objects.
|-
| {{MenuCommand|Root element}}
| Only subtypes of the specified element will be imported. Keep the predefined element [http://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifckernel/lexical/ifcproduct.htm IfcProduct] to import all building elements.
|-
| {{MenuCommand|Separate openings}}
| If checked, openings will be imported as subtractions, otherwise wall shapes will already have their openings subtracted.
|-
| {{MenuCommand|Detect extrusions}}
| If checked, the importer will try to detect extrusions. Note that this might slow things down.
|-
| {{MenuCommand|Split multilayer walls}}
| Split walls made of multiple layers.
|-
| {{MenuCommand|Prefix names with ID number}}
| If checked, object names will be prefixed with the [http://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcutilityresource/lexical/ifcgloballyuniqueid.htm IFC ID] number.
|-
| {{MenuCommand|Merge materials with same name and same color}}
| 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://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcpropertyresource/lexical/ifcproperty.htm IFC properties] stored in a spreadsheet object.
|-
| {{MenuCommand|Allow invalid shapes}}
| If unchecked invalid shapes are not imported.
|-
| {{MenuCommand|Exclude list}}
| A comma-separated list of [https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/toc-5.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|Import full FreeCAD parametric definitions if available}}
| {{MenuCommand|Show the Snap widget in the Draft Workbench}}
| If checked, the [[Draft_snap_widget|Snap widget]] is displayed in the Draft statusbar.
| Creates a full parametric model on import using stored FreeCAD object properties.


<!--T:202-->
<!--T:72-->
To get the FreeCAD properties, the model must have been exported using the option {{MenuCommand|Export full FreeCAD parametric model}}.
|-
|-
| {{MenuCommand|Replace 'Project', 'Site', 'Building' and 'Storey' with 'Group'}}
| {{MenuCommand|Show the Annotation scale widget in the Draft Workbench}}
| If checked, groups will be used to replace the mentioned objects.
| If checked, the [[Draft_annotation_scale_widget|Annotation scale widget]] is displayed in the Draft statusbar.
|}
|}

== Grid and snapping == <!--T:8-->


</translate>
</translate>
[[Image:Preferences_Import-Export_Page_IFC_import.png|400px]]
[[Image:Preferences_Draft_Page_Grid_and_snapping.png|400px]]
<translate>
<translate>


====IFC export==== <!--T:247-->
<!--T:146-->
Note that several grid preferences can also be changed with the [[Draft_SelectPlane|Draft SelectPlane]] command.


<!--T:248-->
<!--T:158-->
For export of the IFC format you can specify the following:
On the this page you can specify the following:


<!--T:249-->
<!--T:77-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description

<!--T:89-->
|-
|-
| {{MenuCommand|Show this dialog when exporting}}
| {{MenuCommand|Always show the grid}}
| If checked, the grid will always be visible in new views. Use [[Draft_ToggleGrid|Draft ToggleGrid]] to change this for the active view.
| If checked, this preferences dialog will be shown when exporting IFC files.

<!--T:87-->
|-
|-
| {{MenuCommand|Export type}}
| {{MenuCommand|Show the grid during commands}}
| If checked, the grid will be visible during commands in new views. Use [[Draft_ToggleGrid|Draft ToggleGrid]] to change this for the active view. {{Version|1.0}}
| Select how the model should be exported: as '''Standard model''', '''Structural Analysis''', or '''Standard + structural'''.

<!--T:90-->
|-
|-
| {{MenuCommand|Force export as Brep}}
| {{MenuCommand|Show grid border}}
| If checked, an additional border is displayed around the grid, showing the main square size in the bottom left corner.
| 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. But avoid exporting as Brep if possible as this makes objects non-parametric.

<!--T:147-->
|-
|-
| {{MenuCommand|Use DAE triangulation options}}
| {{MenuCommand|Show human figure}}
| If checked, the outline of a human figure is displayed at the bottom left corner of the grid. Only effective if the [[BIM_Workbench|BIM Workbench]] is installed and {{MenuCommand|Show grid border}} is enabled. {{Version|0.20}}
| Use triangulation options set in the DAE options page.

<!--T:92-->
|-
|-
| {{MenuCommand|Join coplanar facets when triangulating}}
| {{MenuCommand|Use colored axes}}
| If checked, the two main axes of the grid are colored red, green or blue if they match the X, Y or Z axis of the global coordinate system.
| 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.

<!--T:94-->
|-
|-
| {{MenuCommand|Store IFC unique ID in FreeCAD objects}}
| {{MenuCommand|Major lines every}}
| The number of squares between major grid lines. Major grid lines are thicker than minor grid lines.
| When exporting objects without a [http://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcutilityresource/lexical/ifcgloballyuniqueid.htm unique ID] (UID), the generated UID will be stored inside the FreeCAD object for reuse the next time the 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 for IFC files. Its ''serializer'' functionality can produce valid IFC geometry from [[Glossary#OCC|OCC]] shapes.


<!--T:250-->
<!--T:96-->
Note that this is still an experimental feature.
|-
|-
| {{MenuCommand|Export 2D objects as IfcAnnotations}}
| {{MenuCommand|Grid spacing}}
| The distance between grid lines.
| If checked, 2D objects will be exported as [https://standards.buildingsmart.org/IFC/RELEASE/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 using the option {{MenuCommand|Import full FreeCAD parametric definitions if available}}.
|-
| {{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.
|-
| {{MenuCommand|Disable IfcRectangleProfileDef}}
| Whenever possible, IFC objects that are extruded rectangles will be exported as [http://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcprofileresource/lexical/ifcrectangleprofiledef.htm IfcRectangleProfileDef]. For applications that have problems importing these entities, select this option to ensure that all profiles are exported as [http://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcprofileresource/lexical/ifcarbitraryclosedprofiledef.htm IfcArbitraryClosedProfileDef] instead.
|-
| {{MenuCommand|Auto-detect and export as standard cases when applicable}}
| Some IFC types such as [https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcsharedbldgelements/lexical/ifcwall.htm IfcWall] or [https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcsharedbldgelements/lexical/ifcbeam.htm IfcBeam] have special standard versions like [https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcsharedbldgelements/lexical/ifcwallstandardcase.htm IfcWallStandardCase] or [https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD1/HTML/schema/ifcsharedbldgelements/lexical/ifcbeamstandardcase.htm IfcBeamStandardCase]. If this option is selected, FreeCAD will automatically export such objects as standard cases when the necessary conditions are met.
|-
| {{MenuCommand|Add default site if one is not found in the document}}
| When exporting an IFC file, if no site is found in the FreeCAD document, a default one is added. A site is not mandatory according to the IFC standard, but it is common practice to have at least one in the file.
|-
| {{MenuCommand|Add default building if one is not found in the document (no standard)}}
| When exporting an IFC file, if no building is found in the FreeCAD document, a default one is added.

<!--T:203-->
'''Warning''': The IFC standard asks for at least one building in each file. By turning this option off, you will produce a non-standard IFC file.


<!--T:204-->
<!--T:98-->
However, at FreeCAD we believe having a building should not be mandatory, and this option is there to have a chance to demonstrate our point of view.
|-
|-
| {{MenuCommand|Add default building storey if one is not found in the document}}
| {{MenuCommand|Grid size}}
| The number of squares in the X and Y direction of the grid.
| When exporting an IFC file, if no building storey is found in the FreeCAD document, a default one is added. A building storey is not mandatory according to the IFC standard, but it is common practice to have at least one in the file.
|-
| {{MenuCommand|IFC file units}}
| Select which units will be used when exporting IFC files.
|}

</translate>
[[Image:Preferences_Import-Export_Page_IFC_export.png|400px]]
<translate>

===IGES=== <!--T:158-->


<!--T:159-->
<!--T:159-->
|-
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. After publication of the [[Preferences_Editor#STEP|STEP]] file format, IGES development was stopped in 1996, but it is still supported by many CAD programs. IGES files have the {{FileName|.iges}} or {{FileName|.igs}} extension.
| {{MenuCommand|Grid transparency}}
| The overall transparency of the grid.


<!--T:160-->
<!--T:160-->
|-
The tab ''IGES'' is only shown in the preferences if the [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]], [[Image:Workbench_PartDesign.svg|24px]] [[PartDesign_Workbench|PartDesign Workbench]], or [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD_Workbench|OpenSCAD Workbench]] has been loaded in the current FreeCAD session.
| {{MenuCommand|Grid color}}
| The color of the grid.


<!--T:199-->
<!--T:110-->
|-
For the IGES format you can specify the following:
| {{MenuCommand|Snap symbol style}}
| The style for [[Draft Snap|snap symbols]]. The options are:
* {{MenuCommand|Draft classic style}}
* {{MenuCommand|Bitsnpieces style}}.


<!--T:161-->
<!--T:112-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Units for export of IGES}}
| {{MenuCommand|Snap symbol color}}
| The color for [[Draft Snap|snap symbols]], [[Draft_Snap_Dimensions|snap dimensions]] and [[Draft_Edit|edit nodes]].
| Select what unit will be used when exporting IGES files.

<!--T:78-->
|-
|-
| {{MenuCommand|Write solids and shells as}}
| {{MenuCommand|Always snap}}
| If checked, [[Draft_Snap|snapping]] is activated without the need to press the {{MenuCommand|Snap modifier}} key.
| Select how solids and shells should be output.


<!--T:200-->
<!--T:81-->
|-
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 surfaces].
| {{MenuCommand|Snap modifier}}
| The [[Draft_Snap|Snap]] modifier key.


<!--T:201-->
<!--T:79-->
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 objects], shells as [https://wiki.eclipse.org/IGES_file_Specification#Shell_.28Type_514.29 shells].
|-
|-
| {{MenuCommand|Skip blank entities}}
| {{MenuCommand|Constrain modifier}}
| The [[Draft_Constrain|Constrain]] modifier key.
| If checked, blank [https://wiki.eclipse.org/IGES_file_Specification#Entities entities] will not be imported.

|-
<!--T:83-->
| {{MenuCommand|Company}}
| If not empty, the entered text will be used in the IGES file header for the company.
|-
| {{MenuCommand|Author}}
| If not empty, the entered text will be used in the IGES file header for the author.
|-
|-
| {{MenuCommand|Product}}
| {{MenuCommand|Alt modifier}}
| The Alt modifier key. The function of this key depends on the command.
| If not empty, the entered text will be used in the IGES file header for the product.
|}
|}

== Visual == <!--T:9-->


</translate>
</translate>
[[Image:Preferences_Import-Export_Page_IGES.png|400px]]
[[Image:Preferences_Draft_Page_Visual.png|400px]]
<translate>
<translate>


===INP=== <!--T:166-->
<!--T:161-->
On the this page you can specify the following:


<!--T:167-->
<!--T:109-->
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
INP is the input file format for the FEM software [https://en.wikipedia.org/wiki/Abaqus Abaqus]. It is used for the [[FEM_CalculiX|CalculiX]] solver in the [[Image:Workbench_FEM.svg|24px]] [[FEM_Workbench|FEM Workbench]].

<!--T:168-->
The tab ''INP'' is only shown in the preferences if the [[Image:Workbench_FEM.svg|24px]] [[FEM_Workbench|FEM Workbench]] has been loaded in the current FreeCAD session.

<!--T:205-->
For the INP format you can specify the following:

<!--T:169-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description

<!--T:120-->
|-
|-
| {{MenuCommand|Which mesh elements to export}}
| {{MenuCommand|SVG pattern size}}
| The default size for SVG patterns. A higher value results in a denser pattern.
| Select which mesh elements should be exported.


<!--T:206-->
If '''All''' is selected, all elements will be exported.


<!--T:207-->
<!--T:117-->
|-
If '''Highest''' is selected, only the highest elements will be exported. This means volumes for a volume mesh and faces for a shell mesh.
| {{MenuCommand|Additional SVG pattern location}}
| An optional directory with custom SVG files containing pattern definitions to be added to the standard patterns.


<!--T:208-->
<!--T:123-->
If '''FEM''' is selected, only FEM elements will be exported. This means only edges not belonging to faces and faces not belonging to volumes.
|-
|-
| {{MenuCommand|Export group data}}
| {{MenuCommand|Dashed line definition}}
| An SVG linestyle definition used by the [[TechDraw_DraftView|TechDraw DraftView]] command.
| 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.
|}


<!--T:124-->
</translate>
|-
[[Image:Preferences_Import-Export_Page_INP.png|400px]]
| {{MenuCommand|Dashdot line definition}}
<translate>
| Idem.


===Mesh Formats=== <!--T:170-->
<!--T:125-->

<!--T:171-->
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]. FreeCAD provides the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]] to create and handle meshes.
FreeCAD supports several mesh file formats.

<!--T:172-->
The tab ''Mesh Formats'' is only shown in the preferences if the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]] has been loaded in the current FreeCAD session.

<!--T:209-->
For the Mesh formats you can specify the following:

<!--T:173-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Maximum mesh deviation}}
| {{MenuCommand|Dotted line definition}}
| Idem.
| Specification of the maximal deviation between the mesh and the object.
|-
| {{MenuCommand|Export AMF files using compression}}
| If checked, ZIP compression is used when writing a mesh file in AMF format.
|-
| {{MenuCommand|Width}}
| Width of Asymptote page.
|-
| {{MenuCommand|Height}}
| Height of Asymptote page.
|}
|}

== Texts and dimensions == <!--T:10-->


</translate>
</translate>
[[Image:Preferences_Import-Export_Page_Mesh_Formats.png|400px]]
[[Image:Preferences_Draft_Page_Texts_and_dimensions.png|400px]]
<translate>
<translate>


===OCA=== <!--T:174-->
<!--T:128-->
These preferences are the defaults used when creating new objects. Changing them does not affect existing objects.


<!--T:175-->
<!--T:162-->
On the this page you can specify the following:
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.


<!--T:176-->
<!--T:130-->
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
For the OCA format you can specify the following:

<!--T:177-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description

<!--T:131-->
|-
|-
| {{MenuCommand|Import OCA areas}}
| {{MenuCommand|Font name or family}}
| The default font for texts, dimensions and labels. It can be a font name such as {{Value|Arial}}, a style such as {{Value|sans}}, {{Value|serif}} or {{Value|mono}}, or a family such as {{Value|Arial,Helvetica,sans}}, or a name with a style such as {{Value|Arial:Bold}}.
| If checked, the areas (3D faces) will be imported too.
|}


<!--T:132-->
</translate>
|-
[[Image:Preferences_Import-Export_Page_OCA.png|400px]]
| {{MenuCommand|Font size}}
<translate>
| The default height for texts, dimension texts and label texts.


===STEP=== <!--T:178-->
<!--T:163-->
|-
| {{MenuCommand|Line spacing factor}}
| The default line spacing for multi-line texts and labels (relative to the font size).


<!--T:179-->
<!--T:164-->
|-
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 commonly used to exchange 3D data between CAD software. STEP files have the {{FileName|.step}} or {{FileName|.stp}} extension. For compressed files the {{FileName|.stpz}} extension is used.
| {{MenuCommand|Scale multiplier}}
| The default annotation scale multiplier. This is the inverse of the scale set in the [[Draft_annotation_scale_widget|Draft annotation scale widget]]. If the scale is {{Value|1:100}} the multiplier is {{Value|100}}. {{Version|1.0}}


<!--T:180-->
<!--T:165-->
|-
The tab ''STEP'' is only shown in the preferences if the [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]], [[Image:Workbench_PartDesign.svg|24px]] [[PartDesign_Workbench|PartDesign Workbench]], or [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD_Workbench|OpenSCAD Workbench]] has been loaded in the current FreeCAD session.
| {{MenuCommand|Text color}}
| The default color for texts, dimension texts and label texts.


<!--T:227-->
<!--T:166-->
|-
For the STEP format you can specify the following:
| {{MenuCommand|Show dimension line}}
| If checked, the dimension line is displayed by default.


<!--T:181-->
<!--T:167-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Units for export of STEP}}
| {{MenuCommand|Line width}}
| The default line width.
| Select which units will be used when exporting STEP files.

<!--T:138-->
|-
|-
| {{MenuCommand|Write out curves in parametric space of surface}}
| {{MenuCommand|Arrows type}}
| The default symbol displayed at the ends of dimension lines. The options are:
| If checked, parametric curves (curves in parametric space of surfaces) will be written into the STEP file. Unchecking the option can be helpful to minimize the size of the resulting STEP file.
* {{MenuCommand|Dot}}
* {{MenuCommand|Circle}}
* {{MenuCommand|Arrow}}
* {{MenuCommand|Tick}}
* {{MenuCommand|Tick-2}}

<!--T:139-->
|-
|-
| {{MenuCommand|Export invisible objects}}
| {{MenuCommand|Arrows size}}
| The default arrow size.
| Uncheck this to skip invisible object when exporting, which is useful for CAD applications that do not support invisibility STEP styling.

<!--T:168-->
|-
|-
| {{MenuCommand|Export single object placement}}
| {{MenuCommand|Line and arrow color}}
| The default color for lines and arrows.
| Check this option to keep the placement information when exporting a single object. Please note that when re-importing the STEP file, the placement will be encoded into the shape geometry, instead of keeping it inside the Placement property.

<!--T:142-->
|-
|-
| {{MenuCommand|Use legacy exporter}}
| {{MenuCommand|Show unit}}
| If checked, a unit symbol is added to dimension texts by default.
| Use the legacy exporter.

<!--T:143-->
|-
|-
| {{MenuCommand|Scheme}}
| {{MenuCommand|Unit override}}
| The default unit override for dimensions. Enter a unit such as {{Value|m}} or {{Value|cm}}, leave blank to use the current unit defined in FreeCAD.
| Select the STEP application protocol (AP) to be used for the export.


<!--T:210-->
<!--T:134-->
|-
'''AP 203''' is the protocol for configuration controlled 3D designs of mechanical parts and assemblies.
| {{MenuCommand|Number of decimals}}
| The default number of decimal places for dimension texts.


<!--T:211-->
<!--T:150-->
'''AP 214''' is the protocol for core data for automotive mechanical design processes.
|-
| {{MenuCommand|Enable STEP Compound merge}}
| If checked, a [[Glossary#Compound|compound]] merge will be done during file reading. This is slower but results in higher details.
|-
| {{MenuCommand|Use LinkGroup}}
| Select this to use App::LinkGroup group containers instead of App::Part group containers.
|-
| {{MenuCommand|Import invisible objects}}
| Select this to import invisible objects.
|-
| {{MenuCommand|Reduce number of objects}}
| Reduce the number of objects using Link arrays.
|-
| {{MenuCommand|Expand compound shape}}
| Expand compound shapes with multiple solids.
|-
| {{MenuCommand|Show progress bar when importing}}
| Show a progress bar when importing.
|-
| {{MenuCommand|Ignore instance names}}
| Do not use instance names. Useful for some legacy STEP files with non-meaningful auto-generated instance names.
|-
|-
| {{MenuCommand|Mode}}
| {{MenuCommand|Feet separator}}
| The optional string inserted between the feet and inches values in dimensions. {{Version|1.0}}
| Select the required document structure.


<!--T:232-->
<!--T:137-->
'''Single document'''

<!--T:233-->
'''Assembly per document'''

<!--T:234-->
'''Assembly per document in sub-directory'''

<!--T:235-->
'''Object per document'''

<!--T:236-->
'''Object per document in sub-directory'''
|-
|-
| {{MenuCommand|Company}}
| {{MenuCommand|Dimension line overshoot}}
| The default distance the dimension line is extended past the extension lines.
| If not empty, the entered text will be used in the STEP file header for the company.
|-
| {{MenuCommand|Author}}
| If not empty, the entered text will be used in the STEP file header for the author.
|-
| {{MenuCommand|Product}}
| If not empty, the entered text will be used in the STEP file header for the product.
|}


<!--T:135-->
</translate>
[[Image:Preferences_Import-Export_Page_STEP.png|400px]]
<translate>

===SVG=== <!--T:182-->

<!--T:183-->
[[SVG|Scalable Vector Graphics]] (SVG) is a [https://en.wikipedia.org/wiki/Vector_graphics vector image] format for two-dimensional graphics. A vector image can be scaled to any size without losing its shape or details. An SVG image can be converted to bitmap formats like PNG or JPEG for printing.

<!--T:184-->
For the SVG format you can specify the following:

<!--T:185-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Import style}}
| {{MenuCommand|Extension line length}}
| The default length of extension lines. Use {{Value|0}} for full extension lines. A negative value defines the gap between the ends of the extension lines and the measured points. A positive value defines the maximum length of the extension lines. Only used for [[Draft_Dimension#View|linear dimensions]].
| Select how SVG object colors and line widths will be imported.


<!--T:212-->
<!--T:136-->
If '''None (fastest)''' is selected no color or line width settings will be imported.

<!--T:213-->
If '''Use default color and linewidth''' is selected FreeCAD will use its default color and line width.

<!--T:214-->
If '''Original color and linewidth''' is selected FreeCAD will use the color and linewidth from the SVG objects.
|-
|-
| {{MenuCommand|Disable units scaling}}
| {{MenuCommand|Extension line overshoot}}
| The default length of extension lines above the dimension line.
| If checked, no unit conversion will occur. One unit in the SVG file will translate as one millimeter.
|-
| {{MenuCommand|Export style}}
| Select how Sketches are exported to SVG.

<!--T:215-->
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.


<!--T:216-->
<!--T:141-->
If '''Raw (for CAM)''' is selected, SVG objects are placed as they are - at the same coordinates as in the FreeCAD model (1:1 export).
|-
|-
| {{MenuCommand|Translate white line color to black}}
| {{MenuCommand|Text spacing}}
| The default space between the dimension line and the dimension text.
| If checked, all white lines will appear in black in the SVG for better readability against white backgrounds.
|-
| {{MenuCommand|Max segment length for discretized arcs}}
| Versions of [[Glossary#Open_CASCADE|Open CASCADE]] older 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.
|}


<!--T:144-->
</translate>
[[Image:Preferences_Import-Export_Page_SVG.png|400px]]
<translate>

===VTK=== <!--T:186-->

<!--T:187-->
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 [[Image:Workbench_FEM.svg|24px]] [[FEM_Workbench|FEM Workbench]] for the [[FEM_Post_Processing_based_on_VTK|post processing]] of simulation results.

<!--T:188-->
The tab ''VTK'' is only shown in the preferences if the [[Image:Workbench_FEM.svg|24px]] [[FEM_Workbench|FEM Workbench]] has been loaded in the current FreeCAD session.

<!--T:217-->
For the VTK format you can specify the following:

<!--T:189-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Which object to import into}}
| {{MenuCommand|Default ShapeString font file}}
| The default font file for the [[Draft_ShapeString|Draft ShapeString]] command. For Windows users: please read the [[Draft_ShapeString#Font_file_selection_on_Windows|Font file selection on Windows]] paragraph on that page.
| Select what objects should be imported.

<!--T:218-->
If '''VTK result object''' is selected, a FreeCAD FEM VTK result object will be imported (equals to the object which was exported).

<!--T:219-->
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.

<!--T:220-->
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.
|}
|}

</translate>
[[Image:Preferences_Import-Export_Page_VTK.png|400px]]
<translate>




<!--T:193-->
<!--T:23-->
{{Docnav
{{Docnav
|[[Draft_Pattern|Pattern]]
|[[Preferences_Editor|Preferences Editor]]
|[[Draft_DXF|Autodesk .DXF .DWG]]
|[[Start_up_and_Configuration|Start up and Configuration]]
|[[Draft_Module|Draft]]
|IconL=
|IconR=
|IconC=Workbench_Draft.svg
}}
}}


</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:Common Questions{{#translation:}}]]
[[Category:Preferences{{#translation:}}]]
[[Category:Preferences{{#translation:}}]]
[[Category:File_Formats{{#translation:}}]]

Latest revision as of 12:33, 29 June 2024

The preferences for the Draft Workbench can be found in the Preferences Editor. In the menu select Edit → Preferences... and then Draft.

There are five pages: General, Interface, Grid and snapping, Visual and Texts and dimensions.

Some advanced preferences can only be changed in the Parameter editor. See Fine-tuning.

This page has been updated for version 1.0.

In version 0.21 and below some preferences may appear on a different page, and in some cases FreeCAD must be restarted after changing a preference.

General

On the this page you can specify the following:

Name Description
Internal precision level The number of decimals used in internal coordinate operations (for example 3 = 0.001). Values between 6 and 8 are usually considered the best trade-off.
Default working plane The default working plane for new views. The options are:
  • Automatic: If set to Automatic the working plane will automatically align with the current view whenever a command is started. Additionally it will align to preselected planar faces, or when points on planar faces are picked during commands.
  • XY (Top)
  • XZ (Front)
  • YZ (Side)
Show working plane tracker If checked, a widget indicating the current working plane orientation appears when picking points.
Include groups in layer list If checked, the layers drop-down list also includes groups. Objects can then automatically be added to groups as well. See Draft AutoGroup.
Show prompts in the Report view If checked, instructions are displayed in the Report view when using Draft commands. introduced in version 1.0
Set focus on Length instead of X coordinate If checked, Length input, instead of the X coordinate, will have the initial focus. This allows to indicate a direction and then type a distance.
Select base objects after copying If checked, base objects, instead of created copies, are selected after copying.
Create Part primitives if possible If checked, Draft commands will create Part primitives instead of Draft objects. Note that this is not fully supported, and many objects will not be editable with Draft modification commands.
Keep face colors during downgrade/upgrade If checked, Draft Downgrade and Draft Upgrade will keep face colors. Only for the splitFaces and makeShell options.
Keep face names during downgrade/upgrade If checked, Draft Downgrade and Draft Upgrade will keep face names. Only for the splitFaces and makeShell options.
Mouse delay This is the delay in seconds during which the mouse is inactive after entering a number in one of the Draft task panel input fields. During the delay moving the mouse won't change the entered value. Set to 0 to disable the delay.
Max. number of editable objects The maximum number of objects Draft Edit is allowed to process at the same time.
Edit node pick radius The pick radius of edit nodes.
Label prefix for clones The default prefix added to the label of new clones.
Construction group label The default label for the construction geometry group.
Construction geometry color The default color for Draft objects in construction mode.

Interface

On the this page you can specify the following:

Name Description
In-command shortcuts These shortcuts only work when a Draft or Arch command is active. Note that not all commands support all shortcuts.
Relative Shortcut to toggle relative mode. If relative mode is on, coordinates are relative to the last point, if available, else they are relative to the coordinate system origin.
Global Shortcut to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the working plane coordinate system. introduced in version 0.20
Length Shortcut to change the focus from the X coordinate input box to the Length input box and vice versa.
Fill Shortcut to toggle filled mode. If filled mode is on, the created object will have DataMake Face set to true.
Select edge Shortcut to press the Select edge button. See Draft Dimension.
Subelement mode Shortcut to toggle subelement mode. If subelement mode is on, the command will use the selected subelements instead of the whole objects.
Copy Shortcut to toggle copy mode. If copy mode is on, the command will create modified copies instead of modifying the original objects.
Undo Shortcut to press the Undo button.
Wipe Shortcut to press the Wipe button.
Close Shortcut to press the Close button.
Exit Shortcut to press the Finish button.
Continue Shortcut to toggle continue mode. If continue mode is on, commands will restart after finishing.
Cycle snap Shortcut to change snap priority to an object that is obscured by other geometry. See Draft Snap.
Add hold Shortcut to insert a "hold point" at the current location of the cursor. See Draft Snap.
Set working plane Shortcut to press the Set WP button.
Snap Shortcut to toggle Draft snapping.
Increase radius Shortcut to increase the maximum distance at which Draft Snap Grid detects the intersections of grid lines. See Draft SelectPlane.
Decrease radius Shortcut to decrease the maximum distance at which Draft Snap Grid detects the intersections of grid lines.
Restrict X Shortcut to constrain the movement of the cursor to the X axis. See Draft Constrain.
Restrict Y Shortcut to constrain the movement of the cursor to the Y axis.
Restrict Z Shortcut to constrain the movement of the cursor to the Z axis.
Only show the Draft snap toolbar during commands If checked, the Draft snap toolbar will only be visible during commands. introduced in version 1.0
Show the Snap widget in the Draft Workbench If checked, the Snap widget is displayed in the Draft statusbar.
Show the Annotation scale widget in the Draft Workbench If checked, the Annotation scale widget is displayed in the Draft statusbar.

Grid and snapping

Note that several grid preferences can also be changed with the Draft SelectPlane command.

On the this page you can specify the following:

Name Description
Always show the grid If checked, the grid will always be visible in new views. Use Draft ToggleGrid to change this for the active view.
Show the grid during commands If checked, the grid will be visible during commands in new views. Use Draft ToggleGrid to change this for the active view. introduced in version 1.0
Show grid border If checked, an additional border is displayed around the grid, showing the main square size in the bottom left corner.
Show human figure If checked, the outline of a human figure is displayed at the bottom left corner of the grid. Only effective if the BIM Workbench is installed and Show grid border is enabled. introduced in version 0.20
Use colored axes If checked, the two main axes of the grid are colored red, green or blue if they match the X, Y or Z axis of the global coordinate system.
Major lines every The number of squares between major grid lines. Major grid lines are thicker than minor grid lines.
Grid spacing The distance between grid lines.
Grid size The number of squares in the X and Y direction of the grid.
Grid transparency The overall transparency of the grid.
Grid color The color of the grid.
Snap symbol style The style for snap symbols. The options are:
  • Draft classic style
  • Bitsnpieces style.
Snap symbol color The color for snap symbols, snap dimensions and edit nodes.
Always snap If checked, snapping is activated without the need to press the Snap modifier key.
Snap modifier The Snap modifier key.
Constrain modifier The Constrain modifier key.
Alt modifier The Alt modifier key. The function of this key depends on the command.

Visual

On the this page you can specify the following:

Name Description
SVG pattern size The default size for SVG patterns. A higher value results in a denser pattern.


Additional SVG pattern location An optional directory with custom SVG files containing pattern definitions to be added to the standard patterns.
Dashed line definition An SVG linestyle definition used by the TechDraw DraftView command.
Dashdot line definition Idem.
Dotted line definition Idem.

Texts and dimensions

These preferences are the defaults used when creating new objects. Changing them does not affect existing objects.

On the this page you can specify the following:

Name Description
Font name or family The default font for texts, dimensions and labels. It can be a font name such as Arial, a style such as sans, serif or mono, or a family such as Arial,Helvetica,sans, or a name with a style such as Arial:Bold.
Font size The default height for texts, dimension texts and label texts.
Line spacing factor The default line spacing for multi-line texts and labels (relative to the font size).
Scale multiplier The default annotation scale multiplier. This is the inverse of the scale set in the Draft annotation scale widget. If the scale is 1:100 the multiplier is 100. introduced in version 1.0
Text color The default color for texts, dimension texts and label texts.
Show dimension line If checked, the dimension line is displayed by default.
Line width The default line width.
Arrows type The default symbol displayed at the ends of dimension lines. The options are:
  • Dot
  • Circle
  • Arrow
  • Tick
  • Tick-2
Arrows size The default arrow size.
Line and arrow color The default color for lines and arrows.
Show unit If checked, a unit symbol is added to dimension texts by default.
Unit override The default unit override for dimensions. Enter a unit such as m or cm, leave blank to use the current unit defined in FreeCAD.
Number of decimals The default number of decimal places for dimension texts.
Feet separator The optional string inserted between the feet and inches values in dimensions. introduced in version 1.0
Dimension line overshoot The default distance the dimension line is extended past the extension lines.
Extension line length The default length of extension lines. Use 0 for full extension lines. A negative value defines the gap between the ends of the extension lines and the measured points. A positive value defines the maximum length of the extension lines. Only used for linear dimensions.
Extension line overshoot The default length of extension lines above the dimension line.
Text spacing The default space between the dimension line and the dimension text.
Default ShapeString font file The default font file for the Draft ShapeString command. For Windows users: please read the Font file selection on Windows paragraph on that page.