Skip to content
This repository has been archived by the owner on Oct 23, 2023. It is now read-only.

stephensmitchell-forks/Dxf

 
 

Repository files navigation

IxMilia.Dxf

A portable .NET library for reading and writing DXF and DXB files. Clone and build locally or directly consume the NuGet package.

Usage

Open a DXF file:

using System.IO;
using IxMilia.Dxf;
using IxMilia.Dxf.Entities;
// ...

DxfFile dxfFile;
using (FileStream fs = new FileStream(@"C:\Path\To\File.dxf", FileMode.Open))
{
    dxfFile = DxfFile.Load(fs);
}

foreach (DxfEntity entity in dxfFile.Entities)
{
    switch (entity.EntityType)
    {
        case DxfEntityType.Line:
            DxfLine line = (DxfLine)entity;
            // ...
            break;
        // ...
    }
}

Save a DXF file:

using System.IO;
using IxMilia.Dxf;
using IxMilia.Dxf.Entities;
// ...

DxfFile dxfFile = new DxfFile();
dxfFile.Entities.Add(new DxfLine(new DxfPoint(0, 0, 0), new DxfPoint(50, 50, 0)));
// ...

using (FileStream fs = new FileStream(@"C:\Path\To\File.dxf", FileMode.Create))
{
    dxfFile.Save(fs);
}

Compatibility

Reading Files

This library should be able to open any valid DXF file, including files produced by AutoCAD or anything using the Teigha libraries from the Open Design Alliance, including Microsoft Visio which uses older Open Design libraries.

Open Design Alliance (Teigha)

The Teigha libraries should be able to open anything produced by this library.

AutoCAD

AutoCAD is rather fussy with what it will accept as valid DXF, even though the official spec is rather loose. If you use this library to write a file that AutoCAD can't open, file an issue with the drawing (or a sample) that was produced by this library. I've found that AutoCAD compatibility can be greatly improved by doing the following:

// assuming `dxfFile` is a valid `DxfFile` object
dxfFile.Header.SetDefaults();
dxfFile.ViewPorts.Clear();
dxfFile.Save(...);

There are also some entity types that AutoCAD might not open when written by this library, specifically:

  • 3DSOLID (Dxf3DSolid)
  • ACAD_PROXY_ENTITY (DxfProxyEntity)
  • ATTRIB (DxfAttribute)
  • ATTDEF (DxfAttributeDefinition)
  • BODY (DxfBody)
  • DIMENSION (DxfAlignedDimension, DxfAngularThreePointDimension, DxfDiameterDimension, DxfOrdinateDimension, DxfRadialDimension, DxfRotatedDimension)
  • HELIX (DxfHelix)
  • LIGHT (DxfLight)
  • MTEXT (DxfMText)
  • REGION (DxfRegion)
  • SHAPE (DxfShape)
  • TOLERANCE (DxfTolerance)

And the following entities might not open in AutoCAD if written with missing information, e.g., a LEADER (DxfLeader) requires at least 2 vertices.

  • INSERT (DxfInsert)
  • LEADER (DxfLeader)
  • MLINE (DxfMLine)
  • DGNUNDERLAY (DxfDgnUnderlay)
  • DWFUNDERLAY (DxfDwfUnderlay)
  • PDFUNDERLAY (DxfPdfUnderlay)
  • SPLINE (DxfSpline)
  • VERTEX (DxfVertex)

Also note that AutoCAD doesn't seem to like R13 files written by IxMilia. For the greatest chance of compatibility, save the file as either R12 or the newest version possible (e.g., R2013 or R2010.)

Status

Support for DXF files is complete from versions R10 through R2014 EXCEPT for the following entities:

  • HATCH
  • MESH
  • MLEADER
  • SURFACE
  • TABLE
  • VIEWPORT

Building locally

Requirements to build locally are:

sudo apt-get install dotnet-sharedframework-microsoft.netcore.app-1.0.3

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)

R14

2000

2002

2004

2005

2006

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

2008

2009

2010

2011

2012

2013

2014

2018

2019

Many of 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

The R2018 spec can be downloaded for offline use via the command (and R2019 similarly):

wget -r -k -L -e robots=off http://help.autodesk.com/cloudhelp/2018/ENU/AutoCAD-DXF/files/GUID-235B22E0-A567-4CF6-92D3-38A2306D73F3.htm

and a simple launch page can be added via:

echo "<html><meta http-equiv='refresh' content='0; url=files/GUID-235B22E0-A567-4CF6-92D3-38A2306D73F3.htm' /></html>" > help.autodesk.com/cloudhelp/2018/ENU/AutoCAD-DXF/index.html

Alternately, the downloaded files and images can be combined into a standalone HTML file via:

src/IxMilia.Dxf.ReferenceCollector/build.cmd "help.autodesk.com/cloudhelp/2018/ENU/AutoCAD-DXF/files"

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.9%
  • Other 0.1%