Draft DXF: Difference between revisions
m (fix broken docnav + refinements) |
(Marked this version for translation) |
||
(28 intermediate revisions by 3 users not shown) | |||
Line 12: | Line 12: | ||
{{GuiCommand |
{{GuiCommand |
||
|Name=Draft DXF |
|Name=Draft DXF |
||
|MenuLocation=- |
|||
|MenuLocation={{StdMenu|[[Std File Menu|File]]}} → Export → Autodesk DXF 2D (*.dxf) |
|||
|Workbenches=[[Draft Workbench|Draft]] |
|Workbenches=[[Draft Workbench|Draft]] |
||
|Shortcut= |
|Shortcut=- |
||
|SeeAlso=[[FreeCAD and DXF Import]], [[FreeCAD and DWG Import]] |
|SeeAlso=[[FreeCAD and DXF Import]], [[FreeCAD and DWG Import]] |
||
|Empty=1 |
|Empty=1 |
||
}} |
}} |
||
== |
==Description== <!--T:14--> |
||
{{Emphasis|See also:}} [[FreeCAD and DXF Import|FreeCAD and DXF Import]] and [[FreeCAD and DWG Import|FreeCAD and DWG Import]]. |
|||
<!--T:15--> |
<!--T:15--> |
||
Draft DXF is a software module used by the [[File:Std_Open.svg|24px]] [[Std_Open|Std Open]], [[Std_Import|Std Import]] and [[Std_Export|Std Export]] commands to handle the DXF file format. |
|||
This function opens a [[DXF|DXF]] file, any version from 12 to 2007, to a new document. |
|||
</translate> |
</translate> |
||
Line 31: | Line 30: | ||
{{Caption|Qcad drawing exported to DXF, which is subsequently opened in FreeCAD}} |
{{Caption|Qcad drawing exported to DXF, which is subsequently opened in FreeCAD}} |
||
== |
==Importing== <!--T:2--> |
||
⚫ | |||
The importer has two modes, settable under Edit -> Preferences -> Import/Export -> DXF: One is built-in, C++-based and fast, the other, legacy one is code in Python slower, requires the installation of an add-on, but can sometimes handle some entities better and can created more refined FreeCAD objects. Both support all DXF versions starting from R12. |
|||
⚫ | |||
3D objects inside a DXF file are stored under a binary ACIS/SAT blob, which at the moment cannot be read by FreeCAD. Simpler entities like 3DFACEs, though, are supported. |
|||
<!--T:17--> |
<!--T:17--> |
||
The following DXF |
The following DXF objects can be imported: |
||
* lines |
* lines |
||
* polylines and lwpolylines |
* polylines (and lwpolylines) |
||
* circles |
* circles |
||
* arcs |
* arcs |
||
* splines |
|||
* layers (layers containing objects are converted to FreeCAD Groups) |
|||
* ellipses |
|||
* layers |
|||
* texts and mtexts |
* texts and mtexts |
||
* dimensions |
* dimensions |
||
* blocks (only geometry. texts, |
* blocks (only geometry. texts, dimensions and attributes inside blocks will be skipped) |
||
* points |
* points |
||
* leaders |
* leaders |
||
* paper space objects |
|||
<!--T: |
==Exporting== <!--T:4--> |
||
Other DXF entities are currently not imported because there is no corresponding FreeCAD object. As new functionality gets implemented, it will be possible to import more entity types. |
|||
<!--T:28--> |
|||
Files are exported in the R14 DXF format which can be handled by many applications. |
|||
<!--T: |
<!--T:29--> |
||
⚫ | |||
{{Emphasis|Note:}} for licensing reasons, the [[DXF|DXF]] import/export libraries are not part of the FreeCAD source code anymore. For that reason, they must be installed by you, the user, after you install FreeCAD. There is a way to allow FreeCAD to do that automatically, or you can do it manually. |
|||
* all of FreeCAD's 2D geometry such as Draft objects or sketches |
|||
* 3D objects are exported as a flattened 2D view |
|||
⚫ | |||
* Compound objects are exported as blocks |
|||
⚫ | |||
Starting from version 0.15, you only need to mark the {{MenuCommand|Edit → Preferences → Import/Export → DXF/DWG → "Allow FreeCAD to automatically download the DXF libraries"}} option to have FreeCAD take automatically care of downloading and installing these libraries. For older versions, you will need to do it manually. |
|||
=== Manually === <!--T:12--> |
|||
⚫ | |||
Libraries must be downloaded from https://github.com/yorikvanhavre/Draft-dxf-importer |
|||
There is a very complete step-by-step [[Dxf_Importer_Install|tutorial]] that will explain you the necessary steps. |
|||
== Importing == <!--T:3--> |
|||
This works the same way as opening, but it will add the contents of the DXF file in the active document instead of creating a new document. |
|||
⚫ | |||
Tutorial: [[Dxf_Importer_Install|Dxf Importer Install]] |
|||
== Exporting == <!--T:4--> |
|||
The exported DXF is compatible with Autocad version 12 and up, so it should open in about any application that supports dxf format. |
|||
⚫ | |||
* lines and wires (polylines) |
|||
* arcs and circles |
|||
* texts |
* texts |
||
* colors are mapped from objects RGB colors to autocad color index (ACI). Black will always be "by layer" |
* colors are mapped from objects RGB colors to autocad color index (ACI). Black will always be "by layer" |
||
* layers are mapped from group names. When groups are nested, the deepest group gives the layer name. |
* layers are mapped from group names. When groups are nested, the deepest group gives the layer name. |
||
* dimensions, which are exported with "Standard" dimstyle |
* dimensions, which are exported with "Standard" dimstyle. |
||
== |
==Installing== <!--T:8--> |
||
⚫ | |||
For licensing reasons, the required [[DXF|DXF]] import/export libraries needed by the legacy version of the importer are not part of the FreeCAD source code. |
|||
For more information see: [[FreeCAD_and_DXF_Import|FreeCAD and DXF Import]]. |
|||
⚫ | |||
<!--T:5--> |
<!--T:5--> |
||
For more information see: [[Import_Export_Preferences|Import Export Preferences]]. |
|||
The following parameters can be specified in the [[Preferences Editor|Preferences Editor]], in the menu {{MenuCommand|Edit → Preferences → Import-Export}}. |
|||
* Import style: This lets you choose the way objects from the dxf file will be drawn in FreeCAD. You can choose between: |
|||
** None: this is the faster way, there is no conversion, all objects will be black with 2px width (FreeCAD default) |
|||
** Use default color and linewidth: All imported dxf objects will take current linewidth/color from the draft command bar |
|||
** Original color and linewidth: Objects will keep the color and linewidth (if specified) they have in the dxf file |
|||
** Colors mapped to linewidth: If this option is selected, the mapping file option below is used. |
|||
* Color mapping file: This allows you to specify a mapping file to be used for translating dxf colors to color and linewidth, the same way as a plot style works in Autocad. The mapping file must be a tab-separated text file. There is a nice free utility called [http://www.noliturbare.com/TablePrintGUI.php Plot style viewer] that can convert Autocad CTB or STB (plot styles) files to tab-separated mapping files ready to use in FreeCAD. Alternatively, we have a couple of [[Draft_mapping_files|home-made mapping files]] available here. |
|||
* Import texts: This allows you to specify whether you want to import dxf texts and dimensions. Many texts might make your work in FreeCAD very difficult, so you might want to use this option some time. |
|||
* Import layout objects: Turn this on if you want to import paper space object. They will be merged in the same document as model space objects. |
|||
== |
==Scripting== <!--T:19--> |
||
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]]. |
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]]. |
||
Line 131: | Line 117: | ||
{{Draft Tools navi{{#translation:}}}} |
{{Draft Tools navi{{#translation:}}}} |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
{{Draft Tools navi{{#translation:}}}} |
|||
[[Category:Formats{{#translation:}}]] |
[[Category:Formats{{#translation:}}]] |
||
{{clear}} |
{{clear}} |
Revision as of 09:50, 21 October 2020
Draft DXF |
Menu location |
---|
- |
Workbenches |
Draft |
Default shortcut |
- |
Introduced in version |
- |
See also |
FreeCAD and DXF Import, FreeCAD and DWG Import |
Description
Draft DXF is a software module used by the Std Open, Std Import and Std Export commands to handle the DXF file format.
Qcad drawing exported to DXF, which is subsequently opened in FreeCAD
Importing
The importer has two modes, settable under Edit -> Preferences -> Import/Export -> DXF: One is built-in, C++-based and fast, the other, legacy one is code in Python slower, requires the installation of an add-on, but can sometimes handle some entities better and can created more refined FreeCAD objects. Both support all DXF versions starting from R12.
3D objects inside a DXF file are stored under a binary ACIS/SAT blob, which at the moment cannot be read by FreeCAD. Simpler entities like 3DFACEs, though, are supported.
The following DXF objects can be imported:
- lines
- polylines (and lwpolylines)
- circles
- arcs
- splines
- ellipses
- layers
- texts and mtexts
- dimensions
- blocks (only geometry. texts, dimensions and attributes inside blocks will be skipped)
- points
- leaders
- paper space objects
Exporting
Files are exported in the R14 DXF format which can be handled by many applications.
The following FreeCAD objects can be exported:
- all of FreeCAD's 2D geometry such as Draft objects or sketches
- 3D objects are exported as a flattened 2D view
- Compound objects are exported as blocks
- texts
- colors are mapped from objects RGB colors to autocad color index (ACI). Black will always be "by layer"
- layers are mapped from group names. When groups are nested, the deepest group gives the layer name.
- dimensions, which are exported with "Standard" dimstyle.
Installing
For licensing reasons, the required DXF import/export libraries needed by the legacy version of the importer are not part of the FreeCAD source code. For more information see: FreeCAD and DXF Import.
Preferences
For more information see: Import Export Preferences.
Scripting
See also: Draft API and FreeCAD Scripting Basics.
You can export elements to DXF by using the following function:
importDXF.export(objectslist, filename, nospline=False, lwPoly=False)
Example:
import Draft, importDXF
Polygon1 = Draft.makePolygon(3, radius=500)
Polygon2 = Draft.makePolygon(5, radius=1500)
objects = [Polygon1, Polygon2]
importDXF.export(objects, "/home/user/Pictures/myfile.dxf")
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- 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, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub