Skip to main content

A Python package to create/manipulate DXF drawings.

Project description

ezdxf

Abstract

A Python package to create and modify DXF drawings, independent of the DXF version. You can open/save every DXF file without losing any content (except comments), Unknown tags in the DXF file will be ignored but preserved for saving. With this behavior it is possible to open also DXF drawings that contains data from 3rd party applications.

Quick-Info

  • ezdxf is a Python package to create new DXF files and read/modify/write existing DXF files
  • the intended audience are programmers
  • requires at least Python 3.7
  • OS independent
  • tested with CPython and pypy3
  • C-extensions for CPython as binary wheels available on PyPI for Windows, Linux and macOS
  • additional required packages: typing_extensions, pyparsing
  • optional Cython implementation of some low level math classes
  • MIT-License
  • read/write/new support for DXF versions: R12, R2000, R2004, R2007, R2010, R2013 and R2018
  • additional read support for DXF versions R13/R14 (upgraded to R2000)
  • additional read support for older DXF versions than R12 (upgraded to R12)
  • read/write support for ASCII DXF and Binary DXF
  • preserves third-party DXF content

Included Extensions

  • The drawing add-on is a translation layer to send DXF data to a render backend, interfaces to matplotlib, which can export images as png, pdf or svg, and PyQt5 are implemented.
  • geo add-on to support the __geo_interface__
  • r12writer add-on to write basic DXF entities direct and fast into a DXF R12 file or stream
  • iterdxf add-on to iterate over DXF entities of the modelspace of really big (> 5GB) DXF files which do not fit into memory
  • Importer add-on to import entities, blocks and table entries from another DXF document
  • dxf2code add-on to generate Python code for DXF structures loaded from DXF documents as starting point for parametric DXF entity creation
  • acadctb add-on to read/write plot style files (CTB/STB)
  • pycsg add-on for Constructive Solid Geometry (CSG) modeling technique
  • MTextExplode add-on for exploding MTEXT entities into single line TEXT entities

A simple example:

import ezdxf

# Create a new DXF document.
doc = ezdxf.new(dxfversion="R2010")

# Create new table entries (layers, linetypes, text styles, ...).
doc.layers.add("TEXTLAYER", color=2)

# DXF entities (LINE, TEXT, ...) reside in a layout (modelspace, 
# paperspace layout or block definition).  
msp = doc.modelspace()

# Add entities to a layout by factory methods: layout.add_...() 
msp.add_line((0, 0), (10, 0), dxfattribs={"color": 7})
msp.add_text(
    "Test", 
    dxfattribs={
        "layer": "TEXTLAYER"
    }).set_pos((0, 0.2), align="CENTER")

# Save the DXF document.
doc.saveas("test.dxf")

Example for the r12writer, which writes a simple DXF R12 file without in-memory structures:

from random import random
from ezdxf.addons import r12writer

MAX_X_COORD = 1000
MAX_Y_COORD = 1000

with r12writer("many_circles.dxf") as doc:
    for _ in range(100000):
        doc.add_circle((MAX_X_COORD*random(), MAX_Y_COORD*random()), radius=2)

The r12writer supports only the ENTITIES section of a DXF R12 drawing, no HEADER, TABLES or BLOCKS section is present, except FIXED-TABLES are written, than some additional predefined text styles and line types are available.

Installation

Basic installation by pip including the optional C-extensions from PyPI as binary wheels:

pip install ezdxf

Full installation with all dependencies (matplotlib, PyQt5) to use the drawing add-on:

pip install ezdxf[draw]

For more information about the setup & dependencies visit the documentation.

Website

https://ezdxf.mozman.at/

Documentation

Documentation of development version at https://ezdxf.mozman.at/docs

Documentation of the latest release at https://ezdxf.readthedocs.io/

Contribution

The source code of ezdxf can be found at GitHub, target your pull requests to the master branch:

https://github.com/mozman/ezdxf.git

Feedback

Questions and feedback at GitHub Discussions:

https://github.com/mozman/ezdxf/discussions

Questions at Stack Overflow:

Post questions at stack overflow and use the tag dxf or ezdxf.

Issue tracker at GitHub:

http://github.com/mozman/ezdxf/issues

Contact

Please always post questions at the forum or stack overflow to make answers available to other users as well.

ezdxf@mozman.at

Feedback is greatly appreciated.

Manfred

News

Version 0.17.2 - 2022-01-06

  • NEW: extended binary wheels support
    • manylinux2010_x86_64 for Python < 3.10 and manylinux2014_x86_64 for Python >= 3.10
    • musllinux_2010_x86_64 for Python < 3.10 and musllinux_2014_x86_64 for Python >= 3.10
    • manylinux_2014_aarch64 for ARM64 based Linux
    • musllinux_2014_aarch64 for ARM64 based Linux
    • macosx_11_0_arm64 for Apple silicon
    • macosx_10_9_universal2 for Apple silicon & x86
  • NEW: Auditor fixes invalid transparency values
  • NEW: Auditor fixes invalid crease data in MESH entities
  • NEW: add transparency argument to LayerTable.add()
  • NEW: support for transparency BYLAYER and BYBLOCK for the drawing add-on
  • NEW: Textstyle.make_font() returns the ezdxf font abstraction
  • NEW: added dxfattribs argument to method Drawing.set_modelspace_vport()
  • NEW: ezdxf.math.split_bezier() function to split Bezier curves of any degree
  • NEW: ezdxf.math.intersection_line_line_3d()
  • NEW: ezdxf.math.intersect_poylines_2d()
  • NEW: ezdxf.math.intersect_poylines_3d()
  • NEW: ezdxf.math.quadratic_bezier_from_3p()
  • NEW: ezdxf.math.cubic_bezier_from_3p()
  • NEW: BoundingBox.contains(), check if a bounding box contains completely another bounding box
  • NEW: TextEntityAlignment enum replaces the string based alignment definition
  • NEW: method Text.get_placement(), replaces get_pos()
  • NEW: method Text.set_placement(), replaces set_pos()
  • NEW: method Text.get_align_enum(), replaces get_align()
  • NEW: method Text.set_align_enum(), replaces set_align()
  • DEPRECATED: method Text.get_pos() will be removed in v1.0.0
  • DEPRECATED: method Text.set_pos() will be removed in v1.0.0
  • DEPRECATED: method Text.get_align() will be removed in v1.0.0
  • DEPRECATED: method Text.set_align() will be removed in v1.0.0
  • CHANGE: moved enum MTextEntityAlignment to ezdxf.enums
  • CHANGE: moved enum MTextParagraphAlignment to ezdxf.enums
  • CHANGE: moved enum MTextFlowDirection to ezdxf.enums
  • CHANGE: moved enum MTextLineAlignment to ezdxf.enums
  • CHANGE: moved enum MTextStroke to ezdxf.enums
  • CHANGE: moved enum MTextLineSpacing to ezdxf.enums
  • CHANGE: moved enum MTextBackgroundColor to ezdxf.enums
  • CHANGE: Dimstyle.set_tolerance(): argument align as enum MTextLineAlignment
  • CHANGE: DimstyleOverride.set_tolerance(): argument align as enum MTextLineAlignment
  • CHANGE: MeshData.add_edge() is changed to MeshData.add_edge_crease(), this fixes my misunderstanding of edge and crease data in the MESH entity.
  • BUGFIX #574: flattening issues in Path() and ConstructionEllipse()
  • BUGFIX: drawing add-on shows block references in ACAD_TABLE at the correct location
  • BUGFIX #589: Polyface.virtual_entities() yields correct triangle faces
  • BUGFIX: prevent invalid DXF export of the MESH entity
  • PREVIEW: arc length dimension rendering support, new factory methods: add_arc_dim_3p(), add_arc_dim_cra(), add_arc_dim_arc()
  • PREVIEW: ordinate dimension rendering support, new factory methods: add_ordinate_dim(), add_ordinate_x_dim(), add_ordinate_y_dim()
  • PREVIEW: ezdxf.gfxattribs.GfxAttribs() class, docs
  • PREVIEW: command ezdxf info FILE [FILE ...], show info and optional stats of DXF files
  • PREVIEW: approximation tool for parametrized curves: ezdxf.math.ApproxParamT()

Version 0.17.1 - 2021-11-14

  • CHANGE: using PySide6 as Qt binding if installed, PyQt5 is still supported as fallback
  • NEW: tracking feature for DXF entity copies, new properties of DXFEntity
    • source_of_copy - the immediate source of an entity copy
    • origin_of_copy - the first non virtual source entity of an entity copy
    • is_copy - is True if the entity is a copy
  • NEW: source entity tracking for virtual sub-entities for: POINT, LWPOLYLINE, POLYLINE, LEADER, MLINE, ACAD_PROXY_ENTITY
  • NEW: source block reference tracking for virtual entities created from block references, new properties of DXFEntity
    • has_source_block_reference - is True if the virtual entity was created by a block reference
    • source_block_reference - the immediate source block reference (INSERT), which created the virtual entity, otherwise None
  • NEW: ezdxf.tools.text_size module to measure TEXT and MTEXT entity dimensions
  • CHANGE: --ltype arguments of the draw command to approximate and accurate to be in sync with the drawing add-on configuration.
  • CHANGE: --ltype arguments of the view command to approximate and accurate to be in sync with the drawing add-on configuration.
  • REMOVE --scale argument of the view command
  • REMOVE: PolylinePath.PATH_TYPE, use PolylinePath.type instead
  • REMOVE: EdgePath.PATH_TYPE, use EdgePath.type instead
  • BUGFIX: invalid XDATA processing in XData.safe_init()
  • BUGFIX: group code 1003 is valid in XDATA section
  • BUGFIX: fix loading error of DIMSTYLE attribute dimtxsty
  • BUGFIX: fix "Next Entity" and "Previous Entity" actions in the browse command
  • BUGFIX: export MTEXT entities with column count different than the count of linked MTEXT entities
  • BUGFIX: fix invalid text rotation for relative text shifting for linear dimensions
  • PREVIEW: angular dimension rendering support, new factory methods: add_angular_dim_2l(), add_angular_dim_3p(), add_angular_dim_cra()
  • PREVIEW: helper class ezdxf.math.ConstructionPolyline to measure, interpolate and divide polylines and anything that can be approximated or flattened into vertices

Version 0.17 - 2021-10-01

  • Release notes: https://ezdxf.mozman.at/release-v0-17.html
  • NEW: column support for MTEXT read and create, but no editing
  • NEW: factory method BaseLayout.add_mtext_static_columns()
  • NEW: factory method BaseLayout.add_mtext_dynamic_manual_height_columns()
  • NEW: add-on tool MTextExplode() to explode MTEXT entities into single line TEXT entities and additional LINE entities to emulate strokes, requires the Matplotlib package
  • NEW: move_to() command and multi-path support for the ezdxf.path.Path class
  • NEW: regular make_path() support for the HATCH entity, returns a multi-path object
  • NEW: regular make_primitive() support for the HATCH entity
  • NEW: text2path.make_path_from_str() returns a multi-path object
  • NEW: text2path.make_path_from_enity() returns a multi-path object
  • NEW: MPOLYGON load/write/create support
  • NEW: ezdxf.path.to_mpolygons() function: Path() to MPOLYGON converter
  • NEW: ezdxf.path.render_mpolygons() function: render MPOLYGON entities form paths
  • NEW: store ezdxf and custom metadata in DXF files
  • NEW: command ezdxf browse FILE ..., PyQt DXF structure browser
  • NEW: dxf2code add-on: function black() and method Code.black_code_str() returns the code string formatted by Black
  • NEW: ezdxf.upright module to flip inverted extrusion vectors, for more information read the docs
  • NEW: support for ACAD_PROXY_ENTITY
  • NEW: BaseLayout.add_mtext_static_columns()
  • NEW: BaseLayout.add_mtext_dynamic_manual_height_columns()
  • NEW: rendering support for inline codes in MTEXT entities for the drawing add-on
  • NEW: XDATA transformation support
  • NEW: copy support for extension dictionaries
  • CHANGE: drawing add-on: replaced the backend params argument (untyped dict) by the new typed Configuration object passed to the frontend class as argument config
  • REMOVED: deprecated class methods from_...(entity) from Path class, use path.make_path(entity) instead
  • REMOVED: deprecated Path methods add_...(entity), use path.add_...(path, entity) function instead
  • BUGFIX: entity query did not match default values if the attribute was not present
  • BUGFIX: groupby query did not match default values if the attribute was not present
  • BUGFIX: ODAFC add-on - reintroduce accidentally removed global variable exec_path as win_exec_path
  • BUGFIX: graphic entities are not allowed as DICTIONARY entries
  • BUGFIX: copied DICTIONARY was not added to the OBJECTS section by calling factory.bind()
  • BUGFIX: XRecord.copy() copies content tags

