（12）ObjectARX2015 + vs2012创建尺寸标注

   提示：看之前的博客（1）和（4），那里已经分析了创建一个图形对象的基本过程，在之前的基础上本节开始就要将着眼点放在创建实体的参数上。

（1）ObjectARX2015 + vs2012创建直线_qq_42981953的博客-CSDN博客

（4）ObjectARX2015 + vs2012扩展绘制直线的功能为绘制实体_qq_42981953的博客-CSDN博客

1. 说明

        本篇将介绍 12 个用于尺寸标注的函数，包括了转角标注、对齐标注、角度标注、半径标注、直径标注和坐标标注的创建函数。这些函数分别封装了系统提供的一些基本方法，并在实用性上进行了扩充。

2. 思路

A.       AcDbAlignedDimension 类对应的是对齐标注，该类的构造函数接受 5 个参数：

                （1）第一条尺寸边界线的起点、 （2）第二条尺寸边界线的起点、

                （3）通过尺寸线的一点、（4）标注文字、   （5）样式。

        本节创建一个函数，对该类的构造函数直接进行封装，另外创建一个函数，可以在创建标注时修改标注文字的位置。

B.        AcDbRotatedDimension 类对应转角标注，该类的构造函数接受 6 个参数：

        （1）标注的旋转角度、  （2）第一条尺寸边界线的起点、  （3）第二条尺寸边界线的起点、

        （4）通过尺寸线的一点、 （5）标注文字        （6）样式。

        本节创建的函数直接对该函数进行封装。

C.        AcDbRadialDimension 类对应半径标注，该类的构造函数需要输入5 个参数：

        （1）标注曲线的中心点、    （2）引线附着的坐标、    （3）引线长度、

        （4）标注文字        （5）样式        

        本节除了对构造函数进行封装之外，提供了根据 （1）圆心、（2）半径、（3）标注尺寸线旋转角度（4）引线长度   来创建半径标注的函数，其关键点就在于根据已知的参数计算出构造函数需要的参数。

D.        AcDbDiametricDimension 类对应直径标注，其构造函数需要输入5 个参数：

        （1）+（2）标注直径的两个端点、（3）引线长度、

        （4）标注文字（5）样式

        本节除对其构造函数直接封装之外，还提供了根据（1）圆弧的圆心、 （2）半径、

（3）引线放置角度（4）引线长度    创建标注的方法。

E.        AcDb2LineAngularDimension 类对应角度标注，对这个类的构造函数进行封装。

F.        AcDb3PointAngularDimension类对应角度标注，对这个类的构造函数进行封装。

G.        AcDbOrdinateDimension 类对应坐标标注，其构造函数需要输入5 个参数：

        （1）是否是 X 轴标注（布尔类型变量）、 （2）标注箭头的起始位置、

        （3）标注箭头的终止位置、 （4）标注文字   （5）样式 

        本篇对该函数封装之后，又创建了两个新函数，能够同时创建 X、Y 两个坐标值，并且根据相对坐标修改引线端点的位置。

3. 步骤

A.       AcDbAlignedDimension 类对应的是对齐标注，该类的构造函数接受 5 个参数：

                （1）第一条尺寸边界线的起点、 （2）第二条尺寸边界线的起点、

                （3）通过尺寸线的一点、（4）标注文字、   （5）样式。

        本节创建一个函数，对该类的构造函数直接进行封装，另外创建一个函数，可以在创建标注时修改标注文字的位置。

（1）创建对齐标注：添加一个新函数 CreateDimAligned

