Draft DXF/ru: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 1: Line 1:
{{Page in progress}}
<languages/>
<languages/>


{{Docnav
{{Docnav
|[[Draft_Preferences|Preferences]]
|[[Draft_Preferences|Preferences]]
|[[Draft_SVG|Draft SVG]]
|[[Draft_SVG|Scalable Vector Graphics .SVG]]
|[[Draft_Workbench|Draft]]
|[[Draft_Module|Draft]]
|IconL=
|IconL=
|IconR=
|IconR=
Line 37: Line 36:
</div>
</div>


The importer has two modes, settable under {{MenuCommand|Edit → Preferences → Import/Export → DXF}}: One is built-in, C++-based and fast, the other is legacy, coded in Python, slower, and requires the installation of an add-on, but can sometimes handle some entities better and can create more refined FreeCAD objects. Both support all DXF versions starting from R12.
Two importers are available, which one is used can be specified under {{MenuCommand|Edit → Preferences... → Import-Export → DXF}}. One is built-in, C++-based and fast, the other is legacy, coded in Python, slower, and requires the installation of an add-on, but can handle some entities better and can create 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.
3D solids inside a DXF file are stored under a binary ACIS/SAT blob, which at the moment cannot be read by FreeCAD.


===C++ importer===
The following DXF objects can be imported:

This importer can import the following DXF objects:
* lines
* lines
* polylines (and lwpolylines)
* polylines (and lwpolylines)
* arcs
* circles
* circles
* arcs
* splines
* ellipses
* ellipses
* layers
* splines
* points
* texts and mtexts
* texts and mtexts
* dimensions
* dimensions
* blocks (only geometry. texts, dimensions and attributes inside blocks will be skipped)
* points
* leaders
* leaders
* blocks (only geometry, texts, dimensions and attributes inside blocks are skipped)
* layers
* paper space objects
* paper space objects

===Legacy importer===

This importer can import the following DXF objects:
* lines
* polylines (and lwpolylines)
* arcs
* circles
* ellipses
* splines
* 3D faces
* texts and mtexts
* leaders
* layers


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 68: Line 83:
</div>
</div>


Files are exported in the R14 DXF format which can be handled by many applications.
There are also two exporters. The legacy exporter exports to the R12 DXF format, the C++ exporter to the R14 DXF format. Both formats can be handled by many applications.


===C++ exporter===
The following FreeCAD objects can be exported:

* all of FreeCAD's 2D geometry such as Draft objects or sketches
Some of the features and limitations of this exporter are:
* 3D objects are exported as a flattened 2D view
* All FreeCAD 2D geometry is exported, except [[Draft_CubicBezCurve|Draft CubicBezCurves]], [[Draft_BezCurve|Draft BezCurves]] and [[Draft_Point|Draft Points]].
* Compound objects are exported as blocks
* Straight edges from faces of 3D objects are exported, but curved edges only if they are on a plane parallel to the XY plane of the global coordinate system. Note that a DXF created from 3D objects will contain duplicate lines.
* texts
* Texts and dimensions are not exported.
* colors are mapped from objects RGB colors to autocad color index (ACI). Black will always be "by layer"
* Colors are ignored.
* layers are mapped from group names. When groups are nested, the deepest group gives the layer name.
* Layers are mapped from object names.
* dimensions, which are exported with "Standard" dimstyle.

===Legacy exporter===

Some of the features and limitations of this exporter are:
* All FreeCAD 2D geometry is exported, except [[Draft_Point|Draft Points]]. But ellipses, B-splines and Bézier curves are not exported properly.
* 3D objects are exported as flattened 2D views.
* Compound objects are exported as blocks.
* Texts and dimensions are exported.
* The colors in the DXF are based on the line color of objects. Black is mapped to "ByBlock", other colors are mapped using AutoCAD Color Index (ACI) colors.
* Layers are mapped from layer and group names. When groups are nested, the deepest group gives the layer name.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 89: Line 114:
==Preferences==
==Preferences==


For more information see: [[Import_Export_Preferences|Import Export Preferences]].
See [[Import_Export_Preferences|Import Export Preferences]].


==Scripting==
==Scripting==
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
You can export elements to DXF by using the following function:

To export objects to DXF use the {{incode|export}} method of the importDXF module.

{{Code|code=
{{Code|code=
importDXF.export(objectslist, filename, nospline=False, lwPoly=False)
importDXF.export(objectslist, filename, nospline=False, lwPoly=False)
}}
}}

* For the Windows OS: use a {{FileName|/}} (forward slash) as the path separator in {{Incode|filename}}.


Example:
Example:

{{Code|code=
{{Code|code=
import Draft, importDXF
import FreeCAD as App
import Draft
import importDXF


doc = App.newDocument()
Polygon1 = Draft.makePolygon(3, radius=500)
Polygon2 = Draft.makePolygon(5, radius=1500)


polygon1 = Draft.make_polygon(3, radius=500)
objects = [Polygon1, Polygon2]
polygon2 = Draft.make_polygon(5, radius=1500)


doc.recompute()

objects = [polygon1, polygon2]
importDXF.export(objects, "/home/user/Pictures/myfile.dxf")
importDXF.export(objects, "/home/user/Pictures/myfile.dxf")
}}
}}



<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">

Revision as of 08:03, 15 September 2021

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

Открытие

Данная функция открывает файл DXF (любую версию от 12 до 2007) в новом документе. В настоящее время поддерживаются следующие типы объектов DXF:

  • линии
  • полилинии и LW-полилинии (простые полилинии)
  • окружности
  • дуги
  • слои (слои содержащие объекты преобразуются в группы FreeCAD)
  • текст и M-текст
  • размеры
  • блоки (только геометрия, текст, размеры и атрибуты внутри блока будут пропущены)
  • точки introduced in version 0.13
  • выноски introduced in version 0.13

Остальные элементы DXF в настоящее время не импортируются, так как им нет соответствующих объектов FreeCAD. По мере добавления нового функционала, станет возможным импортировать остальные элементы DXF.

Two importers are available, which one is used can be specified under Edit → Preferences... → Import-Export → DXF. One is built-in, C++-based and fast, the other is legacy, coded in Python, slower, and requires the installation of an add-on, but can handle some entities better and can create more refined FreeCAD objects. Both support all DXF versions starting from R12.

3D solids inside a DXF file are stored under a binary ACIS/SAT blob, which at the moment cannot be read by FreeCAD.

C++ importer

This importer can import the following DXF objects:

  • lines
  • polylines (and lwpolylines)
  • arcs
  • circles
  • ellipses
  • splines
  • points
  • texts and mtexts
  • dimensions
  • leaders
  • blocks (only geometry, texts, dimensions and attributes inside blocks are skipped)
  • layers
  • paper space objects

Legacy importer

This importer can import the following DXF objects:

  • lines
  • polylines (and lwpolylines)
  • arcs
  • circles
  • ellipses
  • splines
  • 3D faces
  • texts and mtexts
  • leaders
  • layers

Экспорт

Экспортируемый файл DXF совместим с Autocad версии 12 и новее, поэтому он должен открываться в практически любом приложении поддерживающем формат DXF. В настоящее время поддерживается экспорт следующих объектов FreeCAD:

  • линии и многоточечные линии (полилинии)
  • дуги и окружности
  • текст
  • цвета отображаются из RGB в цветовой индекс Autocad (ACI). Чёрный всегда будет отображён в цвет "по слою"
  • слои отображаются по именам групп. При вложенных группах, имя слою даёт самая глубоко вложенная группа.
  • размеры, которые экспортируются со стилем "стандартный"

There are also two exporters. The legacy exporter exports to the R12 DXF format, the C++ exporter to the R14 DXF format. Both formats can be handled by many applications.

C++ exporter

Some of the features and limitations of this exporter are:

  • All FreeCAD 2D geometry is exported, except Draft CubicBezCurves, Draft BezCurves and Draft Points.
  • Straight edges from faces of 3D objects are exported, but curved edges only if they are on a plane parallel to the XY plane of the global coordinate system. Note that a DXF created from 3D objects will contain duplicate lines.
  • Texts and dimensions are not exported.
  • Colors are ignored.
  • Layers are mapped from object names.

Legacy exporter

Some of the features and limitations of this exporter are:

  • All FreeCAD 2D geometry is exported, except Draft Points. But ellipses, B-splines and Bézier curves are not exported properly.
  • 3D objects are exported as flattened 2D views.
  • Compound objects are exported as blocks.
  • Texts and dimensions are exported.
  • The colors in the DXF are based on the line color of objects. Black is mapped to "ByBlock", other colors are mapped using AutoCAD Color Index (ACI) colors.
  • Layers are mapped from layer and group names. When groups are nested, the deepest group gives the layer name.

Установка

Внимание! По причине лицензирования библиотеки импорта и экспорта DXF более не входят в исходный код FreeCAD. Поэтому данные библиотеки должны быть установлены пользователем, после установки FreeCAD. Это может быть сделано автоматически или вручную.

Preferences

See Import Export Preferences.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To export objects to DXF use the export method of the importDXF module.

importDXF.export(objectslist, filename, nospline=False, lwPoly=False)
  • For the Windows OS: use a / (forward slash) as the path separator in filename.

Example:

import FreeCAD as App
import Draft
import importDXF

doc = App.newDocument()

polygon1 = Draft.make_polygon(3, radius=500)
polygon2 = Draft.make_polygon(5, radius=1500)

doc.recompute()

objects = [polygon1, polygon2]
importDXF.export(objects, "/home/user/Pictures/myfile.dxf")