Version 0.16.6 - 2021-08-28

  • NEW: MPOLYGON support for the drawing add-on
  • NEW: MPOLYGON support for the geo add-on
  • NEW: fast argument for method MText.plain_text()
  • NEW: support for multi-line ATTRIB and ATTDEF entities in DXF R2018
  • NEW: Auditor removes invalid DXF entities from layouts, blocks and the OBJECTS section
  • NEW: Auditor removes standalone ATTRIB entities from layouts and blocks
  • NEW: Drawing.layers.add() factory method to create new layers
  • NEW: Drawing.styles.add() factory method to create new text styles
  • NEW: Drawing.linetypes.add() factory method to create new line types
  • CHANGE: renamed RenderContext.current_layer to RenderContext.current_layer_properties
  • CHANGE: renamed RenderContext.current_block_reference to RenderContext.current_block_reference_properties
  • CHANGE: extended entity validation for GROUP
  • REMOVED: BaseLayout.add_attrib() factory method to add standalone ATTRIB entities. ATTRIB entities cannot exist as standalone entities.
  • BUGFIX: add missing "doc" argument to DXF loaders, DXF version was not available at loading stage
  • BUGFIX: DXF export for ARC_DIMENSION
  • BUGFIX: Arc.flattening() always have to return Vec3 instances
  • PREVIEW: new features to try out, API may change until official release in v0.17
  • PREVIEW: support for ACAD_PROXY_ENTITY
  • PREVIEW: Rendering support for inline codes in MTEXT entities for the drawing add-on.

Version 0.16.5 - 2021-07-18

  • NEW: hard dependency typing_extensions
  • CHANGE: replaced ezdxf.tools.rgb by ezdxf.colors
  • CHANGE: options module renamed to _options; this eliminates the confusion between the options module and the global object ezdxf.options
  • NEW: config file support, see docs
  • NEW: ezdxf config command to manage config files
  • NEW: ezdxf.path.have_close_control_vertices(a, b), test for close control vertices of two Path objects
  • REMOVED: environment variable options, these are config file only options:
    • EZDXF_AUTO_LOAD_FONTS
    • EZDXF_FONT_CACHE_DIRECTORY
    • EZDXF_PRESERVE_PROXY_GRAPHICS
    • EZDXF_LOG_UNPROCESSED_TAGS
    • EZDXF_FILTER_INVALID_XDATA_GROUP_CODES
  • REMOVED: ezdxf.options.default_text_style, was not used
  • REMOVED: ezdxf.options.auto_load_fonts, disabling auto load has no advantage
  • REMOVED: Vector alias for Vec3
  • REMOVED: get_acis_data(), set_acis_data() and context manager edit_data() from ACIS based entities, use acis_data property instead as List[str] or List[bytes]
  • BUGFIX: Spline.construction_tool() recognizes start- and end tangents for B-splines from fit points if defined
  • PREVIEW: new features to try out, API may change until official release in v0.17
  • PREVIEW: dxf2code add-on: function black() and method Code.black_code_str() returns the code string formatted by Black
  • PREVIEW: ezdxf.upright module to flip inverted extrusion vectors, for more information read the docs

Version 0.16.4 - 2021-06-20

  • NEW: PolylinePath.type and EdgePath.type as ezdxf.entities.BoundaryPathType enum
  • NEW: LineEdge.type, ArcEdge.type, EllipseEdge.type and SplineEdge.type as ezdxf.entities.EdgeType enum
  • NEW: Path.all_lines_to_curve3(), convert all LINE_TO commands into linear CURVE3_TO commands
  • NEW: Path.all_lines_to_curve4(), convert all LINE_TO commands into linear CURVE4_TO commands
  • NEW: create an AppID EZDXF when saving a DXF file by ezdxf
  • BUGFIX: loading crash of the PyQt CADViewer class
  • BUGFIX: loading GEODATA version 1, perhaps data is incorrect, logged as warning
  • BUGFIX: HATCH spline edge from fit points require start- and end tangents
  • BUGFIX: disassemble.make_primitive() transform LWPOLYLINE including width values into WCS
  • BUGFIX: ignore open loops in HATCH edge paths
  • BUGFIX: correct application of the Dimension.dxf.insert attribute
  • BUGFIX: fixed incorrect "thickness" transformation of OCS entities
  • BUGFIX: add missing "width" transformation to POLYLINE and LWPOLYLINE
  • BUGFIX: drawing add-on handles the invisible flag for INSERT correct
  • PREVIEW: new features to try out, API may change until official release in v0.17
  • PREVIEW: move_to() command and multi-path support for the ezdxf.path.Path class
  • PREVIEW: MPOLYGON load/write/create support
  • PREVIEW: store ezdxf and custom metadata in DXF files, see docs
  • PREVIEW: command ezdxf browse FILE, PyQt DXF structure browser
  • PREVIEW: command ezdxf strip FILE [FILE ...], remove comment tags (999) and the THUMBNAILIMAGE section

Version 0.16.3 - 2021-05-22

  • NEW: ezdxf.tools.text.MTextEditor class, extracted from the MText class
  • NEW: MText.set_bg_color(), new argument text_frame to add a text frame
  • CHANGE: move MText constants to MTextEditor class
  • CHANGE: move MText.set_font() to MTextEditor.change_font()
  • CHANGE: move MText.set_color() to MTextEditor.change_color()
  • CHANGE: move MText.append_stacked_text() to MTextEditor.stacked_text()
  • BUGFIX: DXF export of GROUP checks for deleted entities
  • BUGFIX: improved virtual DIMENSION handling
  • BUGFIX: DIMENSION transformation also transform the content of the associated anonymous geometry block content
  • BUGFIX: drawing add-on, true color values always override ACI colors
  • BUGFIX: drawing add-on, handle SOLID as OCS entity like TRACE
  • BUGFIX/CHANGE: Vec2/3.__eq__() (== operator) compares all components with the full floating point precision, use Vec2/3.isclose() to take floating point imprecision into account. This is an annoying but necessary change!
  • CHANGE: new signature for Vec2/3.isclose(other, *, rel_tol=1e-9, abs_tol=1e-12), new argument rel_tol, arguments rel_tol and abs_tol are keyword only

