28. Revit API:尺寸标注(Dimension)

一、前言

前面写了文字注释(TextNote)在视图中的包围盒的问题,然后想到尺寸标注上也是有文字的,那它的文字包围盒怎么获取呢?

哎嘿,这就瞅瞅。

二、尺寸标注

看图:

在"注释"菜单下的"尺寸标注"栏中,存在多种尺寸标注。

其实它们就分为三类:线性标注、弧度标注、高程标注。因为参照线(点)的不同,能够做出不同的动作。

  • Dimension:基类,用来表示线性标注,对齐、线性、半径直径 都是这个。
  • AngularDimension:子类,用来表示弧度标注,角度、弧长 是这个。
  • SpotDimension:子类,用来表示高程标注,三个高程都是这个。

2.1. Diemension

方法不写,就几个,看一眼得了。

至于属性,Revit中能手动编辑的,都能拿到。这就完事儿了~

留意几个Position的位置

至于高程标注的属性,只多了 Location 和 SpotDimensionType。

2.2. 创建标注

我们看文档,发现就AngularDimension类中有个Create()方法,其它两类的没有。

记得以前提到过,类中没有提供构造方法的,都可以去Creation中找找。而在17. Revit API: Creation这篇中的某张图上,就有写出标注的创建的方法,分别是

  • NewDimension():创建对齐标注
  • NewSpotElevation():创建高程标注

有眼睛亮的小伙伴就看见了,FamilyItemFactory类中不是有吗?是有,但那个是在「族文档」中才能用的,是用在建模上的。

至于通过代码来创建一个参变族,以后再说。

2.2.1. 对齐标注

接口的使用逻辑,和手动进行标注的逻辑是一样的。从参照线、参照点出发,再选择一个位置将标注放到那里。

csharp 复制代码
// Document.Create
public Dimension NewDimension(
	View view,  // 标注所在的视图
	Line line,  // 标注所在的直线
	ReferenceArray references // 标注参照
)

如果参照超过2个,那么就会有分段。

Revit工具栏长的"对齐"是通过这个方法实现的,是由参照线的方向决定的。至于"线性"标注,可以用这个代替。

备注:目前无法在非族文档中,创建半径、直径标注

可以尝试使用线性标注充当半径、直径标注,但不具备绕弧线移动的效果。

2.2.2. 弧度标注

和线性标注一样使用

csharp 复制代码
// AngularDimension
public static AngularDimension Create(
	Document document,
	View dbView,
	Arc arc,  // 标注所在的弧
	IList<Reference> references,  // 参照
	DimensionType dimensionStyle
)

备注:目前无法在非族文档中,创建弧长标注

2.2.3. 高程标注

三、尺寸标注文字的包围盒

11. Revit 文字(TextNote)包围盒中,写了如何计算视图中TextNote的包围盒。

各种Dimension上,也是有文字的,它的包围盒的计算,与TextNote类似,但也有些不同。

3.1. 文字位置为「内嵌」

  • LeaderEndPosition引线端点(终点),在文字「侧边中间」
  • TextPosition在文字「底部中间」
  • Origin在各段的线条的中间,也是引线的起点

如上图,这里以弧度标注为例,线性标注是一样的。

复制代码
1. 根据参照Curve,可以计算出Origin处的切线
2. 根据引线端点位置与原点法向,可以确定切向量方向
3. 根据引线端点位置和文字位置,可以计算出文字的长和宽
4. 由以上信息,可以获得尺寸标注文字的包围盒(如下图)
csharp 复制代码
public List<XYZ> ComputeAngularDimensionTextBounding(ViewSection viewSection, AngularDimension angularDimension)
 {
     List<(XYZ origin, XYZ textPosition, XYZ leaderEndPosition)> infos = [];  // 元组列表

     // 获取角度标注每段的信息
     if (angularDimension.NumberOfSegments == 0)
     {
         var info = (angularDimension.Origin, angularDimension.TextPosition, angularDimension.LeaderEndPosition);
         infos.Add(info);
     }
     else
     {
         foreach (DimensionSegment segment in angularDimension.Segments)
         {
             var info = (segment.Origin, segment.TextPosition, segment.LeaderEndPosition);
             infos.Add(info);
         }
     }

     Arc arc = angularDimension.Curve as Arc;

     var half_pi = Math.PI / 2.0;

     foreach (var info in infos)
     {
         XYZ originDirection = (info.origin - arc.Center).Normalize();
         XYZ leaderDirection = (info.leaderEndPosition - info.origin).Normalize();
         XYZ textDirection = (info.textPosition - info.origin).Normalize();
         XYZ computingDirection = leaderDirection.IsAlmostEqualTo(XYZ.Zero) ? textDirection : leaderDirection;

         double originParameter = arc.Project(info.origin).Parameter;  // warning, 3.1.1
         
         //XYZ tangent = arc.ComputeDerivatives(originParameter, false).BasisX; // error, curve is unbound.
         XYZ tangent = originDirection.RoatetAroundAxis(XYZ.Zero, viewSection.ViewDirection, half_pi).Normalize();  // 扩展方法

         var angle = tangent.AngleTo(computingDirection);

         if (angle > half_pi) { tangent = -tangent; }

         double width = (info.leaderEndPosition.DotProduct(tangent) - info.textPosition.DotProduct(tangent)).Abs();  // 一半的宽
         double height = (info.leaderEndPosition.DotProduct(originDirection) - info.textPosition.DotProduct(originDirection)).Abs(); // 一半的高

         var p0 = info.textPosition + tangent * width;
         var p1 = info.textPosition + tangent * width + originDirection * height * 2;
         var p2 = info.textPosition - tangent * width + originDirection * height * 2;
         var p3 = info.textPosition - tangent * width;

         List<XYZ> points = [p0, p1, p2, p3]; // info, 未处理顺、逆排序
         // ...
     }

    // ...
 }
