Files
stepanalyser/.venv/lib/python3.12/site-packages/ezdxf-1.3.4.dist-info/METADATA
Christian Anetzberger a197de9456 initial
2026-01-22 20:23:51 +01:00

286 lines
9.6 KiB
Plaintext

Metadata-Version: 2.1
Name: ezdxf
Version: 1.3.4
Summary: A Python package to create/manipulate DXF drawings.
Author-email: Manfred Moitzi <me@mozman.at>
Project-URL: Repository, https://github.com/mozman/ezdxf
Project-URL: Documentation, https://ezdxf.readthedocs.io
Project-URL: Changelog, https://ezdxf.mozman.at/notes/#/page/changelog
Project-URL: Forum, https://github.com/mozman/ezdxf/discussions
Project-URL: Issues, https://github.com/mozman/ezdxf/issues
Project-URL: Website, https://ezdxf.mozman.at
Project-URL: Download, https://pypi.org/project/ezdxf
Keywords: DXF,CAD
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Provides: ezdxf
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyparsing>=2.0.1
Requires-Dist: typing-extensions>=4.6.0
Requires-Dist: numpy
Requires-Dist: fonttools
Provides-Extra: dev
Requires-Dist: PySide6; extra == "dev"
Requires-Dist: setuptools; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: Cython; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: Pillow; extra == "dev"
Requires-Dist: matplotlib; extra == "dev"
Requires-Dist: PyMuPDF>=1.20.0; extra == "dev"
Provides-Extra: dev5
Requires-Dist: PyQt5; extra == "dev5"
Requires-Dist: setuptools; extra == "dev5"
Requires-Dist: wheel; extra == "dev5"
Requires-Dist: Cython; extra == "dev5"
Requires-Dist: pytest; extra == "dev5"
Requires-Dist: Pillow; extra == "dev5"
Requires-Dist: matplotlib; extra == "dev5"
Requires-Dist: PyMuPDF>=1.20.0; extra == "dev5"
Provides-Extra: draw
Requires-Dist: PySide6; extra == "draw"
Requires-Dist: matplotlib; extra == "draw"
Requires-Dist: PyMuPDF>=1.20.0; extra == "draw"
Requires-Dist: Pillow; extra == "draw"
Provides-Extra: draw5
Requires-Dist: PyQt5; extra == "draw5"
Requires-Dist: matplotlib; extra == "draw5"
Requires-Dist: PyMuPDF>=1.20.0; extra == "draw5"
Requires-Dist: Pillow; extra == "draw5"
# ezdxf
## Abstract
This Python package is designed to facilitate the creation and manipulation of DXF
documents, with compatibility across various DXF versions. It empowers users to
seamlessly load and edit DXF files while preserving all content, except for comments.
Any unfamiliar DXF tags encountered in the document are gracefully ignored but retained
for future modifications. This feature enables the processing of DXF documents
containing data from third-party applications without any loss of valuable information.
## Quick-Info
- `ezdxf` is a Python package to create new DXF files and read/modify/write
existing DXF documents
- MIT-License
- the intended audience are programmers
- requires at least Python 3.9
- OS independent
- tested with CPython and pypy3
- has type annotations and passes `mypy --ignore-missing-imports -p ezdxf` successful
- additional required packages for the core package without add-ons
- [typing_extensions](https://pypi.org/project/typing-extensions/)
- [pyparsing](https://pypi.org/project/pyparsing/)
- [numpy](https://pypi.org/project/numpy/)
- [fontTools](https://pypi.org/project/fonttools/)
- read/write/new support for DXF versions: R12, R2000, R2004, R2007, R2010, R2013 and R2018
- additional read-only support for DXF versions R13/R14 (upgraded to R2000)
- additional read-only support for older DXF versions than R12 (upgraded to R12)
- read/write support for ASCII DXF and Binary DXF
- retains third-party DXF content
- optional C-extensions for CPython are included in the binary wheels, available
on [PyPI](https://pypi.org/project/ezdxf/) for Windows, Linux and macOS
- command line script `ezdxf` to display, convert and inspect DXF files
## Included Extensions
Additional packages required for these add-ons are not automatically installed
during the *basic* setup, for more information about the setup & dependencies
visit the [documentation](https://ezdxf.mozman.at/docs/setup.html).
- The `drawing` add-on is a translation layer to send DXF data to a render backend,
interfaces to [matplotlib](https://pypi.org/project/matplotlib/), which can export
images as PNG, PDF or SVG, and [PyQt5](https://pypi.org/project/PyQt5/) are implemented.
- `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 from the modelspace of huge DXF
files (> 5GB) 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 basic Constructive Solid Geometry (CSG) modeling
- `MTextExplode` add-on for exploding MTEXT entities into single-line TEXT entities
- `text2path` add-on to convert text into outline paths
- `geo` add-on to support the [`__geo_interface__`](https://gist.github.com/sgillies/2217756)
- `meshex` for exchanging meshes with other tools as STL, OFF or OBJ files
- `openscad` add-on, an interface to [OpenSCAD](https://openscad.org)
- `odafc` add-on, an interface to the [ODA File Converter](https://www.opendesign.com/guestfiles/oda_file_converter)
to read and write DWG files
- `hpgl2` add-on for converting HPGL/2 plot files to DXF, SVG and PDF
A simple example:
```Python
import ezdxf
from ezdxf import colors
from ezdxf.enums import TextEntityAlignment
# Create a new DXF document.
doc = ezdxf.new(dxfversion="R2010")
# Create new table entries (layers, linetypes, text styles, ...).
doc.layers.add("TEXTLAYER", color=colors.RED)
# 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": colors.YELLOW})
msp.add_text(
"Test",
dxfattribs={
"layer": "TEXTLAYER"
}).set_placement((0, 0.2), align=TextEntityAlignment.CENTER)
# Save the DXF document.
doc.saveas("test.dxf")
```
Example for the *r12writer*, which writes a simple DXF R12 file without
in-memory structures:
```Python
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, PySide6) for using the
drawing add-on:
pip install ezdxf[draw]
For more information about the setup & dependencies visit the
[documentation](https://ezdxf.mozman.at/docs/setup.html).
## Command Line
Use `python -m ezdxf ...` if your shell can't find the `ezdxf` script.
Get additional help for a sub-command:
ezdxf <cmd> -h
Preview DXF files in a graphical window:
ezdxf view <file.dxf>
Export the modelspace of DXF files as PNG|SVG|PDF:
ezdxf draw -o file.<png|svg|pdf> <file.dxf>
Print basic information about DXF files:
ezdxf info <file.dxf>
Show detailed information and structures of DXF files:
ezdxf browse <file.dxf>
Audit DXF files:
ezdxf audit <file.dxf>
Preview and convert HPGL/2 plot files:
ezdxf hpgl <file.plt>
## Website
https://ezdxf.mozman.at/
## Documentation
Documentation of the development version at https://ezdxf.mozman.at/docs
Documentation of the latest release at https://ezdxf.readthedocs.io/
## Knowledge Graph
The knowledge graph contains additional information beyond the documentation and is
managed by [logseq](https://logseq.com/). The source data is included in the repository
in the folder `ezdxf/notes`. There is also a [HTML export](https://ezdxf.mozman.at/notes/#/page/ezdxf)
on the website which gets regular updates.
## 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](https://stackoverflow.com/) and use the tag `dxf` or `ezdxf`.
Issue tracker at __GitHub__:
http://github.com/mozman/ezdxf/issues
## Release Notes
The [release notes](https://ezdxf.mozman.at/notes/#/page/release%20notes) are included
in the knowledge graph.
## Changelog
The [changelog](https://ezdxf.mozman.at/notes/#/page/changelog) is included
in the knowledge graph.
## Contact
Please __always__ post questions at the [forum](https://github.com/mozman/ezdxf/discussions)
or [stack overflow](https://stackoverflow.com/) to make answers
available to other users as well.
ezdxf@mozman.at
Feedback is greatly appreciated.
Manfred