Draft DXF/ru: Difference between revisions

From FreeCAD Documentation
(Created page with "'''Внимание''': По причине лицензирования библиотеки импорта и экспорта DXF более не входят в исход...")
(Updating to match new version of source page)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>

{{Docnav
|[[Draft_Preferences|Preferences]]
|[[Draft_SVG|Scalable Vector Graphics .SVG]]
|[[Draft_Module|Draft]]
|IconL=
|IconR=
|IconC=Workbench_Draft.svg
}}

{{TOCright}}

==Description==

Draft DXF is a software module used by the [[File:Std_Open.svg|24px]] [[Std_Open|Std Open]], [[File:Std_Import.svg|24px]] [[Std_Import|Std Import]] and [[File:Std_Export.svg|24px]] [[Std_Export|Std Export]] commands to handle the DXF file format.

[[Image:Screenshot qcad.jpg]]
[[Image:Screenshot qcad.jpg]]
{{Caption|Qcad drawing exported to DXF, which is subsequently opened in FreeCAD}}

<div class="mw-translate-fuzzy">
===Открытие===
Данная функция открывает файл DXF (любую версию от 12 до 2007) в новом документе.
В настоящее время поддерживаются следующие типы объектов DXF:
* линии
* полилинии и LW-полилинии (простые полилинии)
* окружности
* дуги
* слои (слои содержащие объекты преобразуются в группы FreeCAD)
* текст и M-текст
* размеры
* блоки (только геометрия, текст, размеры и атрибуты внутри блока будут пропущены)
* точки {{Version|0.13}}
* выноски {{Version|0.13}}
Остальные элементы DXF в настоящее время не импортируются, так как им нет соответствующих объектов FreeCAD. По мере добавления нового функционала, станет возможным импортировать остальные элементы DXF.
</div>

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 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:
===Opening===
This function opens a DXF file (any version from 12 to 2007) in a new drawing.
The following DXF object types are currently supported:
* lines
* lines
* polylines and lwpolylines
* polylines (and lwpolylines)
* circles
* arcs
* arcs
* circles
* layers (layers containing objects are conveted to FreeCAD Groups)
* ellipses
* splines
* points
* texts and mtexts
* texts and mtexts
* dimensions
* dimensions
* leaders
* blocks (only geometry. texts, dims and attributes inside blocks will be skipped)
* blocks (only geometry, texts, dimensions and attributes inside blocks are skipped)
* points {{Version|0.13}}
* layers
* leaders {{Version|0.13}}
* paper space objects
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.


===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">
===Экспорт===
Экспортируемый файл DXF совместим с Autocad версии 12 и новее, поэтому он должен открываться в практически любом приложении поддерживающем формат DXF.
В настоящее время поддерживается экспорт следующих объектов FreeCAD:
* линии и многоточечные линии (полилинии)
* дуги и окружности
* текст
* цвета отображаются из RGB в цветовой индекс Autocad (ACI). Чёрный всегда будет отображён в цвет "по слою"
* слои отображаются по именам групп. При вложенных группах, имя слою даёт самая глубоко вложенная группа.
* размеры, которые экспортируются со стилем "стандартный"
</div>

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_CubicBezCurve|Draft CubicBezCurves]], [[Draft_BezCurve|Draft BezCurves]] and [[Draft_Point|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_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>


<div class="mw-translate-fuzzy">
'''Внимание''': По причине лицензирования библиотеки импорта и экспорта DXF более не входят в исходный код FreeCAD. Поэтому данные библиотеки должны быть установлены пользователем, после установки FreeCAD. Это может быть сделано автоматически или вручную.
'''Внимание!''' По причине лицензирования библиотеки импорта и экспорта DXF более не входят в исходный код FreeCAD. Поэтому данные библиотеки должны быть установлены пользователем, после установки FreeCAD. Это может быть сделано автоматически или вручную.
</div>


==Preferences==
====Автоматически====


See [[Import_Export_Preferences|Import Export Preferences]].
Начиная с версии 0.15 достаточно включить опцию Правка -> Параметры -> Импорт/экспорт -> DXF/DWG -> "Автоматически загружать и обновлять библиотеки DXF" для автоматической загрузки и установки данных библиотек. Для более старых версий, требуются ручные действия.


== DWG ==
====Вручную====


Because the DWG format is a proprietary, closed and undocumented format it is hard for open-source projects like FreeCAD to support it. That is why FreeCAD relies on external converters to read and write DWG files. To import a DWG file a converter is used to create a DXF first, which can then be processed by the FreeCAD DXF importer. When exporting to DWG the opposite conversion happens: the DXF created by the FreeCAD DXF exporter is turned into a DWG.
Библиотеки должны быть загружены из https://github.com/yorikvanhavre/Draft-dxf-importer .
Полный пошаговый [[Dxf_Importer_Install|учебник]], объясняющий необходимые действия.


Note that the DXF format allows a 1:1 conversion of the DWG format. All applications that can read and write DWG files can do the same with DXF files, with no data loss. So asking for DXF files instead of DWG files, and supplying DXF files in turn, should not cause any problems.
===Импорт===
Импорт работает таким же образом, как и открытие, но добавляет содержимое файла DXF в активный документ, вместо создания нового документа.


There is built-in support for the following DWG converters:
Учебник: [[Dxf_Importer_Install|Установка Импорта DXF]]
* [https://www.gnu.org/software/libredwg LibreDWG] (open-source, lacks support for some DWG entities).
* [https://www.opendesign.com/guestfiles/oda_file_converter ODA File Converter] (free).
* [https://qcad.org/en/qcad-command-line-tools#dwg2dwg QCAD pro] (commercial). {{Version|0.20}}


See [[Import_Export_Preferences#DWG|Import Export Preferences]] and [[FreeCAD_and_DWG_Import|FreeCAD and DWG Import]] for more information.
===Exporting===
The exported DXF is compatible with Autocad version 12 and up, so it should open in about any application that supports dxf format.
Currently the following FreeCAD objects get exported:
* lines and wires (polylines)
* arcs and circles
* 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


===Preferences===
==Scripting==
The following parameters can be specified in the [[Draft Preferences]] tab (menu Edit -> Preferences -> Draft):
* 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]] availables here.
* Import texts: This allows you to specify if you want to import dxf texts and dimensions or not. Many texts might make your work in FreeCAD very heavy, 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 than model space objects.


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].

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

{{Code|code=
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:

{{Code|code=
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")
}}


<div class="mw-translate-fuzzy">
[[Category:User Documentation/ru]]
[[Category:User Documentation/ru]]
</div>


{{Draft Tools navi{{#translation:}}}}
<languages/>
{{Userdocnavi{{#translation:}}}}
[[Category:File Formats{{#translation:}}]]

Latest revision as of 15:48, 25 October 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.

DWG

Because the DWG format is a proprietary, closed and undocumented format it is hard for open-source projects like FreeCAD to support it. That is why FreeCAD relies on external converters to read and write DWG files. To import a DWG file a converter is used to create a DXF first, which can then be processed by the FreeCAD DXF importer. When exporting to DWG the opposite conversion happens: the DXF created by the FreeCAD DXF exporter is turned into a DWG.

Note that the DXF format allows a 1:1 conversion of the DWG format. All applications that can read and write DWG files can do the same with DXF files, with no data loss. So asking for DXF files instead of DWG files, and supplying DXF files in turn, should not cause any problems.

There is built-in support for the following DWG converters:

See Import Export Preferences and FreeCAD and DWG Import for more information.

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