3.1.1. BUG

当标注的原点处于如图的线上时,会在计算点在线上的投影时报错。

具体的原因,并没有弄清楚😕。

3.2. 文字位置在「上部」

这里以线性标注为例,弧度标注也是一样的

  • LeaderEndPosition在文字「底部侧边」
  • TextPosition在文字「底部中央」
  • Origin在各段的线条的中间

如上图,这里以线性标注为例,弧度标注也是类似的。

※ 取巧的方案:开启事务,将标注样式中的位置改为「内嵌」,使用内嵌的方案计算包围盒,再回滚事务。

可以看到,高度部分数据是缺失的,通过点坐标的差值,只能得到宽度数据。

那么我们是否可获取文字的高度信息?

可以,从「文字大小 」属性中获取,文字本身高度 = 文字大小 * 图纸比例,文字本身高度,即忽略文字边距。至于边距是多少,这个就取决于所用字体和是否为粗体有关了,

文字上下边距:(包围盒高度 - 文字本身高度)÷ 2 。

当字体为粗体时,大小就不准了,还不知道怎么算❌

可以整个配置文件,csv格式的txt就很好。预置一些常用的字体大小数据,用到时查一下,如果没有,再计算下填入。

3.3. 带有Below的标注

带有上、前、后缀的标注的文字不需要特殊处理,引线端点和文字位置会跟着变化,下缀就不一样了,需要额外处理。

标注的前后缀是在同一行,而上下部就"相当于"是换行。

若文字位置为内嵌,引线的端点始装在侧边中间,在计算含有上部是没有影响,而一旦带有下部,就有问题了。

就和"引线的端点始终在侧边中间"一样,TextPosition始终在【主体文字】底部中间。

这样一来,就不能简单的通过引线端点和文字位置坐标差来计算了。

如图,需要根据情况切换者计算,可能不那么准。

如果希望准一点,或是希望分别获取每一行文字的包围盒,就需要用到3.2中的文字边距了。

3.4. 高程标注

四、结尾

相关推荐
致***锌1 小时前
期权标准化合约是什么?
笔记
Wilber的技术分享2 小时前
【机器学习实战笔记 14】集成学习:XGBoost算法(一) 原理简介与快速应用
人工智能·笔记·算法·随机森林·机器学习·集成学习·xgboost
V我五十买鸡腿4 小时前
顺序栈和链式栈
c语言·数据结构·笔记·算法
麟城Lincoln5 小时前
【RHCSA-Linux考试题目笔记(自用)】servera的题目
linux·笔记·考试·rhcsa
丰锋ff5 小时前
计网学习笔记第2章 物理层(灰灰题库)
笔记·学习
阿絮~7 小时前
Apache RocketMQ进阶之路阅读笔记和疑问
笔记·apache·rocketmq
天水幼麟12 小时前
动手学深度学习-学习笔记(总)
笔记·深度学习·学习
天水幼麟14 小时前
动手学深度学习-学习笔记【二】(基础知识)
笔记·深度学习·学习
绿皮的猪猪侠14 小时前
算法笔记上机训练实战指南刷题
笔记·算法·pta·上机·浙大
沧海一笑-dj15 小时前
【51单片机】51单片机学习笔记-课程简介
笔记·学习·51单片机·江科大·江科大学习笔记·江科大单片机·江科大51单片机