OpenCascade笔记：BRepBuilderAPI_Transform

函数原型

Standard_EXPORT BRepBuilderAPI_Transform(
const TopoDS_Shape& S, 
const gp_Trsf& T, 
const Standard_Boolean Copy = Standard_False)

函数参数

S: 输入的TopoDS_Shape, 需要变换的图形
T: 变换矩阵
Copy: 是否克隆一份S，然后在克隆的TopoDS_Shape中修改。Copy为Standard_False时，也有可能会克隆（如变换改变了图形的形状，变形或缩放了之类的情况时，均会克隆，因为此时会修改到底层图形myTShape，函数传入的是const TopoDS_Shape&，设计上来说，不会修改这个变量的值）。

额外说明

若Copy为Standard_False，并且变换是等大小（无缩放，变换矩阵向量部分行列式为1，可以理解为标准正交基，坐标系两两垂直），此时返回的结果TopoDS_Shape，底层图形myTShape与S一样，但myLocation为传入的T；否则，返回S的克隆版本（并且应用了变换）。

常见误区

• 误区1

//tmpTrsf 为向X轴平衡100的平移矩阵
BRepBuilderAPI_Transform aBRepTrsf(
	aTmpShape, 
	tmpTrsf, 
	Standard_False );
//...

Copy参数传入了Standard_False， 想当然的认为会直接在aTmpShape上修改，认为aTmpShape就是变换后的结果。

正确的做法是： aBRepTrsf.Shape()取出结果。由上述参数Copy的说明可知，Copy参数无论传入哪个值，S均不会被修改。