//创建对齐标注
static AcDbObjectId CreateDimAligned(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, const char* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建对齐标注
//（1）第一条尺寸边界线的起点（2）第二条尺寸边界线的起点（3）通过尺寸线的一点（4）标注文字（5）样式。
AcDbObjectId CCreateEnt::CreateDimAligned(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, const char* dimText, AcDbObjectId dimStyle) 
{ 
    AcDbAlignedDimension *pDim = new AcDbAlignedDimension(pt1, pt2, 
    ptLine, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

（2）创建对齐标注：创建一个重载的函数，允许用户输入 vecOffset 作为标注文字位置的偏移量

//创建对齐标注, 创建一个重载的函数，允许用户输入 vecOffset 作为标注文字位置的偏移量
    static AcDbObjectId CreateDimAligned(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, const AcGeVector3d& vecOffset = AcGeVector3d::kIdentity, const TCHAR* dimText = NULL);

//创建对齐标注
//重载函数，允许输入 vecOffset 作为标注文字位置的偏移量
AcDbObjectId CCreateEnt::CreateDimAligned(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, const AcGeVector3d& vecOffset, const TCHAR* dimText) 
{ 
    AcDbAlignedDimension *pDim = new AcDbAlignedDimension(pt1, pt2, ptLine, dimText, AcDbObjectId::kNull);
    AcDbObjectId dimensionId;
    dimensionId = CCreateEnt::PostToModelSpace(pDim);
    // 打开已经创建的标注，对文字的位置进行修改
    AcDbEntity *pEnt;
    Acad::ErrorStatus es;
    es = acdbOpenAcDbEntity(pEnt, dimensionId, AcDb::kForWrite);
    AcDbAlignedDimension *pDimension = AcDbAlignedDimension::cast(pEnt);

    if (pDimension != NULL) 
    { 
        // 移动文字位置前，需先指定尺寸线的变化情况（这里指定为：
        // 尺寸线不动，在文字和尺寸线之间加箭头）
        pDimension->setDimtmove(1); 
        // 根据偏移向量修正文字插入点的位置
        AcGePoint3d ptText = pDimension->textPosition(); 
        ptText = ptText + vecOffset; 
        pDimension->setTextPosition(ptText); 
    } 

    pEnt->close(); 
    return dimensionId; 
}

B.        AcDbRotatedDimension 类对应转角标注，该类的构造函数接受 6 个参数：

        （1）标注的旋转角度、  （2）第一条尺寸边界线的起点、  （3）第二条尺寸边界线的起点、

        （4）通过尺寸线的一点、 （5）标注文字        （6）样式。

        本节创建的函数直接对该函数进行封装。

（3）创建转角标注：添加一个新函数 CreateDimRotated

    //创建转角标注
    static AcDbObjectId CreateDimRotated(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, double rotation, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建转角标注
//（1）标注的旋转角度、（2）第一条尺寸边界线的起点、（3）第二条尺寸边界线的起点、（4）通过尺寸线的一点、（5）标注文字 （6）样式。
AcDbObjectId CCreateEnt::CreateDimRotated(const AcGePoint3d& pt1, const AcGePoint3d& pt2, const AcGePoint3d& ptLine, double rotation, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDbRotatedDimension *pDim = new AcDbRotatedDimension(rotation, pt1, pt2, ptLine, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

C.        AcDbRadialDimension 类对应半径标注，该类的构造函数需要输入5 个参数：

        （1）标注曲线的中心点、    （2）引线附着的坐标、    （3）引线长度、

        （4）标注文字        （5）样式        

        本节除了对构造函数进行封装之外，提供了根据 （1）圆心、（2）半径、（3）标注尺寸线旋转角度（4）引线长度   来创建半径标注的函数，其关键点就在于根据已知的参数计算出构造函数需要的参数。

（4）创建半径标注：添加一个新函数 CreateDimRadial

//创建半径标注
    static AcDbObjectId CreateDimRadial(const AcGePoint3d& ptCenter, const AcGePoint3d& ptChord, double leaderLength, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建半径标注
//（1）标注曲线的中心点、（2）引线附着的坐标、（3）引线长度、（4）标注文字（5）样式  
AcDbObjectId CCreateEnt::CreateDimRadial(const AcGePoint3d& ptCenter, const AcGePoint3d& ptChord, double leaderLength, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDbRadialDimension *pDim = new AcDbRadialDimension(ptCenter, ptChord, leaderLength, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}  

（5）创建半径标注：创建一个重载的函数，用于根据圆心、半径、标注尺寸线的旋转角度和引线长度来创建半径标注

//创建半径标注
static AcDbObjectId CreateDimRadial(const AcGePoint3d& ptCenter, double radius, double angle, double leaderLength = 5);

//创建半径标注
//重载函数，(圆心、半径、标注尺寸线的旋转角度和引线长度)
AcDbObjectId CCreateEnt::CreateDimRadial(const AcGePoint3d& ptCenter, double radius, double angle, double leaderLength) 
{ 
    CGeometryOper m_geometryOper;
    AcGePoint3d ptChord = m_geometryOper.PolarPoint(ptCenter, angle, radius); 

    return CCreateEnt::CreateDimRadial(ptCenter, ptChord, leaderLength); 
}

        其中，CCalculation::PolarPoint 是一个自定义函数，能够根据相对极坐标来确定一个点的位置：

//根据相对极坐标来确定一个点的位置
AcGePoint3d PolarPoint(const AcGePoint3d& pt, double angle, double distance);

//根据相对极坐标来确定一个点的位置
AcGePoint3d CGeometryOper::PolarPoint(const AcGePoint3d& pt, double angle, double distance) 
{ 
    ads_point ptForm, ptTo; 
    ptForm[X] = pt.x; 
    ptForm[Y] = pt.y; 
    ptForm[Z] = pt.z;
    //acutPolar: 计算某个角度上距离某个点一定距离的点
    acutPolar(ptForm, angle, distance, ptTo); 
    return asPnt3d(ptTo); 
}

D.        AcDbDiametricDimension 类对应直径标注，其构造函数需要输入5 个参数：

        （1）+（2）标注直径的两个端点、（3）引线长度、

        （4）标注文字（5）样式

        本节除对其构造函数直接封装之外，还提供了根据（1）圆弧的圆心、 （2）半径、

                                                        （3）引线放置角度（4）引线长度    创建标注的方法。

（6）创建直径标注：创建一个函数 CreateDimDiametric

    //创建直径标注
    static AcDbObjectId CreateDimDiametric(const AcGePoint3d& ptChord1, const AcGePoint3d& ptChord2, double leaderLength, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建直径标注
//（1）+（2）标注直径的两个端点、（3）引线长度、（4）标注文字（5）样式
AcDbObjectId CCreateEnt::CreateDimDiametric(const AcGePoint3d& ptChord1, const AcGePoint3d& ptChord2, double leaderLength, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDbDiametricDimension *pDim = new AcDbDiametricDimension(ptChord1, ptChord2, leaderLength, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

（7）创建直径标注：创建一个重载的函数，根据圆心、半径、标注尺寸线的旋转角度和引线长度

//创建直径标注
static AcDbObjectId CreateDimDiametric(const AcGePoint3d& ptCenter, double radius, double angle, double leaderLength = 5);

//创建直径标注
//重载函数，(圆心、半径、标注尺寸线的旋转角度和引线长度)
AcDbObjectId CCreateEnt::CreateDimDiametric(const AcGePoint3d& ptCenter, double radius, double angle, double leaderLength) 
{ 
    CGeometryOper m_geometryOper;
    // 计算标注通过点的位置
    AcGePoint3d ptChord1, ptChord2; 
    ptChord1 = m_geometryOper.PolarPoint(ptCenter, angle, radius); 
    ptChord2 = m_geometryOper.PolarPoint(ptCenter, angle + m_geometryOper.PI(), radius); 

    return CCreateEnt::CreateDimDiametric(ptChord1, ptChord2, leaderLength); 
}

E.        AcDb2LineAngularDimension 类对应角度标注，对这个类的构造函数进行封装。

（8）创建角度标注：根据两条直线的关系创建一个函数

    //创建角度标注
    static AcDbObjectId CreateDim2LineAngular(const AcGePoint3d& ptStart1, const AcGePoint3d& ptEnd1, const AcGePoint3d& ptStart2, const AcGePoint3d& ptEnd2, const AcGePoint3d& ptArc, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建二维角度标注
//根据两条直线的关系创建一个函数
AcDbObjectId CCreateEnt::CreateDim2LineAngular(const AcGePoint3d& ptStart1, const AcGePoint3d& ptEnd1, const AcGePoint3d& ptStart2, const AcGePoint3d& ptEnd2, const AcGePoint3d& ptArc, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDb2LineAngularDimension *pDim = new AcDb2LineAngularDimension(ptStart1, ptEnd1, ptStart2, ptEnd2, ptArc, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

F.        AcDb3PointAngularDimension类对应角度标注，对这个类的构造函数进行封装。

（9）创建角度标注：创建一个重载的函数，根据顶点、起始点、终止点和标注尺寸线通过点来创建

    //创建三维角度标注
    static AcDbObjectId CreateDim3PtAngular(const AcGePoint3d& ptCenter, const AcGePoint3d& ptEnd1, const AcGePoint3d& ptEnd2, const AcGePoint3d& ptArc, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建三维角度标注
//重载函数，(顶点、起始点、终止点和标注尺寸线通过点)
AcDbObjectId CCreateEnt::CreateDim3PtAngular(const AcGePoint3d& ptCenter, const AcGePoint3d& ptEnd1, const AcGePoint3d& ptEnd2, const AcGePoint3d& ptArc, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDb3PointAngularDimension *pDim = new AcDb3PointAngularDimension(ptCenter, ptEnd1, ptEnd2, ptArc, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

G.        AcDbOrdinateDimension 类对应坐标标注，其构造函数需要输入5 个参数：

        （1）是否是 X 轴标注（布尔类型变量）、 （2）标注箭头的起始位置、

        （3）标注箭头的终止位置、 （4）标注文字   （5）样式 

        本篇对该函数封装之后，又创建了两个新函数，能够同时创建 X、Y 两个坐标值，并且根据相对坐标修改引线端点的位置。

（10）创建坐标标注：创建一个函数 CreateDimOrdinate，直接封装类的构造函数

    //创建坐标标注
    static AcDbObjectId CreateDimOrdinate(Adesk::Boolean xAxis, const AcGePoint3d& ptStart, const AcGePoint3d& ptEnd, const TCHAR* dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull);

//创建坐标标注
//（1）是否是 X 轴标注（布尔类型变量）、（2）标注箭头的起始位置、（3）标注箭头的终止位置、（4）标注文字、（5）样式 
AcDbObjectId CCreateEnt::CreateDimOrdinate(Adesk::Boolean xAxis, const AcGePoint3d& ptStart, const AcGePoint3d& ptEnd, const TCHAR* dimText, AcDbObjectId dimStyle) 
{ 
    AcDbOrdinateDimension *pDim = new AcDbOrdinateDimension(xAxis, ptStart, ptEnd, dimText, dimStyle); 
    return CCreateEnt::PostToModelSpace(pDim); 
}

（11）创建坐标标注：创建一个重载的函数，能够同时创建一个点的 X、Y 坐标标注

//创建坐标标注
static AcDbObjectIdArray CreateDimOrdinate(const AcGePoint3d& ptDef, const AcGePoint3d& ptTextX, const AcGePoint3d& ptTextY);

//创建坐标标注
//重载函数，能够同时创建一个点的 X、Y 坐标标注
AcDbObjectIdArray CCreateEnt::CreateDimOrdinate(const AcGePoint3d& ptDef, const AcGePoint3d& ptTextX, const AcGePoint3d& ptTextY) 
{ 
    AcDbObjectId dimId; 
    AcDbObjectIdArray dimIds; 
    dimId = CCreateEnt::CreateDimOrdinate(Adesk::kTrue, ptDef, ptTextX); 
    dimIds.append(dimId); 
    dimId = CCreateEnt::CreateDimOrdinate(Adesk::kFalse, ptDef, ptTextY); 
    dimIds.append(dimId); 
    return dimIds; 
}

（12）创建坐标标注：能够根据点的偏移位置来创建坐标标注

//创建坐标标注
static AcDbObjectIdArray CreateDimOrdinate(const AcGePoint3d& ptDef, const AcGeVector3d& vecOffsetX, const AcGeVector3d& vecOffsetY);

//创建坐标标注
//重载函数，能够根据点的偏移位置来创建坐标标注
AcDbObjectIdArray CCreateEnt::CreateDimOrdinate(const AcGePoint3d& ptDef, const AcGeVector3d& vecOffsetX, const AcGeVector3d& vecOffsetY) 
{ 
    AcGePoint3d ptTextX = ptDef + vecOffsetX; 
    AcGePoint3d ptTextY = ptDef + vecOffsetY; 

    return CCreateEnt::CreateDimOrdinate(ptDef, ptTextX, ptTextY); 
}

4. 实体操作

（1）在 CCalculation 类中增加一个函数 RelativePoint，用于根据相对直角坐标来计算一个点的位置：

    //根据相对直角坐标来计算一个点的位置
    AcGePoint3d RelativePoint(const AcGePoint3d& pt, double x, double y); 

//根据相对直角坐标来计算一个点的位置
AcGePoint3d CGeometryOper::RelativePoint(const AcGePoint3d& pt, double x, double y)
{
    AcGePoint3d ptReturn(pt.x + x, pt.y + y, pt.z); 
    return ptReturn;
}

5. 在acrxEntryPoint.cpp中

ACED_ARXCOMMAND_ENTRY_AUTO(CArxConfigApp, MidasMyGroup, MyCreateDimAligned, MyCreateDimAligned, ACRX_CMD_MODAL, NULL) 创建对齐标注

//当前项目中注册一个命令 MyCreateDimAligned
    static void MidasMyGroupMyCreateDimAligned()
    {
        CGeometryOper m_geometryOper;
        // 指定起始点位置
        AcGePoint3d pt1(200, 160, 0); 
        AcGePoint3d pt2= m_geometryOper.RelativePoint(pt1, -40, 0); 
        AcGePoint3d pt3 = m_geometryOper.PolarPoint(pt2, 7 * m_geometryOper.PI() / 6, 20); 
        AcGePoint3d pt4 = m_geometryOper.RelativePoint(pt3, 6, -10); 
        AcGePoint3d pt5 = m_geometryOper.RelativePoint(pt1, 0, -20); 
        // 绘制外轮廓线
        CCreateEnt::CreateLine(pt1, pt2); 
        CCreateEnt::CreateLine(pt2, pt3);
        CCreateEnt::CreateLine(pt3, pt4); 
        CCreateEnt::CreateLine(pt4, pt5); 
        CCreateEnt::CreateLine(pt5, pt1); 
        // 绘制圆形
        AcGePoint3d ptCenter1, ptCenter2; 
        ptCenter1 = m_geometryOper.RelativePoint(pt3, 16, 0); 
        ptCenter2 = m_geometryOper.RelativePoint(ptCenter1, 25, 0); 
        CCreateEnt::CreateCircle(ptCenter1, 3); 
        CCreateEnt::CreateCircle(ptCenter2, 4); 

        AcGePoint3d ptTemp1, ptTemp2; 
        // 水平标注
        ptTemp1 = m_geometryOper.RelativePoint(pt1, -20, 3); 
        CCreateEnt::CreateDimRotated(pt1, pt2, ptTemp1, 0); 
        // 垂直标注
        ptTemp1 = m_geometryOper.RelativePoint(pt1, 4, 10); 
        CCreateEnt::CreateDimRotated(pt1, pt5, ptTemp1, 
            m_geometryOper.PI() / 2); 
        // 转角标注
        ptTemp1 = m_geometryOper.RelativePoint(pt3, -3, -6); 
        CCreateEnt::CreateDimRotated(pt3, pt4, ptTemp1, 7 * m_geometryOper.PI() / 4); 
        // 对齐标注
        ptTemp1 = m_geometryOper.RelativePoint(pt2, -3, 4); 
        CCreateEnt::CreateDimAligned(pt2, pt3, ptTemp1, AcGeVector3d(4, 10, 0), _T("new position")); 
        // 角度标注
        ptTemp1 = m_geometryOper.RelativePoint(pt5, -5, 5); 
        CCreateEnt::CreateDim3PtAngular(pt5, pt1, pt4, ptTemp1); 
        // 半径标注
        ptTemp1 = m_geometryOper.PolarPoint(ptCenter1, m_geometryOper.PI() / 4, 3); 
        CCreateEnt::CreateDimRadial(ptCenter1, ptTemp1, -3);
        // 直径标注
        ptTemp1 = m_geometryOper.PolarPoint(ptCenter2, 
            m_geometryOper.PI() / 4, 4); 
        ptTemp2 = m_geometryOper.PolarPoint(ptCenter2, 
            m_geometryOper.PI() / 4, -4); 
        CCreateEnt::CreateDimDiametric(ptTemp1, ptTemp2, 0); 
        // 坐标标注
        CCreateEnt::CreateDimOrdinate(ptCenter2, AcGeVector3d(0, -10, 0), 
            AcGeVector3d(10, 0, 0)); 
    }

效果展示: