29 中望CAD二次开发（ZRX C++）-Overrule

目录

29.1 简单的例子

29.2 ZcGiDrawableOverrule

回顾《22 中望CAD二次开发（ZRX C++）-自定义实体》这一节，我们通过派生ZcDbCurve，实现了自定义实体。自定义实体允许开发者自定义实体行为，例如绘制、几何变换、捕捉等。如果我们不想重写实体类型，只是想改变原生实体类型的行为，可以用到Overrule。所以本讲介绍Overrule的用法。

29.1 简单的例子

前面自定义实体实现了在多段线的每个节点上绘制一个圆，如下图所示：

这里用Overrule实现上面的效果。想要实现自定义绘制行为，需要派生一个类，叫做ZcGiDrawableOverrule，它的父类是ZcRxOverrule，实际上，各种Overrule的父类都是ZcRxOverrule。下面一步步实现：

第一步：创建一个ZcGiDrawableOverrule的派生类：

class MyLineOverrule :public ZcGiDrawableOverrule { };

第二步：重写父类虚函数

这里需要重写两个虚函数，一个是worldDraw，就是在这个函数里头重写绘制行为；另一个需要重写的是isApplicable，这个函数来自ZcRxOverrule，是一个抽象函数，也就是说，它是必须要实现的，后面介绍它的用法。

class MyLineOverrule :public ZcGiDrawableOverrule { public: virtual ZSoft::Boolean worldDraw( ZcGiDrawable* pSubject, ZcGiWorldDraw* wd) override { ZcDbLine* line = ZcDbLine::cast(pSubject); if (line) { ZcGePoint3d startp = line->startPoint(); ZcGePoint3d endp = line->endPoint(); wd->geometry().circle(startp, 10, ZcGeVector3d::kZAxis); wd->geometry().circle(endp, 10, ZcGeVector3d::kZAxis); } return ZcGiDrawableOverrule::worldDraw(pSubject, wd); } virtual bool isApplicable(const ZcRxObject* pOverruledSubject) const { return ZSoft::kTrue; } };

上面重写的方法worldDraw实现了自定义绘制行为。pSubject就是该规则作用的实体，这里把它转成目标对象ZcDbLine，然后利用ZcGiWorldDraw::geomtry().circle()函数在直线端点上绘制圆，实现我们想要的效果。

问题：ZcGiDrawable可以是其他类型的实体吗？答案：不是。因为该规则作用在什么实体类型上，是我们显式指定的，也必须要指定。所以才有下一步的操作。

第三步：添加移除自定义行为

可以在插件加载的时候安装，在插件卸载的时候移除：

static MyLineOverrule mylineOverrule; void initapp() { ZcRxOverrule::addOverrule(ZcDbLine::desc(), &mylineOverrule, false); } void unloadapp() { ZcRxOverrule::removeOverrule(ZcDbLine::desc(), &mylineOverrule); }

观察addOverrule这个方法，它需要通过第一个参数指定实体类型，这里指定ZcDbLine，也就是说所有的ZcDbLine都将使用这个自定义的绘制规则。

第四步：编译运行

加载插件后，绘制直线，会自动在线的端点上出现圆。

问题：加载插件后，对于重新绘制的LINE起作用，对原有的图形是否起作用？答案：起作用，但是需要重绘，也就是调用REGEN命令。也可以在初始化插件的时候，由程序实现重绘：

void initapp() { ZcRxOverrule::addOverrule(ZcDbLine::desc(), &mylineOverrule, false); //重生成 zcedRegen(); }

29.2 ZcGiDrawableOverrule

29.1通过ZcGiDrawableOverrule介绍了Overrule的基本用法，对于ZcGiDrawableOverrule还有其他几个用法。

（1）设置过滤

29.1实现的规则对所有的LINE都起作用，可以通过重写isApplicable来设置过滤条件。下面演示，只对固定图层的LINE起作用：

virtual bool isApplicable(const ZcRxObject* pOverruledSubject) const override { ZcDbEntity* ent = ZcDbEntity::cast(pOverruledSubject); if (ent) { ZTCHAR* layerNanme = ent->layer(); if (_tcsicmp(layerNanme, _T("0")) == 0) { return ZSoft::kTrue; } } return ZSoft::kFalse; }

也就是说返回false规则不起作用，返回true起作用。

（2）设置属性

通过重写setAttributes可以对规则起作用的实体设置属性，例如设置颜色：

virtual ZSoft::UInt32 setAttributes( ZcGiDrawable* pSubject, ZcGiDrawableTraits* traits) override { auto flags = ZcGiDrawableOverrule::setAttributes(pSubject, traits); ZcDbLine* line = ZcDbLine::cast(pSubject); if (line) { traits->setColor(5); } return flags; }

注：这里设置的属性只会影响到图形的外观，并没有真的改变它的颜色。

问题：如果设置图层会怎么样？

virtual ZSoft::UInt32 setAttributes (ZcGiDrawable* pSubject, ZcGiDrawableTraits* traits) override { auto flags = ZcGiDrawableOverrule::setAttributes(pSubject, traits); ZcDbLine* line = ZcDbLine::cast(pSubject); if (line) { ZcDbLayerTable* layerTable; zcdbHostApplicationServices()->workingDatabase()->getLayerTable(layerTable); ZcDbObjectId layerObjId; layerTable->getAt(_T("ss"), layerObjId); //设置图层 traits->setLayer(layerObjId); } return flags; }

看下图，虽然设置了名为ss的图层，但是看它的属性仍然是0层。这种规则的设置，只会影响外观，不会改变图形本身的属性。所谓影响外观，例如，该图形的颜色是随层的，设置了它的图层是ss层，而ss层的颜色是红色的，所以看图形的颜色也是红色的。同时，改变ss图层的显隐也会影响到下面的图形，虽然它本质上不在ss层。

（3）视口绘制

通过重写viewportDraw方法，实现不同视口的重绘：

virtual void viewportDraw(ZcGiDrawable* pSubject, ZcGiViewportDraw* vd) override { ZcDbLine* line = ZcDbLine::cast(pSubject); if (line) { struct resbuf rb; zcedGetVar(_T("CVPORT"), &rb); if (rb.resval.rint == 2) { vd->subEntityTraits().setColor(1); ZcGePoint3d startp = line->startPoint(); ZcGePoint3d endp = line->endPoint(); ZcGePoint3d pts[2] = { startp,endp }; vd->geometry().polyline(2, pts); } else { vd->subEntityTraits().setColor(5); ZcGePoint3d startp = line->startPoint(); ZcGePoint3d endp = line->endPoint(); ZcGePoint3d pts[2] = { startp,endp }; vd->geometry().polyline(2, pts); } } }

上面代码实现，在编号为2的视口绘制的线的颜色索引为1，其他视口绘制的线的颜色索引为5：

注：如果要重写viewportDraw，需要让worldDraw返回false。

除了ZcGiDrawableOverrule，还有很多其他类型的Overrule，如下图，实现步骤都一样，这里就不赘述了。