DXF库(dxflib)使用指南

DXF库(dxflib)使用指南

作者：Andrew Mustun
版权：2004-2005 RibbonSoft公司. 保留所有权利。
日期：2005年3月
原文：http://www.ribbonsoft.com/dxflib/manual.pdf
源码：http://www.ribbonsoft.com/archives/dxflib/dxflib-2.0.4.8-2.src.tar.gz
翻译：柴树杉(http://sites.google.com/site/chaishushan/)

目录

• 第一章 简介
• 第二章 编译dxflib库
  • Unix/Linux
  • Windows
• 第三章 读DXF文件
  • 实现Creation接口
• 第四章 写DXF文件
  • 4.1 创建一个Writer对象
  • 4.2 写DXF Header
    • 4.2.1 打开DXF Header
    • 4.2.2 存储附加的变量
    • 4.2.3 关闭Header
  • 4.3 写Tables Section
    • 4.3.1 打开Tables Section
    • 4.3.2 写Viewports
    • 4.3.3 写Linetypes
    • 4.3.4 写Layers
    • 4.3.5 写其他的Tables
    • 4.3.6 写Dimension Styles
    • 4.3.7 写Block Records
    • 4.3.8 结束Tables Section
  • 4.4 写Blocks Section
  • 4.5 写Entities Section
  • 4.6 写Objects Section
  • 4.7 结束并且关闭文件
• 附录参考

第一章 简介

dxflib是一个用来读写DXF文件的C++库。当读DXF文件的时候，dxflib分析文件并且调用用户自己定义的函数来添加实体、层、等。

需要注意的是，dxflib并不保存任何实体或者信息。它只是从DXF文件中分析可以识别的实体以及其他的对象。

使用dxflib库读DXF文件并不需要知道所有的DXF格式信息。当然，像实体、属性、层、段等基本概念还是需要了解的。如果是用dxflib库写DXF文件，则需要知道DXF文件是如何组织的。

dxflib完全基于C/C++标准库实现，不依赖任何其他的库。

第二章 编译dxflib库

Unix/Linux

在Unix/Linux系统中编译dxflib库，需要输入以下命令：

./configure
make

该命令生成一个"./lib/dxflib.a"静态库。如果需要创建一个动态连接库，需要用"make shared"代替前面的"make"命令。这样就生成一个"./lib/libdxf.so.2.0.x.x"文件，然后再创建一个"./lib/libdxf.so"连接到"./lib/libdxf.so.2.0.x.x"。

如果不使用"make install"命令，你也可以直接将头文件和生成的库文件复制到你需要的目录中。

Windows

在windows系统中编译dxflib库可以有多中选择，你可以使用VC、Borland C++、GCC以及其他各种编译器。

在这里我们采用cygwin和gcc编译：

./configure
MinGW32-make

第三章 读DXF文件

工作原理：dxflib分析DXF文件，然后调用用户定义的回调函数。用户可以在回调函数中处理各种实体，或者将它们保存到容器中。

实现Creation接口

用户操作DXF的类，需要由DL_CreationInterface或者DL_CreationAdapter派生。在一般情况下DL_CreationAdapter是一个常用的选择，因为它并不强迫子类实现所有的虚函数。

class MyDxfFilter : public DL_CreationAdapter
{
    virtual void addLine(const DL_LineData& d);
    ...
}

在重新实现的虚函数addLine中，用户可以选择将实体保存到容器，也可以选择其他的方式处理。

void MyDxfFilter::addLine(const DL_LineData& d)
{
    std::cout << "Line: " << d.x1 << "/" << d.y1
    << " " << d.x2 << "/" << d.y2 << std::endl;
}

读DXF文件的时候，你只需要将自己派生的类传递给分析器就可以了。

MyDxfFilter f;
DL_Dxf dxf;
if (!dxf.in("drawing.dxf", &f))
{
    std::cerr << "drawing.dxf could not be opened.\n";
}

第四章 写DXF文件

为了写DXF文件，你可能需要反复嵌套调用dxflib的许多函数。dxflib本身并不存储任何entities，你需要到达entities的位置，并且对每个entities调用相应的写函数。你必须确保以正确的顺序调用dxflib的函数，否则生成的DXF文件可能不符合标准。

4.1 创建一个Writer对象

为了创建Writer，你需要指定DXF文件的版本号。目前只有两种可用的DXF版本：R12和DXF 2000/2002。R12对应的dxflib编码是DL_CodesAC1009，DXF 2000/2002对应的是DL_CodesAC1015。

用两种API接口可以用于写DXF文件。DL_WriterA接口提供一种相对底层的操作key/value元祖的方式。用DL_WriterA接口创建一个有效的DXF文件是很繁琐的。因此，还有一个相对高级的DL_Dxf接口可以再不了解key/value的前提下直接写入整条线。

下面的代码创建并以写方式打开一个DXF 2000/2002文件：

DL_Dxf dxf;
DL_Codes::version exportVersion = DL_Codes::AC1015;
DL_WriterA* dw = dxf.out("myfile.dxf", exportVersion);
if (dw==NULL)
{
    printf("Cannot open file 'myfile.dxf' \
        for writing.");
    // abort function e.g. with return
}

4.2 写DXF Header

4.2.1 打开DXF Header

DXF Header包含了DXF文件的版本信息。因此，必须用dxf.writeHeader(*dw)再最开始写入DXF Header。下面的列表显示了一个DXF Header的典型布局：

999
dxflib 2.0.4.8
  0
SECTION
  2
HEADER
  9
$ACADVER
  1
AC1015
  9
$HANDSEED
  5
FFFF

如你所见，writeHeader()函数并不关闭header。这是因为你可能需要再header中存储一些变量。如果你需要存储变量，可以再这个时候进行。如果不存储变量，可以直接关闭header。

4.2.2 存储附加的变量

DXF header中的变量用于保存DXF文件对应图形的元信息。如果像了解DXF所支持的全部变量，可以参考DXF的文档。

下面的代码片段显示了如果存储不同类型的变量。你可以存储很多变量，但是你必须确保以创建时变量的顺序来支持它。

// int variable:
dw->dxfString(9, "$INSUNITS");
dw->dxfInt(70, 4);
// real (double, float) variable:
dw->dxfString(9, "$DIMEXE");
dw->dxfReal(40, 1.25);
// string variable:
dw->dxfString(9, "$TEXTSTYLE");
dw->dxfString(7, "Standard");
// vector variable:
dw->dxfString(9, "$LIMMIN");
dw->dxfReal(10, 0.0);
dw->dxfReal(20, 0.0);

4.2.3 关闭Header

使用下面的函数可以关闭DXF header（结束当前的Section）：

dw->sectionEnd();

4.3 写Tables Section

4.3.1 打开Tables Section

DXF文件的tables section包含了tables的一些定义，如viewports、linestyles、layers等信息。可以用下面的函数打开tables section：

dw->sectionTables();

4.3.2 写Viewports

Viewports再dxflib还没有得到很好的支持。但是它对于一个有效的DXF文件却是必须的。不过我们可以使用下面的函数写入一个标准的viewports：

dxf.writeVPort(*dw);

4.3.3 写Linetypes

其实DXF文件中只有linetypes是必须定义的。你可以用dxflib简单低存储全部的linetypes，如下面的代码：

dw->tableLineTypes(25);
dxf.writeLineType(*dw, DL_LineTypeData("BYBLOCK", 0));
dxf.writeLineType(*dw, DL_LineTypeData("BYLAYER", 0));
dxf.writeLineType(*dw, DL_LineTypeData("CONTINUOUS", 0));
dxf.writeLineType(*dw, DL_LineTypeData("ACAD_ISO02W100", 0));
dxf.writeLineType(*dw, DL_LineTypeData("ACAD_ISO03W100", 0));
dxf.writeLineType(*dw, DL_LineTypeData("ACAD_ISO04W100", 0));
dxf.writeLineType(*dw, DL_LineTypeData("ACAD_ISO05W100", 0));
dxf.writeLineType(*dw, DL_LineTypeData("BORDER", 0));
dxf.writeLineType(*dw, DL_LineTypeData("BORDER2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("BORDERX2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("CENTER", 0));
dxf.writeLineType(*dw, DL_LineTypeData("CENTER2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("CENTERX2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHDOT", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHDOT2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHDOTX2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHED", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHED2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DASHEDX2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DIVIDE", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DIVIDE2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DIVIDEX2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DOT", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DOT2", 0));
dxf.writeLineType(*dw, DL_LineTypeData("DOTX2", 0));
dw->tableEnd();

4.3.4 写Layers

Layers对于很多DXF图形而言是一个比较重要的部分。绘图中所涉及到的所有layers需要在table section中定义。下面的实例代码在DXF文件中创建了3个layers，分别命名为："0"、"mainlayer"和"anotherlayer"。需要注意的是，在写layers的时候你需要指明总共会需要多少个layers。Layer "0"是一个默认的layer，不能省略。

int numberOfLayers = 3;

dw->tableLayers(numberOfLayers);

dxf.writeLayer(*dw,
    DL_LayerData("0", 0),
    DL_Attributes(
        std::string(""),    // leave empty
        DL_Codes::black,    // default color
        100,                // default width
        "CONTINUOUS"));     // default line style

dxf.writeLayer(*dw,
    DL_LayerData("mainlayer", 0),
    DL_Attributes(
        std::string(""),
        DL_Codes::red,
        100,
        "CONTINUOUS"));

dxf.writeLayer(*dw,
    DL_LayerData("anotherlayer", 0),
    DL_Attributes(
        std::string(""),
        DL_Codes::black,
        100,
        "CONTINUOUS"));

dw->tableEnd();

默认的line width单位为1/100mm。DL_Codes命名空间的color枚举（enum）类型定义了许多常见的颜色。

4.3.5 写其他的Tables

这些tables并不是必须的。如果像了解具体细节，可以参考DXF文档。

dxf.writeStyle(*dw);
dxf.writeView(*dw);
dxf.writeUcs(*dw);

dw->tableAppid(1);
dw->tableAppidEntry(0x12);
dw->dxfString(2, "ACAD");
dw->dxfInt(70, 0);
dw->tableEnd();

4.3.6 写Dimension Styles

Dimension Styles定义了外观尺度。

dxf.writeDimStyle(*dw,
    arrowSize,
    extensionLineExtension,
    extensionLineOffset,
    dimensionGap,
    dimensionTextSize);

4.3.7 写Block Records

Block records定义了DXF文件中用到的blocks。下面的代码定义了"myblock1"和"myblock2"两个blocks。第一行调用是必须的，它打开blocks table，并且可能写入一些和DXF版本相关的信息。

dxf.writeBlockRecord(*dw);
dxf.writeBlockRecord(*dw, "myblock1");
dxf.writeBlockRecord(*dw, "myblock2");
dw->tableEnd();

4.3.8 结束Tables Section

dw->sectionEnd();

4.4 写Blocks Section

Blocks section定义了每个block中的一些实体（entities）.

dw->sectionBlocks();

dxf.writeBlock(*dw,
    DL_BlockData("*Model_Space", 0, 0.0, 0.0, 0.0));
dxf.writeEndBlock(*dw, "*Model_Space");

dxf.writeBlock(*dw,
    DL_BlockData("*Paper_Space", 0, 0.0, 0.0, 0.0));
dxf.writeEndBlock(*dw, "*Paper_Space");

dxf.writeBlock(*dw,
    DL_BlockData("*Paper_Space0", 0, 0.0, 0.0, 0.0));
dxf.writeEndBlock(*dw, "*Paper_Space0");

dxf.writeBlock(*dw,
    DL_BlockData("myblock1", 0, 0.0, 0.0, 0.0));

// ...
// write block entities e.g. with dxf.writeLine(), ..
// ...
dxf.writeEndBlock(*dw, "myblock1");

dxf.writeBlock(*dw,
    DL_BlockData("myblock2", 0, 0.0, 0.0, 0.0));

// ...
// write block entities e.g. with dxf.writeLine(), ..
// ...
dxf.writeEndBlock(*dw, "myblock2");

dw->sectionEnd();

4.5 写Entities Section

Entities section定义了entities的一些信息。下面代码中的两个entities使用了它们layer的一些属性（256 = layer的颜色, -1 = layer的line width, "BYLAYER" = layer的line style）。

dw->sectionEntities();

// write all your entities..

dxf.writePoint(*dw,
    DL_PointData(10.0, 45.0, 0.0),
    DL_Attributes("mainlayer", 256, -1, "BYLAYER"));

dxf.writeLine(*dw,
    DL_LineData(25.0, 30.0, 0.0,   // start point
             100.0, 120.0, 0.0),   // end point
    DL_Attributes("mainlayer", 256, -1, "BYLAYER"));
dw->sectionEnd();

4.6 写Objects Section

dxf.writeObjects(*dw);
dxf.writeObjectsEnd(*dw);

4.7 结束并且关闭文件

dw->dxfEOF();
dw->close();
delete dw;

附录参考

[DXF]
http://www.autodesk.com/techpubs/autocad/acad2000/dxf
Autodesk DXF Reference

[CYGWIN]
http://www.cygwin.com
cygwin - a Linux-like environment for Windows.

---

Generated at Thu Aug 14 14:14:47 2008 by  1.5.4