Version 0.16.2 - 2021-04-21

  • CHANGED: ezdxf.path.add_bezier4p(), add linear Bezier curve segments as LINE_TO commands
  • CHANGED: ezdxf.path.add_bezier3p(), add linear Bezier curve segments as LINE_TO commands
  • CHANGED: $FINGERPRINTGUID matches AutoCAD pattern {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
  • CHANGED: $VERSIONGUID matches AutoCAD pattern {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
  • BUGFIX: check for degenerated Bezier curves in have_bezier_curves_g1_continuity()
  • BUGFIX: delete and unlink support for DXFTagStorage (unsupported entities)

Version 0.16.1 - 2021-04-10

  • BUGFIX: disassemble.recursive_decompose() was not recursive
  • BUGFIX: Frontend font resolver uses XDATA if no regular font file is defined
  • BUGFIX: version specific group code for header variable $XCLIPFRAME
  • BUGFIX: INSERT (block reference) transformation

Version 0.16 - 2021-03-27

  • Release notes: https://ezdxf.mozman.at/release-v0-16.html
  • NEW: ezdxf command line launcher, supported commands:
    • pp the previous dxfpp command, the DXF pretty printer
    • audit DXF files
    • draw and convert DXF files by the Matplotlib backend
    • view DXF files by the PyQt viewer
  • NEW: text2path add-on to create Path objects from text strings and text entities, see docs
  • NEW: bbox module to detect the extents (bounding boxes) of DXF entities, see docs
  • NEW: zoom module to reset the active viewport of layouts, see docs
  • NEW: path sub-package, an extended version of the previous ezdxf.render.path module, see docs
  • NEW: support module disassemble, see docs
    1. deconstruct complex nested DXF entities into a flat sequence
    2. create a "primitive" representation of DXF entities
  • NEW: Using the optional Matplotlib package by default for better font metric calculation and font rendering if available.
  • NEW: Cached font metrics are loaded at startup, this can be disabled by the environment variable EZDXF_AUTO_LOAD_FONTS=False, if this slows down the interpreter startup too much.
  • NEW: Layout.reset_extents(), reset layout extents to the given values, or the AutCAD default values
  • NEW: Layout.reset_limits(), reset layout limits to the given values, or the AutCAD default values
  • NEW: Paperspace.reset_main_viewport(), reset the main viewport of a paper space layout to custom- or default values
  • NEW: quadratic Bézier curve support for the Path() class
  • NEW: ezdxf.entity.Text getter/setter properties is_backward and is_upside_down
  • NEW: ezdxf.entity.TextStyle getter/setter properties is_backward, is_upside_down and is_vertical_stacked
  • NEW: ezdxf.math.Bezier3P, optimized quadratic Bézier curve construction tool
  • NEW: ezdxf.math.quadratic_to_cubic_bezier(), Bezier3P to Bezier4P converter
  • NEW: ezdxf.math.bezier_to_bspline(), Bézier curves to B-spline converter
  • NEW: ezdxf.math.clip_polygon_2d(), clip polygon by a convex clipping polygon
  • NEW: ezdxf.math.basic_transformation(), returns a combined transformation matrix for translation, scaling and rotation about the z-axis
  • NEW: ezdxf.math.best_fit_normal(), returns the normal vector of flat spatial planes
  • NEW: fit_points_to_cubic_bezier() creates a visual equal SPLINE from fit points without end tangents like BricsCAD, but only for short B-splines.
  • CHANGED: fit_points_to_cad_cv(), removed unused arguments degree and method
  • CHANGED: ezdxf.render.nesting content moved into the ezdxf.path package
  • CHANGED: renamed MeshBuilder.render() to MeshBuilder.render_mesh()
  • CHANGED: ezdxf.math.BSpline is immutable, all methods return a new BSpline object
  • CHANGED: replaced BSplineU() class by factory function ezdxf.math.open_uniform_bspline()
  • CHANGED: replaced BSplineClosed() class by factory function ezdxf.math.closed_uniform_bspline()
  • CHANGED: renamed rational_spline_from_arc() to rational_bspline_from_arc()
  • CHANGED: renamed rational_spline_from_ellipse() to rational_bspline_from_ellipse()
  • BUGFIX: fixed ezdxf.math.rational_bspline_from_ellipse() invalid parameter conversion
  • DEPRECATED: ezdxf.render.path module, replaced by ezdxf.path package
  • DEPRECATED: Path.from_lwpolyline(), replaced by factory path.make_path()
  • DEPRECATED: Path.from_polyline(), replaced by factory path.make_path()
  • DEPRECATED: Path.from_spline(), replaced by factory path.make_path()
  • DEPRECATED: Path.from_ellipse(), replaced by factory path.make_path()
  • DEPRECATED: Path.from_arc(), replaced by factory path.make_path()
  • DEPRECATED: Path.from_circle(), replaced by factory path.make_path()
  • DEPRECATED: Path.add_curve(), replaced by function path.add_bezier4p()
  • DEPRECATED: Path.add_ellipse(), replaced by function path.add_ellipse()
  • DEPRECATED: Path.add_spline(), replaced by function path.add_spline()
  • DEPRECATED: Path.from_vertices(), replaced by factory path.from_vertices()
  • REMOVED: Path.from_hatch_boundary_path(), replaced by factory path.from_hatch()
  • REMOVED: Path.from_hatch_polyline_path()
  • REMOVED: Path.from_hatch_edge_path()
  • REMOVED: BlocksSection.purge(), unsafe operation
  • REMOVED: dxfpp command, replaced by ezdxf pp ...
  • REMOVED: Layout.add_closed_spline(), broken and nobody noticed it
  • REMOVED: Layout.add_closed_rational_spline(), broken and nobody noticed it

Version 0.15.2 - 2021-02-07

  • Active Python 3.6 support removed, no tests and no deployment of binary wheels for Python 3.6
  • NEW: BoundingBox() intersection test, inside- and outside tests, union of two bounding boxes.
  • NEW: ezdxf.math.ellipse_param_span(), works the same way as arc_angle_span_deg() for special cases
  • NEW: DXFEntity.uuid property, returns an UUID on demand, which allows distinguishing even virtual entities without a handle
  • CHANGE: extraction of many text utility functions into ezdxf.tools.text
  • CHANGE: add_polyline2d(), add_polyline3d(), add_lwpolyline() and add_mline() got argument close to create a closed polygon and dxfattrib closed is deprecated, close and dxfattribs for these factories are keyword only arguments.
  • CHANGE: improved text alignment rendering in the drawing add-on
  • CHANGE: moved ezdxf.addons.drawing.fonts.py into ezdxf.tools and added a font measurement cache.
  • BUGFIX: FIT and ALIGNED text rendering in the drawing add-on
  • BUGFIX: matplotlib backend uses linewidth=0 for solid filled polygons and the scaled linewidth for polygons with pattern filling
  • BUGFIX: clipping path calculation for IMAGE and WIPEOUT
  • BUGFIX: transformation of a closed (360deg) arc preserves a closed arc
  • BUGFIX: bulge values near 0 but != 0 caused an exception in Path.add_2d_polyline()
  • BUGFIX: invalid polygon building in the geo add-on

Version 0.15.1 - 2021-01-15

  • NEW: Spline.audit() audit support for the SPLINE entity
  • NEW: The recover module tolerates malformed group codes and value tags.
  • Changed the Matrix44.matrix attribute in the Python implementation to a "private" attribute Matrix44._matrix, because this attribute is not available in the Cython implementation
  • BUGFIX: proxy graphic decoding error on big-endian systems
  • BUGFIX: invalid vertex subscript access in dxf2code add-on
  • BUGFIX: cubic_bezier_from_ellipse() recognizes full ellipses
  • BUGFIX: cubic_bezier_from_arc() recognizes full circles
  • BUGFIX: pickle support for C-extensions Vec2, Vec3, Matrix44 and Bezier4P
  • BUGFIX: attribute error when exporting matrices in the MATERIAL entity

Version 0.15 - 2020-12-30

  • Release notes: https://ezdxf.mozman.at/release-v0-15.html
  • NEW: linetype support for matplotlib- and pyqt drawing backend
  • NEW: HATCH island support for matplotlib- and pyqt drawing backend
  • NEW: basic HATCH pattern support for matplotlib- and pyqt drawing backend
  • NEW: Font support for matplotlib- and pyqt drawing backend
  • NEW: POINT mode support for matplotlib- and pyqt drawing backend, relative point size is not supported
  • NEW: Proxy graphic support for the drawing add-on
  • NEW: recover misplaced tags of the AcDbEntity subclass (color, layer, linetype, ...), supported by all loading modes
  • NEW: ezdxf.addons.geo module, support for the __geo_interface__, see docs and tutorial
  • NEW: GeoData.setup_local_grid() setup geo data for CRS similar to EPSG:3395 World Mercator
  • NEW: MLINE support but without line break and fill break (gaps) features
  • NEW: Bezier.flattening() adaptive recursive flattening (approximation)
  • NEW: Bezier4P.flattening() adaptive recursive flattening (approximation)
  • NEW: Path.flattening() adaptive recursive flattening (approximation)
  • NEW: Circle.flattening() approximation determined by a max. sagitta value
  • NEW: Arc.flattening() approximation determined by a max. sagitta value
  • NEW: ConstructionArc.flattening() approximation determined by a max. sagitta value
  • NEW: ezdxf.math.distance_point_line_3d()
  • NEW: ConstructionEllipse.flattening() adaptive recursive flattening (approximation)
  • NEW: Ellipse.flattening() adaptive recursive flattening (approximation)
  • NEW: BSpline.flattening() adaptive recursive flattening (approximation)
  • NEW: Spline.flattening() adaptive recursive flattening (approximation)
  • NEW: matplotlib.qsave(), ltype argument to switch between matplotlib dpi based linetype rendering and AutoCAD like drawing units based linetype rendering
  • NEW: Solid.vertices() returns OCS vertices in correct order (also Trace)
  • NEW: Solid.wcs_vertices() returns WCS vertices in correct order (also Trace)
  • NEW: Face3D.wcs_vertices() compatibility interface to SOLID and TRACE
  • NEW: Hatch.paths.external_paths() returns iterable of external boundary paths
  • NEW: Hatch.paths.outermost_paths() returns iterable of outer most boundary paths
  • NEW: Hatch.paths.default_paths() returns iterable of default boundary paths
  • NEW: Hatch.paths.rendering_paths() returns iterable of paths to process for rendering
  • NEW: Drawing.units property to get/set document/modelspace units
  • NEW: ezdxf.new() argument units to setup document and modelspace units and $MEASUREMENT setting and the linetype setup is based on this $MEASUREMENT setting.
  • NEW: pattern.load(measurement, factor) load scaled hatch pattern
  • NEW: Path.from_hatch_boundary_path()
  • NEW: odafc.export_dwg() new replace option to delete existing DWG files
  • NEW Style table entry supports extended font data
  • NEW: Point.virtual_entities(), yield POINT entities as DXF primitives
  • NEW: ezdxf.render.point, support module for Point.virtual_entities()
  • NEW: Optional Cython implementation of some low level math classes: Vec2, Vec3, Matrix44, Bezier4P
  • NEW: support for complex linetypes for the Importer add-on
  • CHANGE: Optimized infrastructure for loading DXF attributes
  • CHANGE: Hatch.set_pattern_fill() uses HEADER variable $MEASUREMENT to determine the default scaling of predefined hatch pattern.
  • CHANGE: fix invalid linetype setup - new linetype scaling like common CAD applications
  • CHANGE: ezdxf.colors module will consolidate all color/transparency related features
  • CHANGE: renamed ezdxf.math.Vector to Vec3, but Vector remains as synonym
  • DEPRECATED: ezdxf.tools.rgb module replaced by ezdxf.colors
  • REMOVED: deprecated DXFEntity.transform_to_wcs() interface, use DXFEntity.transform(ucs.matrix)
  • REMOVED: deprecated Hatch.edit_boundary() context manager, use Hatch.paths attribute
  • REMOVED: deprecated Hatch.get_gradient() method, use Hatch.gradient attribute
  • REMOVED: deprecated Hatch.edit_gradient() context manager, use Hatch.gradient attribute
  • REMOVED: deprecated Hatch.edit_pattern() context manager, use Hatch.pattern attribute
  • REMOVED: deprecated Hatch.get_seed_points() method, use Hatch.seeds attribute
  • REMOVED: unnecessary argument non_uniform_scaling from Insert.explode()
  • REMOVED: unnecessary argument non_uniform_scaling from Insert.virtual_entities()
  • REMOVED: deprecated Spline.edit_data() context manager, use fit_points, control_points, knots and weights attributes
  • BUGFIX: ezdxf.math.has_clockwise_orientation() returns True for counter-clock wise and vice versa
  • BUGFIX: default color for HATCH is 256 (by layer)
  • BUGFIX: fixed broken complex linetype setup
  • BUGFIX: validate loaded handle seed

Version 0.14.2 - 2020-10-18

Version 0.14.1 - 2020-09-19

  • Release notes: https://ezdxf.mozman.at/release-v0-14.html
  • BUGFIX: MLEADER and MLEADERSTYLE min DXF version changed to R2000
  • BUGFIX: AutoCAD ignores not existing default objects in ACDBDICTIONARYWDFLT and so ezdxf have to. Auditor() creates a place holder object as default value.

Version 0.14 - 2020-09-12

  • Release notes: https://ezdxf.mozman.at/release-v0-14.html
  • NEW: DXF attribute setter validation, some special and undocumented Autodesk table names may raise ValueError() exceptions, please report this table names (layers, linetypes, styles, ...). DXF unicode notation "\U+xxxx" raises a ValueError() if used as resource names like layer name or text style names, such files can only be loaded by the new recover module.
  • NEW: ezdxf.recover module to load DXF Documents with structural flaws, see docs
  • NEW: All DXF loading functions accept an unicode decoding error handler: "surrogateescape", "ignore" or "strict", see docs of the recover module for more information.
  • NEW: addons.drawing.Frontend() supports width attributes of LWPOLYLINE and 2D POLYLINE entities
  • NEW: TraceBuilder() a render tool to generate quadrilaterals (TRACE, SOLID or 3DFACE), from LWPOLYLINE or 2D POLYLINE with width information, see docs
  • NEW: Path() a render tool for paths build of lines and cubic Bezier curves, used for faster rendering of LWPOLYLINE, POLYLINE and SPLINE entities for render back-ends, see docs
  • NEW: drawing.matplotlib.qsave() function, a simplified matplotlib export interface
  • NEW: Arc.construction_tool() returns the 2D ConstructionArc()
  • NEW: Arc.apply_construction_tool() apply parameters from ConstructionArc()
  • NEW: Leader.virtual_entities() yields 'virtual' DXF primitives
  • NEW: Leader.explode() explode LEADER as DXF primitives into target layout
  • NEW: LWPolyline.has_width property is True if any width attribute is set
  • NEW: Polyline.has_width property is True if any width attribute is set
  • NEW: Polyline.audit() extended verify and repair support
  • NEW: Polyline.append_formatted_vertices(), support for user defined point format
  • NEW: DXFVertex.format() support for user defined point format
  • NEW: Drawing.blocks.purge() delete all unused blocks but protect modelspace- and paperspace layouts, special arrow blocks and DIMENSION and ACAD_TABLE blocks in use, but see also warning in the docs
  • NEW: Insert.explode() support for MINSERT (multi insert)
  • NEW: Insert.virtual_entities() support for MINSERT (multi insert)
  • NEW: Insert.mcount property returns multi insert count
  • NEW: Insert.multi_insert() yields a virtual INSERT entity for each grid element of a MINSERT entity
  • NEW: Layout.add_wipeout() interface to create WIPEOUT entities
  • NEW: Image.boundary_path_wcs(), returns boundary path in WCS coordinates
  • NEW: Wipeout.boundary_path_wcs(), returns boundary path in WCS coordinates
  • NEW: Wipeout.set_masking_area()
  • NEW: BSpline.is_clamped property is True for a clamped (open) B-spline
  • NEW: UCS.transform() general transformation interface
  • NEW: Bezier4P.transform() general transformation interface
  • NEW: Bezier4P.reverse() returns object with reversed control point order
  • NEW: Bezier.transform() general transformation interface
  • NEW: Bezier.reverse() returns object with reversed control point order
  • NEW: has_clockwise_orientation(vertices) returns True if the closed polygon of 2D vertices has clockwise orientation
  • NEW: DXFEntity.new_extension_dict(), create explicit a new extension dictionary
  • NEW: ezdxf.reorder, support module to implement modified entities redraw order
  • NEW: get DXF test file path from environment variable EZDXF_TEST_FILES, imported automatically as ezdxf.EZDXF_TEST_FILES
  • NEW: arc_chord_length() and arc_segment_count() tool functions in ezdxf.math
  • NEW: Drawing.encode() to encode unicode strings with correct encoding and error handler
  • NEW: ezdxf.has_dxf_unicode() to detect "\U+xxxx" encoded chars
  • NEW: ezdxf.decode_dxf_unicode() to decode strings containing
    "\U+xxxx" encoded chars, the new recover module decodes such strings automatically.
  • CHANGE: DXFEntity.get_extension_dict(), raises AttributeError if entity has no extension dictionary
  • CHANGE: DXFEntity.has_extension_dict is now a property not a method
  • CHANGE: linspace() uses Decimal() for precise calculations, but still returns an iterable of float
  • CHANGE: Drawing.blocks.delete_all_blocks(), unsafe mode is disabled and argument safe is deprecated, will be removed in v0.16
  • CHANGE: Dictionary raise DXFValueError for adding invalid handles
  • CHANGE: BaseLayout.add_entity() will bind entity automatically to doc/db if possible
  • CHANGE: handle all layout names as case insensitive strings: Model == MODEL
  • REMOVE: option.check_entity_tag_structure, entity check is done only in recover mode
  • REMOVE: legacy_mode in ezdxf.read() and ezdxf.readfile(), use the ezdxf.recover module to load DXF Documents with structural flaws
  • REMOVE: Alias DXFEntity.drawing use DXFEntity.doc
  • REMOVE: DXFEntity.entitydb
  • REMOVE: DXFEntity.dxffactory
  • REMOVE: DXFInvalidLayerName, replaced by DXFValueError
  • REMOVE: Image.get_boundary_path(), replaced by property Image.boundary_path
  • REMOVE: Image.get_image_def(), replaced by property Image.image_def
  • REMOVE: filter_stack argument in ezdxf.read() and ezdxf.readfile()
  • BUGFIX: Set non-constant-attribs flag (2) in BLOCK at DXF export if non constant ATTDEF entities are present.
  • BUGFIX: DXF R2018 - HATCH extrusion vector (210) is mandatory?
  • BUGFIX: Layout names are case insensitive; "MODEL" == "Model"
  • BUGFIX: Using "surrogateescape" error handler to preserve binary data in ASCII DXF files. Prior versions of ezdxf corrupted this data by using the "ignore" error handler; Example file with binary data in XRECORD is not valid for TrueView 2020 - so binary data is maybe not allowed.

Version 0.13.1 - 2020-07-18

Version 0.13 - 2020-07-04

  • Release notes: https://ezdxf.mozman.at/release-v0-13.html
  • NEW: general transformation interface: DXFGraphic.transform(m), transform entity by a transformation matrix m inplace
  • NEW: specialized entity transformation interfaces:
    • DXFGraphic.translate(dx, dy, dz)
    • DXFGraphic.scale(sx, sy, sz)
    • DXFGraphic.scale_uniform(s)
    • DXFGraphic.rotate_axis(axis, angle)
    • DXFGraphic.rotate_x(angle)
    • DXFGraphic.rotate_y(angle)
    • DXFGraphic.rotate_z(angle)
  • NEW: drawing add-on by Matt Broadway is a translation layer to send DXF data to a render backend, supported backends for now: matplotlib and PyQt5, both packages are optional and not required to install ezdxf.
  • NEW: DXFGraphic.unlink_from_layout() to unlink entity from associated layout
  • NEW: Arc.angles(num), yields num angles from start- to end angle in counter clockwise order
  • NEW: Circle.to_ellipse(), convert CIRCLE/ARC to ELLIPSE entity
  • NEW: Circle.to_spline(), convert CIRCLE/ARC to SPLINE entity
  • NEW: Ellipse.params(num), yields num params from start- to end param in counter clockwise order
  • NEW: Ellipse.construction_tool(), return ellipse data as ConstructionEllipse()
  • NEW: Ellipse.apply_construction_tool(), apply ConstructionEllipse() data
  • NEW: Ellipse.to_spline(), convert ELLIPSE to SPLINE entity
  • NEW: Ellipse.from_arc(), create a new ELLIPSE entity from CIRCLE or ARC entity (constructor)
  • NEW: Spline.construction_tool(), return spline data as ezdxf.math.BSpline()
  • NEW: Spline.apply_construction_tool(), apply ezdxf.math.BSpline() data
  • NEW: Spline.from_arc(), create a new SPLINE entity from CIRCLE, ARC or ELLIPSE entity (constructor)
  • NEW: Hatch.set_pattern_scale() to set scaling of pattern definition
  • NEW: Hatch.set_pattern_angle() to set rotation angle of pattern definition
  • NEW: Hatch.paths.polyline_to_edge_paths() convert polyline paths with bulge values to edge paths with lines and arcs
  • NEW: Hatch.paths.arc_edges_to_ellipse_edges() convert arc edges to ellipse edges
  • NEW: Hatch.paths.ellipse_edges_to_spline_edges() convert ellipse edges to spline edges
  • NEW: Hatch.paths.all_to_spline_edges() convert all curves to approximated spline edges
  • NEW: Hatch.paths.all_to_line_edges() convert all curves to approximated line edges
  • NEW: Text.plain_text() returns text content without formatting codes
  • NEW: ezdxf.math.ConstructionEllipse()
  • NEW: ezdxf.math.linspace() like numpy.linspace()
  • NEW: ezdxf.math.global_bspline_interpolation() supports start- and end tangent constraints
  • NEW: ezdxf.math.estimate_tangents() curve tangent estimator for given fit points
  • NEW: ezdxf.math.estimate_end_tangent_magnitude() curve end tangent magnitude estimator for given fit points
  • NEW: ezdxf.math.rational_bspline_from_arc() returns a rational B-spline for a circular arc
  • NEW: ezdxf.math.rational_bspline_from_ellipse() returns a rational B-spline for an elliptic arc
  • NEW: ezdxf.math.local_cubic_bspline_interpolation()
  • NEW: ezdxf.math.cubic_bezier_from_arc() returns an approximation for a circular 2D arc by multiple cubic Bezier curves
  • NEW: ezdxf.math.cubic_bezier_from_ellipse() returns an approximation for an elliptic arc by multiple cubic Bezier curves
  • NEW: ezdxf.math.cubic_bezier_interpolation() returns an interpolation curve for arbitrary data points as multiple cubic Bezier curves
  • NEW: ezdxf.math.LUDecomposition linear equation solver, for more linear algebra tools see module ezdxf.math.linalg
  • NEW: ezdxf.render.random_2d_path() generate random 2D path for testing purpose
  • NEW: ezdxf.render.random_3d_path() generate random 3D path for testing purpose
  • NEW: BSpline() uses normalized knot vector for 'clamped' curves by default (open uniform knots)
  • NEW: BSpline.points() compute multiple points
  • NEW: BSpline.derivative() compute point and derivative up to n <= degree
  • NEW: BSpline.derivatives() compute multiple points and derivatives up to n <= degree
  • NEW: BSpline.params() return evenly spaced B-spline params from start- to end param
  • NEW: BSpline.reverse() returns a new reversed B-spline
  • NEW: BSpline.from_arc() B-spline from an arc, best approximation with a minimum number of control points
  • NEW: BSpline.from_ellipse() B-spline from an ellipse, best approximation with a minimum number of control points
  • NEW: BSpline.from_fit_points() B-spline from fit points
  • NEW: BSpline.arc_approximation() B-spline approximation from arc vertices as fit points
  • NEW: BSpline.ellipse_approximation() B-spline approximation from ellipse vertices as fit points
  • NEW: BSpline.transform() transform B-spline by transformation matrix inplace
  • NEW: BSpline.transform() transform B-spline by transformation matrix inplace
  • NEW: BSpline.to_nurbs_python_curve() and BSpline.from_nurbs_python_curve(), interface to NURBS-Python, NURBS-Python is now a testing dependency
  • NEW: BSpline.bezier_decomposition() decompose a non-rational B-spline into multiple Bezier curves
  • NEW: BSpline.cubic_bezier_approximation() approximate any B-spline by multiple cubic Bezier curves
  • NEW: Bezier.points() compute multiple points
  • NEW: Bezier.derivative() compute point, 1st and 2nd derivative for one parameter
  • NEW: Bezier.derivatives() compute point and derivative for multiple parameters
  • CHANGE: Hatch full support for rotated patterns.
  • CHANGE: Hatch.set_pattern_definition() added argument angle for pattern rotation.
  • CHANGE: Hatch.path.add_arc renamed argument is_counter_clockwise to ccw, type bool and True by default
  • CHANGE: Hatch.path.add_ellipse renamed argument is_counter_clockwise to ccw, type bool and True by default
  • CHANGE: renamed 2D ConstructionXXX.move() methods to translate()
  • CHANGE: renamed old Insert.scale() to Insert.set_scale(), name conflict with transformation interface
  • CHANGE: renamed Spline.set_periodic() to Spline.set_closed()
  • CHANGE: renamed Spline.set_periodic_rational() to Spline.set_closed_rational()
  • CHANGE: renamed ezdxf.math.bspline_control_frame() to ezdxf.math.global_bspline_interpolation()
  • REMOVED: ezdxf.math.Matrix33 class, UCS and OCS uses Matrix44for transformations
  • REMOVED: ezdxf.math.BRCS class and Insert.brcs()
  • REMOVED: ezdxf.math.ConstructionTool base class
  • REMOVED: ezdxf.math.normalize_angle(angle), replace call by expression: angle % math.tau
  • REMOVED: ezdxf.math.DBSpline, integrated as BSpline.derivatives()
  • REMOVED: ezdxf.math.DBSplineU, integrated as BSplineU.derivatives()
  • REMOVED: ezdxf.math.DBSplineClosed, integrated as BSplineClosed.derivatives()
  • REMOVED: ezdxf.math.DBezier, integrated as Bezier.derivatives()
  • REMOVED: BaseLayout.add_spline_approx(), incorrect and nobody noticed it - so it's not really needed, if required use the geomdl.fitting.approximate_curve() function from the package NURBS-Python, see example using_nurbs_python.py
  • REMOVED: ezdxf.math.bspline_control_frame_approx(), incorrect and nobody noticed it - so it's not really needed
  • DEPRECATED: DXFGraphic.transform_to_wcs(ucs), replace call by DXFGraphic.transform(ucs.matrix)
  • DEPRECATED: non_uniform_scaling argument for Insert.explode()
  • DEPRECATED: non_uniform_scaling argument for Insert.virtual_entities()
  • DEPRECATED: getter and edit methods in Hatch for attributes paths, gradient, pattern and seeds
  • DEPRECATED: Spline.edit_data() all attributes accessible by properties
  • BUGFIX: ezdxf.math.intersection_ray_ray_3d()
  • BUGFIX: Spline.set_periodic() created invalid data for BricsCAD - misleading information by Autodesk

Version 0.12.5 - 2020-06-05

  • BUGFIX: DXF export error for hatches with rational spline edges

Version 0.12.4 - 2020-05-22

  • BUGFIX: structure validator for XRECORD

Version 0.12.3 - 2020-05-16

  • BUGFIX: DXF R2010+ requires zero length tag 97 for HATCH/SplineEdge if no fit points exist (vshu3000)
  • BUGFIX: Export order of XDATA and embedded objects (vshu3000)
  • BUGFIX: ATTRIB and ATTDEF did not load basic DXF attributes
  • NEW: BlockLayout() properties can_explode and scale_uniformly
  • NEW: Hatch.remove_association()

Version 0.12.2 - 2020-05-03

  • BUGFIX: XData.get() now raises DXFValueError for not existing appids, like all other methods of the XData() class
  • BUGFIX: Layer.description returns an empty string for unknown XDATA structure in AcAecLayerStandard
  • BUGFIX: Initialize/Load Hatch edge coordinates as Vec2() objects
  • BUGFIX: typo in 3 point angular dimension subclass marker (vshu3000)
  • BUGFIX: HATCH/SplineEdge did export length tag 97 if no fit points exist, creates invalid DXF for AutoCAD/BricsCAD (vshu3000)
  • BUGFIX: Ellipse handling in virtual_block_reference_entities() (Matt Broadway)

Version 0.12.1 - 2020-04-25

  • BUGFIX: fixed uniform scaled ellipse handling in explode.virtual_block_reference_entities()
  • BUGFIX: fixed crash caused by floating point inaccuracy in Vector.angle_between() (Matt Broadway)
  • BUGFIX: fixed crash for axis transformation of nearly perpendicular ellipse axis
  • BUGFIX: fixed Hatch.has_critical_elements()

Version 0.12 - 2020-04-12

  • Release notes: https://ezdxf.mozman.at/release-v0-12.html
  • NEW: Insert.block() returns associated BlockLayout() or None if block not exist or is an XREF
  • NEW: Insert.has_scaling returns True if any axis scaling is applied
  • NEW: Insert.has_uniform_scaling returns True if scaling is uniform in x-, y- and z-axis.
  • NEW: Insert.scale(factor) set uniform scaling.
  • NEW: Insert.virtual_entities() yields 'virtual' entities of a block reference (experimental)
  • NEW: Insert.explode() explode block reference entities into target layout (experimental)
  • NEW: Insert.add_auto_attribs() add ATTRIB entities defined as ATTDEF in the block layout and fill tags with values defined by a dict (experimental)
  • NEW: LWPolyline.virtual_entities() yields 'virtual' LINE and ARC entities
  • NEW: LWPolyline.explode() explode LWPOLYLINE as LINE and ARC entities into target layout
  • NEW: Polyline.virtual_entities() yields 'virtual' LINE, ARC or 3DFACE entities
  • NEW: Polyline.explode() explode POLYLINE as LINE, ARC or 3DFACE entities into target layout
  • NEW: Dimension.virtual_entities() yields 'virtual' DXF entities
  • NEW: Dimension.explode() explode DIMENSION as basic DXF entities into target layout
  • NEW: Dimension.transform_to_wcs() support for UCS based entity transformation
  • NEW: Dimension.override() returns DimStyleOverride() object
  • NEW: Dimension.render() render graphical representation as anonymous block
  • NEW: Block() properties is_anonymous, is_xref and is_xref_overlay
  • NEW: R12FastStreamWriter.add_polyline_2d(), add 2D POLYLINE with start width, end width and bulge value support
  • NEW: Ellipse.minor_axis property returns minor axis as Vector
  • NEW: Option ezdxf.options.write_fixed_meta_data_for_testing, writes always same timestamps and GUID
  • NEW: Support for loading and exporting proxy graphic encoded as binary data, by default disabled
  • NEW: ezdxf.proxygraphic.ProxyGraphic() class to examine binary encoded proxy graphic (Need more example data for testing!)
  • NEW: Get/set hyperlink for graphic entities
  • NEW: odafc add-on to use an installed ODA File Converter for reading and writing DWG files
  • NEW: Support for reading and writing Binary DXF files
  • NEW: Binary DXF support for r12writer add-on
  • CHANGE: R12FastStreamWriter.add_polyline(), add 3D POLYLINE only, closed flag support
  • CHANGE: renamed Insert.ucs() to Insert.brcs() which now returns a BRCS() object
  • CHANGE: Polyline.close(), Polyline.m_close() and Polyline.n_close() can set and clear closed state.
  • BUGFIX: Dimension.destroy() should not not destroy associated anonymous block, because if DIMENSION is used in a block, the anonymous block may be used by several block references
  • BUGFIX: floating point precision error in intersection_line_line_2d()
  • BUGFIX: attribute error in Polyline.transform_to_wcs() for 2d polylines
  • BUGFIX: LWPOLYLINE was always exported with const_width=0
  • BUGFIX: Face3d.set_edge_visibility() set inverted state (visible <-> invisible)
  • BUGFIX: Load AcDbEntity group codes from base class

Version 0.11.2 - 2020-04-03

  • BUGFIX: upgrade error from DXF R13/14 to R2000

Version 0.11.1 - 2020-02-29

  • NEW: Meshbuilder.from_polyface() to interface to POLYFACE and POLYMESH
  • NEW: Meshbuilder.render_polyface() create POLYFACE objects
  • NEW: MeshAverageVertexMerger() an extended version of MeshVertexMerger(), location of merged vertices is the average location of all vertices with the same key
  • NEW: ezdxf.addons.iterdxf iterate over modelspace entities of really big DXF files (>1 GB) without loading them into memory
  • NEW: ezdxf.addons.r12writer supports POLYFACE and POLYMESH entities
  • NEW: Layout.add_foreign_entity() copy/move simple entities from another DXF document or add unassigned DXF entities to a layout
  • NEW: MText.plain_text() returns text content without formatting codes
  • CHANGE: refactor Auditor() into a DXF document fixer, fixes will be applied automatically (work in progress)
  • CHANGE: moved r12writer into addons subpackage
  • CHANGE: moved acadctb into addons subpackage

Version 0.11 - 2020-02-15

  • Release notes: https://ezdxf.mozman.at/release-v0-11.html
  • Using standard git branches:
    • master: development state
    • stable: latest stable release
  • Requires Python 3.6
  • NEW: Dimension.get_measurement() supports angular, angular3p and ordinate dimensions
  • NEW: Layout.add_radius_dim() implemented
  • NEW: shortcut calls Layout.add_radius_dim_2p() and Layout.add_radius_dim_cra()
  • NEW: Layout.add_diameter_dim() implemented
  • NEW: shortcut Layout.add_diameter_dim_2p()
  • NEW: Circle.vertices(angles) yields vertices for iterable angles in WCS
  • NEW: Ellipse.vertices(params) yields vertices for iterable params in WCS
  • NEW: Arc properties start_point and end_point returns start- and end point of arc in WCS
  • NEW: Ellipse properties start_point and end_point returns start- and end point of ellipse in WCS
  • NEW: user defined point format support for 2d POLYLINE entities: add_polyline2d([(1, 2, 0.5), (3, 4, 0)], format='xyb')
  • NEW: Polyline.append_formatted_points() with user defined point format support
  • NEW: Drawing.set_modelspace_vport(height, center) set initial view/zoom location for the modelspace
  • NEW: support for associating HATCH boundary paths to geometry entities
  • NEW: Drawing.output_encoding returns required output encoding
  • NEW: User Coordinate System (UCS) based entity transformation, allows to work with UCS coordinates, which are simpler if the UCS is chosen wisely, and transform them later into WCS coordinates. Entities which have a transform_to_wcs(ucs) method, automatically take advantage of the new UCS transformation methods, but not all entity types are supported, embedded ACIS entities like 3DSOLID, REGION, SURFACE and so on, do not expose their geometry.
  • NEW: transform_to_wcs(ucs) implemented for: 3DFACE, ARC, ATTDEF, ATTRIB, CIRCLE, ELLIPSE, HATCH, IMAGE, INSERT, LEADER, LINE, LWPOLYLINE, MESH, MTEXT, POINT, POLYLINE, RAY, SHAPE, SOLID, SPLINE, TEXT, TRACE, XLINE
  • NEW: UCS.rotate(axis, angle) returns a new UCS rotated around WCS vector axis
  • NEW: UCS.rotate_local_x(angle) returns a new UCS rotated around local x-axis
  • NEW: UCS.rotate_local_y(angle) returns a new UCS rotated around local y-axis
  • NEW: UCS.rotate_local_z(angle) returns a new UCS rotated around local z-axis
  • NEW: UCS.copy() returns a new copy of UCS
  • NEW: UCS.shift(delta) shifts UCS inplace by vector delta
  • NEW: UCS.moveto(location) set new UCS origin to location inplace
  • NEW: size and center properties for bounding box classes
  • NEW: Insert.ucs() returns an UCS placed in block reference insert location, UCS axis aligned to the block axis.
  • NEW: Insert.reset_transformation() reset block reference location, rotation and extrusion vector.
  • CHANGE: renamed ezdxf.math.left_of_line to ezdxf.math.is_point_left_of_line
  • NEW: ezdxf.math.point_to_line_relation() 2D function returns -1 for left oft line, +1 for right oif line , 0 on the line
  • NEW: ezdxf.math.is_point_on_line_2d() test if 2D point is on 2D line
  • NEW: ezdxf.math.distance_point_line_2d() distance of 2D point from 2D line
  • NEW: ezdxf.math.is_point_in_polygon_2d() test if 2D point is inside of a 2D polygon
  • NEW: ezdxf.math.intersection_line_line_2d() calculate intersection for 2D lines
  • NEW: ezdxf.math.offset_vertices_2d() calculate 2D offset vertices for a 2D polygon
  • NEW: ezdxf.math.normal_vector_3p() returns normal vector for 3 points
  • NEW: ezdxf.math.is_planar_face() test if 3D face is planar
  • NEW: ezdxf.math.subdivide_face() linear subdivision for 2D/3D faces/polygons
  • NEW: ezdxf.math.intersection_ray_ray_3d() calculate intersection for 3D rays
  • NEW: ezdxf.math.Plane() 3D plane construction tool
  • NEW: ezdxf.render.MeshTransformer() inplace mesh transformation class, subclass of MeshBuilder()
  • NEW: MeshBuilder.render() added UCS support
  • NEW: MeshBuilder.render_normals() render face normals as LINE entities, useful to check face orientation
  • NEW: ezdxf.render.forms.cone_2p() create 3D cone mesh from two points
  • NEW: ezdxf.render.forms.cylinder_2p() create 3D cylinder mesh from two points
  • NEW: ezdxf.render.forms.sphere() create 3D sphere mesh
  • NEW: pycsg add-on, a simple Constructive Solid Geometry (CSG) kernel created by Evan Wallace (Javascript) and Tim Knip (Python)
  • CHANGE: Changed predefined pattern scaling to BricsCAD and AutoCAD standard, set global option ezdxf.options.use_old_predefined_pattern_scaling to True, to use the old pattern scaling before v0.11
  • CHANGE: removed ezdxf.PATTERN constant, use PATTERN = ezdxf.pattern.load() instead, set argument old_pattern=True to use the old pattern scaling before v0.11
  • CHANGE: Table.key() accepts only strings, therefore tables check in accepts also only strings like entity.dxf.name
  • NEW: load DXF comments from file (ezdxf.comments.from_file) or stream (ezdxf.comments.from_stream)
  • BUGFIX: fixed incorrect HATCH pattern scaling
  • BUGFIX: fixed base point calculation of aligned dimensions
  • BUGFIX: fixed length extension line support for linear dimensions
  • BUGFIX: UCS.to_ocs_angle_deg() and UCS.to_ocs_angle_rad()
  • BUGFIX: check for unsupported DXF versions at new()
  • BUGFIX: fixed dxf2src error for the HATCH entity
  • BUGFIX: is_point_left_of_line() algorithm was incorrect
  • BUGFIX: default dimtxsty is Standard if options.default_dimension_text_style is not defined
  • BUGFIX: default arrows for minimal defined dimstyles are closed filled arrows
  • BUGFIX: use Standard as default for undefined dimension styles, e.g. EZDXF without setup

Version 0.10.4 - 2020-01-31

  • BUGFIX: height group code (40) for TEXT, ATTRIB and ATTDEF is mandatory

Version 0.10.3 - 2020-01-29

  • BUGFIX: min DXF version for VISUALSTYLE object is R2000

Version 0.10.2 - 2019-10-05

  • NEW: Dimension.get_measurement() returns the actual dimension measurement in WCS units, no scaling applied; angular and ordinate dimension are not supported yet.
  • BUGFIX: ordinate dimension exports wrong feature location
  • BUGFIX: Hatch.set_pattern_fill() did not set pattern scale, angle and double values

Version 0.10.1 - 2019-09-07

  • BUGFIX: group code for header var $ACADMAINTVER is 90 for DXF R2018+ and 70 for previous DXF versions. This is a critical bug because AutoCAD 2012/2013 (and possibly earlier versions) will not open DXF files with the new group code 90 for header variable $ACADMAINTVER.

Version 0.10 - 2019-09-01

  • Release notes: https://ezdxf.mozman.at/release-v0-10.html
  • unified entity system for all DXF versions
  • saving as later DXF version than the source DXF version is possible, but maybe data loss if saving as an older DXF version than source DXF version (ezdxf is not a DXF converter)
  • templates no more needed and removed from package
  • CHANGE: DXFEntity
    • renamed DXFEntity.drawing to DXFEntity.doc
    • DXFEntity.get_xdata() keyword xdata_tag renamed to tags
    • DXFEntity.set_xdata() keyword xdata_tag renamed to tags
    • renamed DXFEntity.remove_reactor_handle() renamed to DXFEntity.discard_reactor_handle()
    • DXFEntity.get_extension_dict() returns ExtensionDict object instead of the raw DICTIONARY object
    • renamed DXFEntity.supports_dxf_attrib() to DXFEntity.is_supported_dxf_attrib()
    • renamed DXFEntity.dxf_attrib_exists() to DXFEntity.has_dxf_attrib()
  • CHANGE: Layer entity
    • removed Layer.dxf.line_weight as synonym for Layer.dxf.lineweight
    • renamed Layer.dxf.plot_style_name to Layer.dxf.plotstyle_handle
    • renamed Layer.dxf.material to Layer.dxf.material_handle
  • CHANGE: same treatment of Viewport entity for all DXF versions
  • CHANGE: Polyline.vertices() is now an attribute Polyline.vertices, implemented as regular Python list.
  • CHANGE: Insert.attribs() is now an attribute Insert.attribs, implemented as regular Python list.
  • CHANGE: renamed Viewport.dxf.center_point to Viewport.dxf.center
  • CHANGE: renamed Viewport.dxf.target_point to Viewport.dxf.target
  • CHANGE: direct access to hatch paths (Hatch.paths), pattern (Hatch.pattern) and gradient (Hatch.gradient), context manager to edit this data is not needed anymore, but still available for backward compatibility
  • CHANGE: Options
    • removed template_dir, no more needed
    • new log_unprocessed_tags to log unprocessed (unknown) DXF tags
  • CHANGE: Dimension() removes associated anonymous dimension block at deletion
  • CHANGE: safe block deletion protects not explicit referenced blocks like anonymous dimension blocks and arrow blocks
  • CHANGE: Importer add-on rewritten, API incompatible to previous ezdxf versions, but previous implementation was already broken
  • CHANGE: moved add_attdef() to generic layout interface, adding ATTDEF to model- and paperspace is possible
  • CHANGE: entity query - exclude DXF types from '*' search, by appending type name with a preceding '!' e.g. query for all entities except LINE = "* !LINE"
  • CHANGE: entity query - removed regular expression support for type name match
  • CHANGE: integration of MTextData methods into MText
  • CHANGE: removed edit_data, get_text, set_text methods from MText
  • restructured package, module and test file organization
  • NEW: support for Layer.dxf.true_color and Layer.dxf.transparency attributes (DXF R2004+, undocumented)
  • NEW: Layer.rgb, Layer.color, Layer.description and Layer.transparency properties
  • NEW: renaming a Layer also renames references to this layer, but use with care
  • NEW: support for adding LEADER entities
  • NEW: Dimension.get_geometry_block(), returns the associated anonymous dimension block or None
  • NEW: EntityQuery() got first and last properties, to get first or last entity or None if query result is empty
  • NEW: added ngon(), star() and gear() to ezdxf.render.forms
  • NEW: Source code generator to create Python source code from DXF entities, to recreate this entities by ezdxf. This tool creates only simple structures as a useful starting point for parametric DXF entity creation from existing DXF files. Not all DXF entities are supported!
  • NEW: support for named plot style files (STB)
  • NEW: can open converted Gerber DXF files tagged as "Version 1.0, Gerber Technology."
  • BUGFIX: fixed MTEXT and GEODATA text splitting errors (do not split at '^')
  • BUGFIX: fixed some subclass errors, mostly DXF reference errors
  • BUGFIX: VERTEX entity inherit owner and linetype attribute from POLYLINE entity
  • BUGFIX: MTEXT - replacement of \n by \P at DXF export to avoid invalid DXF files.
  • tested with CPython 3.8
  • removed batch files (.bat) for testing, use tox command instead

Version 0.9 - 2019-02-24

  • Release notes: https://ezdxf.mozman.at/release-v0-9.html
  • IMPORTANT: Python 2 support REMOVED, if Python 2 support needed: add ezdxf<0.9 to your requirements.txt
  • NEW: testing on Manjaro Linux in a VM by tox
  • CHANGE: converted NEWS.rst to NEWS.md and README.rst to README.md
  • CHANGE: moved Importer() from ezdxf.tools to ezdxf.addons - internal structures of modern DXF files are too complex and too undocumented to support importing data in a reliable way - using Importer() may corrupt your DXF files or just don't work!
  • NEW: type annotations to core package and add-ons.
  • NEW: argument setup in ezdxf.new('R12', setup=True) to setup default line types, text styles and dimension styles, this feature is disabled by default.
  • NEW: Duplicate table entries: dwg.styles.duplicate_entry('OpenSans', new_name='OpenSansNew'), this works for all tables, but is intended to duplicate STYLES and DIMSTYLES.
  • CHANGED: replaced proprietary fonts in style declarations by open source fonts
  • NEW: open source fonts to download https://github.com/mozman/ezdxf/tree/master/fonts
  • OpenSansCondensed-Light font used for default dimension styles
  • NEW: subpackage ezdxf.render, because of DIMENSION rendering
  • NEW: support for AutoCAD standard arrows
  • NEW: support for creating linear DIMENSION entities
  • NEW: background color support for MTEXT
  • CHANGE: DXF template cleanup, removed non standard text styles, dimension styles, layers and blocks
  • CHANGE: text style STANDARD uses txt font
  • CHANGE: renamed subpackage ezdxf.algebra to ezdxf.math
  • CHANGE: moved addons.curves to render.curves
  • CHANGE: moved addons.mesh to render.mesh
  • CHANGE: moved addons.r12spline to render.r12spline
  • CHANGE: moved addons.forms to render.forms
  • CHANGE: renamed construction helper classes into Construction...()
    • Ray2D() renamed to ConstructionRay()
    • Circle() renamed to ConstructionCircle()
    • Arc() renamed to ConstructionArc()
  • NEW: construction tools ConstructionLine() and ConstructionBox()
  • REMOVED: almost_equal use math.isclose
  • REMOVED: almost_equal_points use ezdxf.math.is_close_points
  • BUGFIX: closed LWPOLYLINE did not work in AutoCAD (tag order matters), introduced with v0.8.9 packed data structure
  • BUGFIX: UCS.to_ocs_angle_deg() corrected

Version 0.8.9 - 2018-11-28

  • Release notes: https://ezdxf.mozman.at/release-v0-8-9.html

  • IMPORTANT: Python 2 support will be dropped in ezdxf v0.9.0, because Python 2 support get more and more annoying.

  • CHANGE: refactoring of internal tag representation for a smaller memory footprint, but with some speed penalty

  • NEW: packed data for LWPOLYLINE points, faster __getitem__; added __setitem__, __delitem__, insert() and append() methods; renamed discard_points() in clear(); removed get_rstrip_points() and ctx manager rstrip_points(); user defined point format;

  • NEW: packed data for SPLINE, knots, weights, fit- and control points are stored as array.array(); Spline.get_knot_values(), Spline.get_weights(), Spline.get_control_points() and Spline.get_fit_points() are deprecated, direct access to this attributes by Spline.knot_values, Spline.weights, Spline.control_points and Spline.fit_points, all attributes with a list-like interface. Knot, control point and fit point counter updated automatically, therefore counters are read only now.

  • NEW: packed data for MESH, vertices, faces, edges and edge crease values stored as array.array(), high level interface unchanged

  • NEW: Drawing.layouts_and_blocks(), iterate over all layouts (mode space and paper space) and all block definitions.

  • NEW: Drawing.chain_layouts_and_blocks(), chain entity spaces of all layouts and blocks. Yields an iterator for all entities in all layouts and blocks

  • NEW: Drawing.query(), entity query over all layouts and blocks

  • NEW: Drawing.groupby(), groups DXF entities of all layouts and blocks by an DXF attribute or a key function

  • NEW: Layout.set_redraw_order() and Layout.get_redraw_order(), to change redraw order of entities in model space and paper space layouts

  • NEW: BlockLayout.is_layout_block, True if block is a model space or paper space block definition

  • NEW: ezdxf.algebra.Arc helper class to create arcs from 2 points and an angle or radius, or from 3 points

  • NEW: ezdxf.algebra.Arc.add_to_layout() with UCS support to create 3D arcs

  • NEW: rename paper space layouts by Drawing.layouts.rename(old_name, new_name)

  • NEW: Basic support for embedded objects (new in AutoCAD 2018), ezdxf reads and writes the embedded data as it is, no interpretation no modification, just enough to not break DXF files with embedded objects at saving.

  • CHANGE: Drawing.blocks.delete_block(name, safe=True), new parameter save, check if block is still referenced (raises DXFValueError)

  • CHANGE: Drawing.blocks.delete_all_blocks(safe=True), if parameter safe is True, do not delete blocks that are still referenced

  • BUGFIX: invalid CLASS definition for DXF version R2000 (AC1015) fixed, bug was only triggered at upgrading from R13/R14 to R2000

  • BUGFIX: fixed broken Viewport.AcDbViewport property

  • BASIC read support for many missing DXF entities/objects

    • ACAD_PROXY_GRAPHIC
    • HELIX
    • LEADER
    • LIGHT
    • MLEADER (incomplete)
    • MLINE (incomplete)
    • OLEFRAME
    • OLE2FRAME
    • SECTION
    • TABLE (incomplete)
    • TOLERANCE
    • WIPEOUT
    • ACAD_PROXY_OBJECT
    • DATATABLE
    • DICTIONARYVAR
    • DIMASSOC
    • FIELD (incomplete)
    • FIELDLIST (not documented by Autodesk)
    • IDBUFFER
    • LAYER_FILTER
    • MATERIAL
    • MLEADERSTYLE
    • MLINESTYLE
    • SORTENTSTABLE
    • SUN
    • SUNSTUDY (incomplete) (no real world DXF files with SUNSTUDY for testing available)
    • TABLESTYLE (incomplete)
    • VBA_PROJECT (no real world DXF files with embedded VBA for testing available)
    • VISUALSTYLE
    • WIPEOUTVARIABLES
    • for all unsupported entities/objects exist only raw DXF tag support

Version 0.8.8 - 2018-04-02

  • Release notes: https://ezdxf.mozman.at/release-v0-8-8.html
  • NEW: read/write support for GEODATA entity
  • NEW: read/(limited)write support for SURFACE, EXTRUDEDSURFACE, REVOLVEDSURFACE, LOFTEDSURFACE and SWEPTSURFACE entity
  • NEW: support for extension dictionaries
  • NEW: add_spline_control_frame(), create and add B-spline control frame from fit points
  • NEW: add_spline_approx(), approximate B-spline by a reduced count of control points
  • NEW: ezdxf.setup_linetypes(dwg), setup standard line types
  • NEW: ezdxf.setup_styles(dwg), setup standard text styles
  • NEW: LWPolyline.vertices() yields all points as (x, y) tuples in OCS, LWPolyline.dxf.elevation is the z-axis value
  • NEW: LWPolyline.vertices_in_wcs() yields all points as (x, y, z) tuples in WCS
  • NEW: basic __str__() and __repr__() support for DXF entities, returns just DXF type and handle
  • NEW: bulge related function in module ezdxf.algebra.bulge
  • NEW: Object Coordinate System support by DXFEntity.ocs() and OCS() class in module ezdxf.algebra
  • NEW: User Coordinate System support by UCS() class in module ezdxf.algebra
  • CHANGE: DXFEntity.set_app_data() and Entity.set_xdata accept also list of tuples as tags, DXFTag() is not required
  • BUGFIX: entity structure validator excepts group code >= 1000 before XDATA section (used in AutoCAD Civil 3D and AutoCAD Map 3D)

Version 0.8.7 - 2018-03-04

  • Release notes: https://ezdxf.mozman.at/release-v0-8-7.html
  • NEW: entity.get_layout() returns layout in which entity resides or None if unassigned
  • NEW: copy any DXF entity by entity.copy() without associated layout, add copy to any layout you want, by layout.add_entity().
  • NEW: copy entity to another layout by entity.copy_to_layout(layout)
  • NEW: move entity from actual layout to another layout by entity.move_to_layout(layout)
  • NEW: support for splines by control points: add_open_spline(), add_closed_spline(), add_rational_spline(), add_closed_rational_spline()
  • NEW: bspline_control_frame() calculates B-spline control points from fit points, but not the same as AutoCAD
  • NEW: R12Spline add-on, 2d B-spline with control frame support by AutoCAD, but curve is just an approximated POLYLINE
  • NEW: added entity.get_flag_state() and entity.set_flag_state() for easy access to binary coded flags
  • NEW: set new $FINGERPRINTGUID for new drawings
  • NEW: set new $VERSIONGUID on saving a drawing
  • NEW: improved IMAGE support, by adding RASTERVARIABLES entity, use Drawing.set_raster_variables(frame, quality, units)
  • BUGFIX: closing user defined image boundary path automatically, else AutoCAD crashes

Version 0.8.6 - 2018-02-17

  • Release notes: https://ezdxf.mozman.at/release-v0-8-6.html
  • NEW: ezdxf project website: https://ezdxf.mozman.at/
  • CHANGE: create all missing tables of the TABLES sections for DXF R12
  • BUGFIX: entities on new layouts will be saved
  • NEW: Layout.page_setup() and correct 'main' viewport for DXF R2000+; For DXF R12 page_setup() exists, but does not provide useful results. Page setup for DXF R12 is still a mystery to me.
  • NEW: Table(), MText(), Ellipse(), Spline(), Bezier(), Clothoid(), LinearDimension(), RadialDimension(), ArcDimension() and AngularDimension() composite objects from dxfwrite as add-ons, these add-ons support DXF R12
  • NEW: geometry builder as add-ons: MeshBuilder(), MeshVertexMerger(), MengerSponge(), SierpinskyPyramid(), these add-ons require DXF R2000+ (MESH entity)
  • BUGFIX: fixed invalid implementation of context manager for r12writer

Version 0.8.5 - 2018-01-28

  • Release notes: https://ezdxf.mozman.at/release-v0-8-5.html
  • CHANGE: block names are case insensitive 'TEST' == 'Test' (like AutoCAD)
  • CHANGE: table entry (layer, linetype, style, dimstyle, ...) names are case insensitive 'TEST' == 'Test' (like AutoCAD)
  • CHANGE: raises DXFInvalidLayerName() for invalid characters in layer names: <>/":;?*|=`
  • CHANGE: audit process rewritten
  • CHANGE: skip all comments, group code 999
  • CHANGE: removed compression for unused sections (THUMBNAILSECTION, ACDSDATA)
  • NEW: write DXF R12 files without handles: set dwg.header['$HANDLING']=0, default value is 1
  • added subclass marker filter for R12 and prior files in legacy_mode=True (required for malformed DXF files)
  • removed special check for Leica Disto Unit files, use readfile(filename, legacy_mode=True) (malformed DXF R12 file, see previous point)

Version 0.8.4 - 2018-01-14

  • Release notes: https://ezdxf.mozman.at/release-v0-8-4.html

  • NEW: Support for complex line types with text or shapes

  • NEW: DXF file structure validator at SECTION level, tags outside of sections will be removed

  • NEW: Basic read support for DIMENSION

  • CHANGE: improved exception management, in the future ezdxf should only raise exceptions inherited from DXFError for DXF related errors, previous exception classes still work

    • DXFValueError(DXFError, ValueError)
    • DXFKeyError(DXFError, KeyError)
    • DXFAttributeError(DXFError, AttributeError)
    • DXFIndexError(DXFError, IndexError)
    • DXFTableEntryError(DXFValueError)
  • speedup low level tag reader around 5%, and speedup tag compiler around 5%

Version 0.8.3 - 2018-01-02

  • CHANGE: Lwpolyline - suppress yielding z coordinates if they exists (DXFStructureError: z coordinates are not defined in the DXF standard)
  • NEW: setup creates a script called 'dxfpp' (DXF Pretty Printer) in the Python script folder
  • NEW: basic support for DXF format AC1032 introduced by AutoCAD 2018
  • NEW: ezdxf use logging and writes all logs to a logger called 'ezdxf'. Logging setup is the domain of the application!
  • NEW: warns about multiple block definitions with the same name in a DXF file. (DXFStructureError)
  • NEW: legacy_mode parameter in ezdxf.read() and ezdxf.readfile(): tries do fix coordinate order in LINE entities (10, 11, 20, 21) by the cost of around 5% overall speed penalty at DXF file loading

Version 0.8.2 - 2017-05-01

  • NEW: Insert.delete_attrib(tag) - delete ATTRIB entities from the INSERT entity
  • NEW: Insert.delete_all_attribs() - delete all ATTRIB entities from the INSERT entity
  • BUGFIX: setting attribs_follow=1 at INSERT entity before adding an attribute entity works

Version 0.8.1 - 2017-04-06

  • NEW: added support for constant ATTRIB/ATTDEF to the INSERT (block reference) entity
  • NEW: added ATTDEF management methods to BlockLayout (has_attdef, get_attdef, get_attdef_text)
  • NEW: added (read/write) properties to ATTDEF/ATTRIB for setting flags (is_const, is_invisible, is_verify, is_preset)

Version 0.8.0 - 2017-03-28

  • added groupby(dxfattrib='', key=None) entity query function, it is supported by all layouts and the query result container: Returns a dict, where entities are grouped by a dxfattrib or the result of a key function.
  • added ezdxf.audit() for DXF error checking for drawings created by ezdxf - but not very capable yet
  • dxfattribs in factory functions like add_line(dxfattribs=...), now are copied internally and stay unchanged, so they can be reused multiple times without getting modified by ezdxf.
  • removed deprecated Drawing.create_layout() -> Drawing.new_layout()
  • removed deprecated Layouts.create() -> Layout.new()
  • removed deprecated Table.create() -> Table.new()
  • removed deprecated DXFGroupTable.add() -> DXFGroupTable.new()
  • BUGFIX in EntityQuery.extend()

Version 0.7.9 - 2017-01-31

  • BUGFIX: lost data if model space and active layout are called *MODEL_SPACE and *PAPER_SPACE

Version 0.7.8 - 2017-01-22

  • BUGFIX: HATCH accepts SplineEdges without defined fit points
  • BUGFIX: fixed universal line ending problem in ZipReader()
  • Moved repository to GitHub: https://github.com/mozman/ezdxf.git

Version 0.7.7 - 2016-10-22

  • NEW: repairs malformed Leica Disto DXF R12 files, ezdxf saves a valid DXF R12 file.
  • NEW: added Layout.unlink(entity) method: unlinks an entity from layout but does not delete entity from the drawing database.
  • NEW: added Drawing.add_xref_def(filename, name) for adding external reference definitions
  • CHANGE: renamed parameters for EdgePath.add_ellipse() - major_axis_vector -> major_axis; minor_axis_length -> ratio to be consistent to the ELLIPSE entity
  • UPDATE: Entity.tags.new_xdata() and Entity.tags.set_xdata() accept tuples as tags, no import of DXFTag required
  • UPDATE: EntityQuery to support both 'single' and "double" quoted strings - Harrison Katz harrison@neadwerx.com
  • improved DXF R13/R14 compatibility

Version 0.7.6 - 2016-04-16

  • NEW: r12writer.py - a fast and simple DXF R12 file/stream writer. Supports only LINE, CIRCLE, ARC, TEXT, POINT, SOLID, 3DFACE and POLYLINE. The module can be used without ezdxf.
  • NEW: Get/Set extended data on DXF entity level, add and retrieve your own data to DXF entities
  • NEW: Get/Set app data on DXF entity level (not important for high level users)
  • NEW: Get/Set/Append/Remove reactors on DXF entity level (not important for high level users)
  • CHANGE: using reactors in PdfDefinition for well defined UNDERLAY entities
  • CHANGE: using reactors and IMAGEDEF_REACTOR for well defined IMAGE entities
  • BUGFIX: default name=None in add_image_def()

Version 0.7.5 - 2016-04-03

  • NEW: Drawing.acad_release property - AutoCAD release number for the drawing DXF version like 'R12' or 'R2000'
  • NEW: support for PDFUNDERLAY, DWFUNDERLAY and DGNUNDERLAY entities
  • BUGFIX: fixed broken layout setup in repair routine
  • BUGFIX: support for utf-8 encoding on saving, DXF R2007 and later is saved with UTF-8 encoding
  • CHANGE: Drawing.add_image_def(filename, size_in_pixel, name=None), renamed key to name and set name=None for auto-generated internal image name
  • CHANGE: argument order of Layout.add_image(image_def, insert, size_in_units, rotation=0., dxfattribs=None)

Version 0.7.4 - 2016-03-13

  • NEW: support for DXF entity IMAGE (work in progress)
  • NEW: preserve leading file comments (tag code 999)
  • NEW: writes saving and upgrading comments when saving DXF files; avoid this behavior by setting options.store_comments = False
  • NEW: ezdxf.new() accepts the AutoCAD release name as DXF version string e.g. ezdxf.new('R12') or R2000, R2004, R2007, ...
  • NEW: integrated acadctb.py module from my dxfwrite package to read/write AutoCAD .ctb config files; no docs so far
  • CHANGE: renamed Drawing.groups.add() to new() for consistent name schema for adding new items to tables (public interface)
  • CHANGE: renamed Drawing.<tablename>.create() to new() for consistent name schema for adding new items to tables, this applies to all tables: layers, styles, dimstyles, appids, views, viewports, ucs, block_records. (public interface)
  • CHANGE: renamed Layouts.create() to new() for consistent name schema for adding new items to tables (internal interface)
  • CHANGE: renamed Drawing.create_layout() to new_layout() for consistent name schema for adding new items (public interface)
  • CHANGE: renamed factory method <layout>.add_3Dface() to add_3dface()
  • REMOVED: logging and debugging options
  • BUGFIX: fixed attribute definition for align_point in DXF entity ATTRIB (AC1015 and newer)
  • Cleanup DXF template files AC1015 - AC1027, file size goes down from >60kb to ~20kb

Version 0.7.3 - 2016-03-06

  • Quick bugfix release, because ezdxf 0.7.2 can damage DXF R12 files when saving!!!
  • NEW: improved DXF R13/R14 compatibility
  • BUGFIX: create CLASSES section only for DXF versions newer than R12 (AC1009)
  • TEST: converted a bunch of R8 (AC1003) files to R12 (AC1009), AutoCAD didn't complain
  • TEST: converted a bunch of R13 (AC1012) files to R2000 (AC1015), AutoCAD did not complain
  • TEST: converted a bunch of R14 (AC1014) files to R2000 (AC1015), AutoCAD did not complain

Version 0.7.2 - 2016-03-05

  • NEW: reads DXF R13/R14 and saves content as R2000 (AC1015) - experimental feature, because of the lack of test data
  • NEW: added support for common DXF attribute line weight
  • NEW: POLYLINE, POLYMESH - added properties is_closed, is_m_closed, is_n_closed
  • BUGFIX: MeshData.optimize() - corrected wrong vertex optimization
  • BUGFIX: can open DXF files without existing layout management table
  • BUGFIX: restore module structure ezdxf.const

Version 0.7.1 - 2016-02-21

  • Supported/Tested Python versions: CPython 2.7, 3.4, 3.5, pypy 4.0.1 and pypy3 2.4.0
  • NEW: read legacy DXF versions older than AC1009 (DXF R12) and saves it as DXF version AC1009.
  • NEW: added methods is_frozen(), freeze(), thaw() to class Layer()
  • NEW: full support for DXF entity ELLIPSE (added add_ellipse() method)
  • NEW: MESH data editor - implemented add_face(vertices), add_edge(vertices), optimize(precision=6) methods
  • BUGFIX: creating entities on layouts works
  • BUGFIX: entity ATTRIB - fixed halign attribute definition
  • CHANGE: POLYLINE (POLYFACE, POLYMESH) - on layer change also change layer of associated VERTEX entities

Version 0.7.0 - 2015-11-26

  • Supported Python versions: CPython 2.7, 3.4, pypy 2.6.1 and pypy3 2.4.0
  • NEW: support for DXF entity HATCH (solid fill, gradient fill and pattern fill), pattern fill with background color supported
  • NEW: support for DXF entity GROUP
  • NEW: VIEWPORT entity, but creating new viewports does not work as expected - just for reading purpose.
  • NEW: support for new common DXF attributes in AC1018 (AutoCAD 2004): true_color, color_name, transparency
  • NEW: support for new common DXF attributes in AC1021 (AutoCAD 2007): shadow_mode
  • NEW: extended custom vars interface
  • NEW: dxf2html - added support for custom properties in the header section
  • NEW: query() supports case insensitive attribute queries by appending an 'i' to the query string, e.g. '*[layer=="construction"]i'
  • NEW: Drawing.cleanup() - call before saving the drawing but only if necessary, the process could take a while.
  • BUGFIX: query parser couldn't handle attribute names containing '_'
  • CHANGE: renamed dxf2html to pp (pretty printer), usage: py -m ezdxf.pp yourfile.dxf (generates yourfile.html in the same folder)
  • CHANGE: cleanup file structure

Version 0.6.5 - 2015-02-27

  • BUGFIX: custom properties in header section written after $LASTSAVEDBY tag - the only way AutoCAD accepts custom tags

Version 0.6.4 - 2015-02-27

  • NEW: Support for custom properties in the header section - Drawing.header.custom_vars - but so far AutoCAD ignores new created custom properties by ezdxf- I don't know why.
  • BUGFIX: wrong DXF subclass for Arc.extrusion (error in DXF Standard)
  • BUGFIX: added missing support files for dxf2html

Version 0.6.3 - 2014-09-10

  • Beta status
  • BUGFIX: Text.get_pos() - dxf attribute error "alignpoint"

Version 0.6.2 - 2014-05-09

  • Beta status
  • NEW: set ezdxf.options.compress_default_chunks = True to compress unnecessary Sections (like THUMBNAILIMAGE) in memory with zlib
  • NEW: Drawing.compress_binary_data() - compresses binary data (mostly code 310) in memory with zlib or set ezdxf.options.compress_binary_data = True to compress binary data of every drawing you open.
  • NEW: support for MESH entity
  • NEW: support for BODY, 3DSOLID and REGION entity, you get the ACIS data
  • CHANGE: Spline() - removed context managers fit_points(), control_points(), knot_values() and weights() and added a general context_manager edit_data(), similar to Mesh.edit_data() - unified API
  • CHANGE: MText.buffer() -> MText.edit_data() - unified API (MText.buffer() still exists as alias)
  • CHANGE: refactored internal structure - only two DXF factories remaining:
    • LegacyDXFFactory() for AC1009 (DXF12) drawings
    • ModernDXFFactory() for newer DXF versions except DXF13/14.
  • BUGFIX: LWPolyline.get_rstrip_point() removed also x- and y-coords if zero
  • BUGFIX: opens DXF12 files without handles again
  • BUGFIX: opens DXF12 files with HEADER section but without $ACADVER set

Version 0.6.1 - 2014-05-02

  • Beta status
  • NEW: create new layouts - Drawing.create_layout(name, dxfattribs=None)
  • NEW: delete layouts - Drawing.delete_layout(name)
  • NEW: delete blocks - Drawing.blocks.delete_block(name)
  • NEW: read DXF files from zip archives (its slow).
  • CHANGE: LWPolyline returns always 5-tuples (x, y, start_width, end_width, bulge). start_width, end_width and bulge is 0 if not present.
  • NEW: LWPolyline.get_rstrip_points() -> generates points without appending zeros.
  • NEW: LWPolyline.rstrip_points() -> context manager for points without appending zeros.
  • BUGFIX: fixed handle creation bug for DXF12 files without handles, a code 5/105 issue
  • BUGFIX: accept floats as int (thanks to ProE)
  • BUGFIX: accept entities without owner tag (thanks to ProE)
  • improved dxf2html; creates a more readable HTML file; usage: python -m ezdxf.dxf2html filename.dxf

Version 0.6.0 - 2014-04-25

  • Beta status
  • Supported Python versions: CPython 2.7, 3.4 and pypy 2.2.1
  • Refactoring of internal structures
  • CHANGE: appended entities like VERTEX for POLYLINE and ATTRIB for INSERT are linked to the main entity and do not appear in layouts, model space or blocks (modelspace.query('VERTEX') is always an empty list).
  • CHANGE: refactoring of the internal 2D/3D point representation for reduced memory footprint
  • faster unittests
  • BUGFIX: opens minimalistic DXF12 files
  • BUGFIX: support for POLYLINE new (but undocumented) subclass names: AcDbPolyFaceMesh, AcDbPolygonMesh
  • BUGFIX: support for VERTEX new (but undocumented) subclass names: AcDbFaceRecord, AcDbPolyFaceMeshVertex, AcDbPolygonMeshVertex, AcDb3dPolylineVertex
  • CHANGE: Polyline.get_mode() returns new names: AcDb2dPolyline, AcDb3dPolyline, AcDbPolyFaceMesh, AcDbPolygonMesh
  • CHANGE: separated layout spaces - each layout has its own entity space

Version 0.5.2 - 2014-04-15

  • Beta status
  • Supported Python versions: CPython 2.7, 3.3, 3.4 and pypy 2.2.1
  • BUGFIX: ATTRIB definition error for AC1015 and later (error in DXF specs)
  • BUGFIX: entity.dxf_attrib_exists() returned True for unset attribs with defined DXF default values
  • BUGFIX: layout.delete_entity() didn't delete following data entities for INSERT (ATTRIB) & POLYLINE (VERTEX)
  • NEW: delete all entities from layout/block/entities section
  • cleanup DXF template files

Version 0.5.1 - 2014-04-14

  • Beta status
  • Supported Python versions: CPython 2.7, 3.3, 3.4 and pypy 2.2.1
  • BUGFIX: restore Python 2 compatibility (has no list.clear() method); test launcher did not run tests in sub-folders, because of missing init.py files

Version 0.5.0 - 2014-04-13

  • Beta status
  • BUGFIX: Drawing.get_layout_setter() - did not work with entities without DXF attribute paperspace
  • NEW: default values for DXF attributes as defined in the DXF standard, this allows usage of optional DXF attributes (with defined default values) without check of presence, like entity.dxf.paperspace.
  • NEW: DXF entities SHAPE, RAY, XLINE, SPLINE
  • NEW: delete entities from layout/block
  • CHANGE: entity 3DFACE requires 3D coordinates (created by add_3Dface())
  • CHANGE: LWPolyline all methods return points as (x, y, [start_width, [end_width, [bulge]]]) tuples
  • updated docs

Version 0.4.2 - 2014-04-02

  • Beta status
  • Supported Python versions: CPython 2.7, 3.3, 3.4 and pypy 2.1
  • NEW: DXF entities LWPOLYLINE, MTEXT
  • NEW: convenience methods place(), grid(), get_attrib_text() and has_attrib() for the Insert entity
  • CHANGE: pyparsing as external dependency
  • BUGFIX: iteration over drawing.entities yields full functional entities (correct layout attribute)
  • BUGFIX: install error with pip and missing DXF template files of versions 0.4.0 & 0.4.1

Version 0.3.0 - 2013-07-20

  • Alpha status
  • Supported Python versions: CPython 2.7, 3.3 and pypy 2.0
  • NEW: Entity Query Language
  • NEW: Import data from other DXF files
  • CHANGE: License changed to MIT License

Version 0.1.0 - 2010-03-14

  • Alpha status

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ezdxf, version 0.17.2
Filename, size File type Python version Upload date Hashes
Filename, size ezdxf-0.17.2.zip (1.8 MB) File type Source Python version None Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-win_amd64.whl (1.3 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-musllinux_1_1_x86_64.whl (2.6 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-musllinux_1_1_aarch64.whl (2.6 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-macosx_11_0_arm64.whl (1.3 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-macosx_10_9_x86_64.whl (1.3 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp310-cp310-macosx_10_9_universal2.whl (1.6 MB) File type Wheel Python version cp310 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-win_amd64.whl (1.3 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-musllinux_1_1_x86_64.whl (2.6 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-musllinux_1_1_aarch64.whl (2.6 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.5 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-macosx_11_0_arm64.whl (1.3 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-macosx_10_9_x86_64.whl (1.3 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp39-cp39-macosx_10_9_universal2.whl (1.6 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-win_amd64.whl (1.3 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-musllinux_1_1_x86_64.whl (2.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-musllinux_1_1_aarch64.whl (2.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-macosx_11_0_arm64.whl (1.3 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-macosx_10_9_x86_64.whl (1.3 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp38-cp38-macosx_10_9_universal2.whl (1.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-win_amd64.whl (1.3 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-musllinux_1_1_x86_64.whl (2.5 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-musllinux_1_1_aarch64.whl (2.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size ezdxf-0.17.2-cp37-cp37m-macosx_10_9_x86_64.whl (1.3 MB) File type Wheel Python version cp37 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page