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://chaishushan.googlepages.com )

第一章 简介
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_Codes::AC1009,DXF 2000/2002对应的是DL_Codes::AC1015。

用两种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.

» 本博客采用署名 2.5 中国大陆许可协议进行许可,本文版权归作者所有,欢迎转载,但必须在明显位置给出原文连接。
anyShare分享到:

Leave a Comment

NOTE - You can use these HTML tags and attributes:
<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>