Crate dxf [−] [src]

This crate provides the ability to read and write DXF and DXB CAD files.

Usage

Put this in your Cargo.toml:

[dependencies]
dxf = "0.3.0"

Or if you want serde support, enable the serialize feature:

[dependencies]
dxf = { version = "0.3.0", features = ["serialize"] }

Note that serde support is intended to aid in debugging and since the serialized format is heavily dependent on the layout of the structures, it may change at any time.

And finally add:

extern crate dxf;

Examples

Open a DXF file from disk:

use dxf::Drawing;
use dxf::entities::*;

let drawing = Drawing::load_file("path/to/file.dxf")?;
for e in drawing.entities {
    println!("found entity on layer {}", e.common.layer);
    match e.specific {
        EntityType::Circle(ref circle) => {
            // do something with the circle
        },
        EntityType::Line(ref line) => {
            // do something with the line
        },
        _ => (),
    }
}

Saving a DXF file to disk:

use dxf::Drawing;
use dxf::entities::*;

let mut drawing = Drawing::default();
drawing.entities.push(Entity::new(EntityType::Line(Line::default())));
drawing.save_file("path/to/file.dxf")?;

Reference

Since I don't want to fall afoul of Autodesk's lawyers, this repo can't include the actual DXF documentation. It can, however contain links to the official documents that I've been able to scrape together. For most scenarios the 2014 documentation should suffice, but all other versions are included here for backwards compatibility and reference between versions.

R10 (non-Autodesk source)

R11 (differences between R10 and R11)

R12 (non-Autodesk source)

R13 (self-extracting 16-bit executable)

2007 (Autodesk's link erroneously points to the R2008 documentation)

These links were compiled from the archive.org May 9, 2013 snapshot of http://usa.autodesk.com/adsk/servlet/item?siteID=123112&id=12272454&linkID=10809853 (https://web.archive.org/web/20130509144333/http://usa.autodesk.com/adsk/servlet/item?siteID=123112&id=12272454&linkID=10809853)

Modules

entities
enums
objects
tables

Structs

Block	A block is a collection of entities.
Class	Represents an application-defined class whose instances are `Block`s, `Entity`s, and `Object`s.
CodePair	The basic primitive of a DXF file; a code indicating the type of the data contained, and the data itself.
Color	Represents an indexed color.
Drawing	Represents a DXF drawing.
ExtensionGroup	Represents an application name and a collection of extension group data in the form of `CodePair`s.
GeoMeshPoint
Header	Contains common properties for the DXF file.
LineWeight	Represents a line weight.
LwPolylineVertex	Represents a single vertex of a `LwPolyline`.
MLineStyleElement
Point	Represents a simple point in Cartesian space.
SectionGeometrySettings
SectionTypeSettings
TableCellStyle	Defines a style for a table's cell.
TransformationMatrix	Applies a transformation to a point.
Vector	Represents a simple vector in Cartesian space.
XData	Represents an application name and a collection of extended data.

Enums

CodePairValue	Contains the data portion of a `CodePair`.
DataTableValue
DrawingItem
DrawingItemMut
DxfError
ExpectedType	Represents the expected data type of a `CodePair`.
ExtensionGroupItem	Represents a single piece of extension data or a named group.
XDataItem	Represents a piece of extended data.

Type Definitions

DxfResult