Draft DXF/tr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 25: Line 25:
==Importing==
==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.
DXF versions R12 - 2007 are supported.

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:
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, dims and attributes inside blocks will be skipped)
* blocks (only geometry. texts, dimensions and attributes inside blocks will be skipped)
* points
* points
* leaders
* leaders
* paper space objects
* ... (list is incomplete).


==Exporting==
==Exporting==


Files are exported in the R12 DXF format which can be handled by many applications.
Files are exported in the R14 DXF format which can be handled by many applications.


The following FreeCAD objects can be exported:
The following FreeCAD objects can be exported:
* all of FreeCAD's 2D geometry such as Draft objects or sketches
* lines and wires (polylines)
* 3D objects are exported as a flattened 2D view
* arcs and circles
* Compound objects are exported as blocks
* 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.
* ... (list is incomplete).


==Installing==
==Installing==


For licensing reasons, the required [[DXF|DXF]] import/export libraries are not part of the FreeCAD source code.
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]].
For more information see: [[FreeCAD_and_DXF_Import|FreeCAD and DXF Import]].



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")