18. Revit API: 元素位置与变换

杂鱼Tong

于 2024-07-23 19:00:00 发布

阅读量1k

点赞数 42

分类专栏： Revit # Revit API 文章标签：笔记

本文链接：https://blog.csdn.net/tzq2821448839/article/details/140635028

版权

Revit 同时被 2 个专栏收录

30 篇文章 1 订阅

订阅专栏

Revit API

20 篇文章 0 订阅

订阅专栏

前言

很好，这一篇没有用类名来做标题。~~大进步哇！~~
这一篇，讲Location、Transform、ElementTransfornUtils、Frame。
这几个都与位置、变换有关系。

前面提示：内容平平，没有看头，顶天了扫一眼得了。

一、Location

Location需要从元素上获取，但并不是所有元素都有Location，DirectShape就没有。
Location上只有两个本身的方法：

// 沿着向量移动
public bool Move(XYZ translation);
// 绕某个轴旋转一定弧度
public bool Rotate(Line axis,double angle);

Location有什么用呢？表示元素位置信息。
它有两个子类，①LocationPoint，②LocationCurve，具体的位置在子类上，所以我们拿到Location时，都需要进行判断。

在这里插入图片描述

2.1. LocationPoint

这个很好理解，位置嘛，一个点。FamilyInstance的位置大多是由点表示的。

它有2个属性：

// 模型位置，可直接设置
public XYZ Point { get; set; }
// 模型的旋转信息，只读
public double Rotation { get; }

2.2. LocationCurve

这个就稍微特别点了，元素的位置是由Curve表示的。这种族一般存在多个控制点。比如墙、梁。
它有3个属性：

public Curve Curve { get; set; }
public ElementArray this[int end] { get; set; }  // ElementsAtJoin
public JoinType this[int end] { get; set; }  // JoinType

后俩个参数啥意思呢？

var curve = wall.Location as LocationCurve;  // 获取墙体的LocationCurve

var j0 = curve.get_ElementsAtJoin(0);  // Curve起点上连接的墙体数目。
var j1 = curve.get_ElementsAtJoin(1);  // Curve起点上连接的墙体数目。

var jt0 = curve.get_JoinType(0);  // 连接类型
var jt1 = curve.get_JoinType(1);

呐，连接数是这样的

在这里插入图片描述

还可以设置连接类型，使墙体不再连接，但是会弹出警告“无法使图元保持连接”。

二、Transform

Transform表示的就是元素的变换信息。系统族是没有Transform的，Transform只存在于FamilyInstance上。

关于FamilyInstance与Transform的关系，看这里。

Transform就是对4x4矩阵的封装，作用和一些三维引擎里的是一样一样的，不展开了嗷

Methods	Description
CreateReflection CreateRotation CreateRotationAtPoint CreateTranslation	创建反射矩阵（镜像）创建旋转矩阵创建绕点的旋转矩阵创建平移矩阵
AlmostEqual	几乎相等，阈值1e-9
Multiply	矩阵相乘
OfPoint OfVector	点的变换向量的变换
ScaleBasis ScaleBasisAndOrigin	缩放

再看看属性

Propertices	Description
Identity	常量，单位矩阵
Basis BasisX/BasisY/BasisZ Origin Scale { get; }	? 三个向量表示位置的点缩放
Determinant	行列式的值
Inverse	逆矩阵
…	…