工作表函数用于接受一个自变量,执行一项操作,并返回一个值或多个值。有两种基本类型的函数:使用所输入的值的函数,以及使用绘图对象信息的函数。这两类函数所需的自变量是不同的。
● 数字或文本自变量: 以小写字母开头的函数通常需要使用一个数字值或单元格地址作为自变量。例如,acos 函数会返回函数自变量中所指定的值的反余弦。所输入的自变量可以是数学表达式(例如 3/5)、一个包含数字的单元格的地址(例如 A12)或一个实际数字。所有三角函数的自变量必须以弧度为单位。
● 条件自变量: 以大写字母开头的函数必须应用到绘图中的一个或多个具体对象。在数据库标题行的单元格中,函数将自动应用到每个子行中所列出的对象,因此不需要条件自变量。
但是,在电子表格单元格中,必须输入条件以选择要将函数应用至其上的对象。比如说,“面积”函数会返回符合条件所有二维对象的组合面积。如要指定获取哪些对象的面积,可以使用工作表菜单中的插入 > 条件命令,或手动输入条件。对于如何指定对象类型、类或可见性等条件的相关详情,请访问下述链接参阅面向开发人员的文档(需要访问网络):
developer.vectorworks.net/index.php/VS:Search_Criteria#Search_Criteria_Tables
developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#attrCrit
在下列工作表函数列表中,函数使用的自变量显示在圆括号中。
一个数字的反余弦。反余弦是其余弦为某个数字的角度。返回的角度以 0 至 pi 的弧度值表示。数字是角度的余弦,必须介于 -1 至 1 之间。相关函数:cos
例如:=acos(3/5) 返回其余弦值为 3/5 的角度
符合指定条件对象的角度(从地平线开始测量,以度为单位)。使用此函数可返回线条和墙的角度(从地平线开始测量)、圆弧的跨角和楼板的坡角。
例如:
● 数据库标题单元格:=Angle 返回数据库中每个对象的角度
● 电子表格单元格:=Angle((t=arc)&(n='arc-1')) 返回绘图中名为 “arc-1” 圆弧对象的扫掠角
符合指定条件的二维对象的总面积,基于“单位”对话框中的“面积”单位。相关函数:Perim
例如:
● 数据库标题单元格:=Area 返回数据库中每个对象的面积
● 电子表格单元格:=Area(t=rect) 返回绘图中所有矩形对象的组合面积
一个数字的反正弦。反正弦是其正弦为某个数字的角度。返回的角度以 -pi/2 至 pi/2 的弧度值表示。如要以度数为单位表示反正弦,使用 rad2deg 函数(或将结果乘以 180/pi)。数字是角度的正弦,必须介于 -1 至 1 之间。相关函数:sin
例如:=asin(A3) 返回其正弦值为单元格 A3 中给定值的的角度
符合指定条件的对象的二维下边界(最小 y 坐标)。相关函数:LeftBound、RightBound、TopBound
例如:
● 数据库标题单元格:=BotBound 返回数据库中每个对象的二维下边界
● 电子表格单元格:=BotBound(t=locus) 返回在绘图中具有最低二维下边界值的坐标点的二维下边界
符合指定条件且在指定类中的组件的一侧的面积(减去所有孔)。相关函数:CompAreaByName, ComponentArea
例如:
● 数据库标题单元格:=CompAreaByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的面积
● 电子表格单元格:=CompAreaByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合面积
符合指定条件且具有指定名称的组件的一侧的面积(减去所有孔)。相关函数:CompAreaByClass, ComponentArea
例如:
● 数据库标题单元格:=CompAreaByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的面积
● 电子表格单元格:=CompAreaByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合面积
符合指定条件且具有指定名称的组件名称。相关函数:CompNameByClass
例如:
● 数据库标题单元格:=CompClassByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的类
● 电子表格单元格:=CompClassByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的第一个组件的类
符合指定条件且在指定类中的组件的 Lambda 值。相关函数:CompLambdaByName, ComponentLambda
例如:
● 数据库标题单元格:=CompLambdaByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 Lambda 值
● 电子表格单元格:=CompLambdaByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的第一个组件的 Lambda 值
符合指定条件且具有指定名称的组件的 Lambda 值。相关函数:CompLambdaByClass, ComponentLambda
例如:
● 数据库标题单元格:=CompLambdaByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 Lambda 值
● 电子表格单元格:=CompLambdaByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的第一个组件的 Lambda 值
符合指定条件且在指定类中的组件的名称。相关函数:CompClassByName
例如:
● 数据库标题单元格:=CompNameByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的名称
● 电子表格单元格:=CompNameByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的第一个组件的名称
符合指定条件且具有指定索引的组件的一侧的面积(减去所有孔)。索引为用于识别组件的从 1 开始的索引。相关函数:CompAreaByClass, CompAreaByName
例如:
● 数据库标题单元格:=ComponentArea(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的面积
● 电子表格单元格:=ComponentArea(t=wall,1) 返回绘图中所有墙的第一个组件的组合面积
符合指定条件且具有指定索引的组件的 Lambda 值索引为用于识别组件的从 1 开始的索引。相关函数:CompLambdaByClass, CompLambdaByName
例如:
● 数据库标题单元格:=ComponentLambda(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 Lambda 值
● 电子表格单元格:=ComponentLambda(t=wall,1) 返回绘图中所有墙的第一个组件的 Lambda 值
符合指定条件且具有指定索引的组件名称。索引为用于识别组件的从 1 开始的索引。相关函数:CompNameByClass
例如:
● 数据库标题单元格:=ComponentName(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的名称
● 电子表格单元格:=ComponentName(t=wall,1) 返回绘图中所有墙的第一个组件的名称
符合指定条件且具有指定索引的组件的 R 值。索引为用于识别组件的从 1 开始的索引。相关函数:CompRValueByClass, CompRValueByName
例如:
● 数据库标题单元格:=ComponentRValue(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 R 值
● 电子表格单元格:=ComponentRValue(t=wall,1) 返回绘图中所有墙的第一个组件的组合 R 值
符合指定条件且具有指定索引的组件的厚度。索引为用于识别组件的从 1 开始的索引。相关函数:CompThicknessByClass, CompThicknessByName
例如:
● 数据库标题单元格:=ComponentThickness(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的厚度
● 电子表格单元格:=ComponentThickness(t=wall,1) 返回绘图中所有墙的第一个组件的组合厚度
符合指定条件且具有指定索引的组件的 U 值。索引为用于识别组件的从 1 开始的索引。相关函数:CompUValueByClass, CompUValueByName
例如:
● 数据库标题单元格:=ComponentUValue(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的 U 值
● 电子表格单元格:=ComponentUValue(t=wall,1) 返回绘图中所有墙的第一个组件的组合 U 值
符合指定条件且具有指定索引的组件的体积(减去所有孔)。索引为用于识别组件的从 1 开始的索引。相关函数:CompVolumeByClass, CompVolumeByName
例如:
● 数据库标题单元格:=ComponentVolume(2) 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回第二个组件的体积
● 电子表格单元格:=ComponentVolume(t=wall,1) 返回绘图中所有墙的第一个组件的组合体积
符合指定条件且在指定类中的组件的 R 值。相关函数:CompRValueByClass, ComponentRValue
例如:
● 数据库标题单元格:=CompRValueByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 R 值
● 电子表格单元格:=CompRValueByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合 R 值
符合指定条件且具有指定名称的组件的 R 值。相关函数:CompRValueByClass, ComponentRValue
例如:
● 数据库标题单元格:=CompRValueByName(t=wall,'Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 R 值
● 电子表格单元格:=CompRValueByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合 R 值
符合指定条件且在指定类中的组件的厚度。相关函数:CompThicknessByName, ComponentThickness
例如:
● 数据库标题单元格:=CompThicknessByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的厚度
● 电子表格单元格:=CompThicknessByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合厚度
符合指定条件且具有指定名称的组件的厚度。相关函数:CompThicknessByClass, ComponentThickness
例如:
● 数据库标题单元格:=CompThicknessByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的厚度
● 电子表格单元格:=CompThicknessByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合厚度
符合指定条件且在指定类中的组件的 U 值。相关函数:CompUValueByName, ComponentUValue
例如:
● 数据库标题单元格:=CompUValueByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的 U 值
● 电子表格单元格:=CompUValueByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合 U 值
符合指定条件且具有指定名称的组件的 U 值。相关函数:CompUValueByClass, ComponentUValue
例如:
● 数据库标题单元格:=CompUValueByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的 U 值
● 电子表格单元格:=CompUValueByName(t=wall,'Brick Veneer' 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合 U 值
符合指定条件且在指定类中的组件的体积。相关函数:CompVolumeByName, ComponentVolume
例如:
● 数据库标题单元格:=CompVolumeByClass('Class-1') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回指派给 “Class-1” 类的组件的体积
● 电子表格单元格:=CompVolumeByClass(t=wall,'Class-1') 对于绘图中的所有墙,返回指派给 “Class-1” 类的组件的组合体积
符合指定条件且具有指定名称的组件的体积。相关函数:CompVolumeByClass, ComponentVolume
例如:
● 数据库标题单元格:=CompVolumeByName('Brick Veneer') 对于数据库中的每个墙、圆墙、屋顶、屋顶表面以及楼板对象,返回具有 “Brick Veneer” 名称的组件的体积
● 电子表格单元格:=CompVolumeByName(t=wall,'Brick Veneer') 对于绘图中的所有墙,返回具有 “Brick Veneer” 名称的组件的组合体积
将多个文本字符串合成一个文本字符串。
例如:=concat(B3,', ',B4) 将单元格 B3 和 B4 的内容返回为一个字符串,以一个逗号和一个空格分开
给定角度的余弦。数字是以弧度表示、要计算其余弦的角度。相关函数:acos
例如:=cos(deg2rad(23)) 将 23 度角转换为对等的弧度值,并返回该角度的余弦
符合条件的对象数量。
例如:
● 数据库标题单元格:=Count 返回数据库中每行对象的总数
● 电子表格单元格:=Count(s='simple sofa') 返回绘图中名为“simple sofa” 符号对象的总数
符合指定条件且在指定类中的幕墙框架的组合长度。要找到某幕墙中的所有框架,请使用一个空的类名称。相关函数:CurtWallPnlAreaNet, CurtWallPnlAreaGross
例如:
● 数据库标题单元格:=CurtWallFrameLength('') 返回数据库中每个幕墙的幕墙框架的组合长度
● 电子表格单元格:=CurtWallFrameLength(t=wall, '') 返回绘图中所有幕墙的幕墙框架的组合长度
符合指定条件且在指定类中的墙中幕墙面板的组合总面积。总面积包括框架覆盖面板的部分。要找到某幕墙中的所有面板,请使用一个空的类名称。相关函数:CurtWallFrameLength, CurtWallPnlAreaNet
例如:
● 数据库标题单元格:=CurtWallPnlAreaGross('') 返回数据库中每个幕墙的幕墙面板的组合总面积
● 电子表格单元格:=CurtWallPnlAreaGross(t=wall, '') 返回绘图中所有幕墙的幕墙面板的组合总面积
符合指定条件且在指定类中的墙中幕墙面板的净面积。净面积仅包括以框架为边界的可见面积。要找到某幕墙中的所有面板,请使用一个空的类名称。相关函数:CurtWallFrameLength, CurtWallPnlAreaGross
例如:
● 数据库标题单元格:=CurtWallPnlAreaNet ('Class-1') 返回数据库中每个幕墙被指派给 “Class-1” 类的幕墙面板的组合净面积
● 电子表格单元格:=CurtWallPnlAreaNet(t=wall, 'Class-1') 返回绘图中所有幕墙被指派给 “Class-1” 类的幕墙面板的组合净面积
将一个数字从度数转换为弧度。数字是以度数为单位、要将其转换为弧度的值。
例如:=deg2rad(47) 将 47 度角度测量结果转换为其对等的弧度值
e 的指定次数冪。常数 e 等于 2.71828182845904,是自然对数的底。数字是应用至底 e 的冪。
例如:=exp(2) 返回 e 的 2 次冪值
(需要 Vectorworks Design Series)与某 IFC 对象关联的某特定 IFC 特性的值。条件是一个带有两个元素(由一个句点隔开)的字符串。第一个元素是一个 IFC 实体或 PSet 名称,而第二个元素则是 IFC 特性的名称。
例如:=GETIFCPROPERTY ('ifcfurnishingelement.name') 返回那个 IFC 实体为 IfcFurnishingElement 的 IFC 对象的“名称”值
(需要 Vectorworks Architect)符合指定条件的对象周围的空间名称。相关函数:GetSpaceNumForObj
例如:
● 数据库标题单元格:=GetSpaceNameForObj 返回数据库中每个对象的空间名称
● 电子表格单元格:=GetSpaceNameForObj(n='chair-1') 返回名为 “chair-1” 的对象的空间名称
(需要 Vectorworks Architect)符合指定条件的对象周围的空间编号。相关函数:GetSpaceNameForObj
例如:
● 数据库标题单元格:=GetSpaceNumForObj 返回数据库中每个对象的空间编号
● 电子表格单元格:=GetSpaceNumForObj(n='chair-1') 返回名为 “chair-1” 的对象的空间编号
符合指定条件的对象的组合Δ y(高度)。相关函数:宽度
例如:
● 数据库标题单元格:=Height 返回数据库中每个对象的高度(Δ y)
● 电子表格单元格:=Height(sel=true) 返回绘图中选定对象的组合高度(Δ y)值
如果 logical_test 为 true,使用 value_if_true,如果 logical_test 为 false,使用 value_is_false。
使用此函数对值和公式进行条件测试,并基于该测试的结果选择分支。测试结果决定 If 函数返回的值。logical_test 可以是可将其求值结果确定为 true 或 false 的任何值或表达式。最多可以将七个 If 语句嵌套为 value_if_true、value_if_false 自变量。if 语句内的布尔语句必须包含在圆括号内。if 语句内的文本必须包含在引号内。
例如:
● =if((C7>100),100,C7) 如果单元格 C7 中的值大于 100,则此单元格中的值为 100;否则此单元格中的值与单元格 C7 中的值相同
● =if((C7>100);100;C7) 如果操作系统将逗号用作小数点,使用分号代替。
(需要 Vectorworks Design Series)满足指定条件的与对象关联的图像。在单元格格式中,指定是否显示对象的缩略图或应用于对象的二维属性。
例如:
● 数据库标题单元格:=Image 返回数据库中每个对象的图像
● 电子表格单元格:=Image(s='cabinet') 返回名为 "Cabinet" 的符号的图像
除去一个数字的任何小数部分。数字是要转换为整数的实数。相关函数:round
例如:=int(B9) 返回单元格 B9 中去掉其小数部分的值
符合指定条件对象的翻转状态。
例如:
● 数据库标题单元格:=IsFlipped 返回数据库中每个对象的翻转状态
● 电子表格单元格:=IsFlipped(PON=window) 返回已翻转绘图中窗口对象的总数
符合指定条件的对象的二维左边界(最小 x 坐标)。相关函数:BotBound, TopBound, RightBound
例如:
● 数据库标题单元格:=LeftBound 返回数据库中每个对象的二维左边界
● 电子表格单元格:=LeftBound(t=locus) 返回绘图中最左侧坐标点的二维左边界
符合指定条件的线条、墙或基于路径对象的长度。
例如:
● 数据库标题单元格:=Length 返回数据库中每个对象的长度
● 电子表格单元格:=Length(t=line) 返回绘图中所有线条对象的总长
自然对数(底 e)。数字是要计算其对数的正实数。相关函数:exp
例如:=ln(12) 返回 12 的自然对数
以 10 为底的对数。数字是要计算其对数的正实数。相关函数:ln
例如:=ln(12) 返回 12 的自然对数
自变量列表中的最大数。数字是 1 至 14 个要查找其中最大值的数字。相关函数:min
例如:=max(C5,C7,C9) 返回单元格 C5、C7 和 C9 中的最大数字
自变量列表中的最小数。数字是 1 至 14 个要查找其中最小值的数字。相关函数:max
例如:=min(C5,C7,C9) 返回单元格 C5、C7 和 C9 中的最小数字
符合指定条件的对象的数字对象类型标识。对于对象类型标识列表,请参阅下述链接参阅面向开发人员的文档(需要访问网络):
developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#objects
例如:
● 数据库标题单元格:=ObjectType 返回数据库中每个对象的对象类型值
● 电子表格单元格:=ObjectType(sel=true) 返回选定对象的对象类型值;例如,光源的对象类型值为 81
(需要 Vectorworks Architect)符合指定条件的对象的 Energos 状态(如果它包含在计算中,则为 1;如果不包含在计算中,则为 0)。
例如:
● 数据库标题单元格:=ObjIncludeInEnergos 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 Energos 状态
● 电子表格单元格:=ObjIncludeInEnergos(t=wall) 返回绘图中所有墙的 Energos 状态
(需要 Vectorworks Architect)符合指定条件的对象的 R 值。相关函数:ObjUValue
例如:
● 数据库标题单元格:=ObjectRValue 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 R 值
● 电子表格单元格:=ObjectRValue(n='wall-1') 返回名为 “wall-1” 的墙的 R 值
(需要 Vectorworks Architect)符合指定条件的对象的 U 值。相关函数:ObjRValue
例如:
● 数据库标题单元格:=ObjectUValue 对于数据库中的每个墙、圆墙、屋顶、屋顶表面、楼板、门以及窗对象,返回 U 值
● 电子表格单元格:=ObjectUValue(n='wall-1') 返回名为 “wall-1” 的墙的 U 值
符合指定条件的对象的组合周长。
例如:
● 数据库标题单元格:=Perim 返回数据库中每个对象的周长
● 电子表格单元格:=Perim(sel=true) 返回所有选定对象的总周长
将一个数字从弧度转换为度数。数字是以弧度为单位、要将其转换为度数的值。
例如:=rad2deg(0.5235987) 将弧度角度测量结果转换为其对等的度数值
符合指定条件的对象的二维右边界(最大 x 坐标)。相关函数:BotBound、TopBound、LeftBound
例如:
● 数据库标题单元格:=RightBound 返回数据库中每个对象的二维右边界
● 电子表格单元格:=RightBound(t=rect) 返回绘图中最右侧矩形的二维右边界
沿斜坡的屋顶的受热面积(减去屋檐悬垂),为符合指定条件的所有对象组合该数据。相关函数:RoofArea_HeatedProj
例如:
● 数据库标题单元格:=RoofArea_Heated 返回绘图中每个屋顶和屋顶面对象的受热面积
● 电子表格单元格:=RoofArea_Heated (st=roofface) 返回绘图中所有屋顶面对象的组合受热面积
投影到图层平面的屋顶的受热面积(减去屋檐悬垂),为符合指定条件的所有对象组合该数据。相关函数:RoofArea_Heated
例如:
● 数据库标题单元格:=RoofArea_HeatedProj 返回数据库中每个屋顶和屋顶面对象投影到图层平面的受热面积
● 电子表格单元格:=RoofArea_HeatedProj (t=roof) 返回绘图中所有屋顶对象投影到图层平面的组合受热面积
沿着斜坡的屋顶面积。相关函数:RoofArea_TotalProj
例如:
● 数据库标题单元格:=RoofArea_Total 返回数据库中每个屋顶和屋顶面对象的总面积
● 电子表格单元格:=RoofArea_Total(st=roofface) 返回绘图中所有屋顶面对象的组合总面积
投影到图层平面的屋顶的总面积。相关函数:RoofArea_Total
例如:
● 数据库标题单元格:=RoofArea_TotalProj 返回数据库中每个屋顶和屋顶面对象投影到图层平面的总面积
● 电子表格单元格:=RoofArea_Totalproj(t=roof) 返回绘图中所有屋顶对象投影到图层平面的组合总面积
(需要 Vectorworks Design Series)屋顶样式的名称。
例如:
● 数据库标题单元格:=RoofStyleName 返回数据库中每个屋顶对象的屋顶样式名称
● 电子表格单元格:=RoofStyleName(n='roof-1') 返回名为 “roof-1” 的对象的屋顶样式名称
将指定数字四舍五入至最接近的整数。相关函数:int
例如:=round(D11) 将单元格 D11 中的值四舍五入返回为最接近的整数
运行指定的 VectorScript 或 Python 脚本,将使用该脚本名称的参数传递到该脚本。脚本名称前面的可选参数指定该脚本在 Vectorworks 安装中的文件夹路径。对于文件夹路径值列表,请参阅下述面向开发人员的文档(需要访问网络):
developer.vectorworks.net/index.php/VS:GetFolderPath
请参阅从工作表运行脚本了解细节。
例如:
● 数据库标题单元格:=RunScript('My Script') 运行名为 “My Script” 的 VectorScript 脚本并为数据库中的每个对象返回一个值
● 电子表格单元格:=RunScript(2, 'ScriptFile.py', 2, 1) 在 Vectorworks Plug-Ins 文件夹中执行 Python 脚本 “ScriptFile.py”,传递参数 “2” 和 “1”,并返回一个值
给定角度的正弦。数字是以弧度表示、要计算其正弦的角度。相关函数:asin
例如:=sin(deg2rad(32)) 将 32 度角转换为对等的弧度值,并返回该角度的正弦
(需要 Vectorworks Design Series)楼板样式的名称。
例如:
● 数据库标题单元格:=SlabStyleName 返回数据库中每个楼板对象楼板样式的名称
● 电子表格单元格:=SlabStyleName(n='slab-1') 返回名为“slab-1”的对象的楼板样式的名称
(需要 Vectorworks Designer)符合指定条件的楼板对象(楼面和屋顶面)的组合厚度。
例如:
● 数据库标题单元格:=SlabThickness 返回数据库中每个对象的厚度
● 电子表格单元格:=SlabThickness(PON=slab) 返回绘图中所有楼板对象的组合厚度
一个正平方根。数字是要计算其平方根的数字。
例如:=sqrt(D27) 返回单元格 D27 中的数字的平方根
利用一个分隔符将单独字符串拆分成一个字符串阵列,并按指定索引输出每个字符串。
例如:=SUBSTRING(('kitchen;bedroom;bathroom;basement', ';', 2) 返回指定字符串中的第二个子字符串—— “bedroom”
自变量列表中所有数字的总和。数字是 1 至 14 个要计算其总和的数字。相关函数:Average
例如:=sum(A2,A10..A12) 返回包含在单元格 A2、A10、A11 和 A12 中的数字的总和
符合条件的所有对象的总曲面面积,基于“单位”对话框中的“面积”单位。
例如:
● 数据库标题单元格:=SurfaceArea 返回数据库中每个对象的曲面面积
● 电子表格单元格:=SurfaceArea(st=sphere) 返回绘图中所有球体对象的总曲面面积
给定角度的正切。数字是以弧度表示、要计算其正切的角度。相关函数:atan
例如:=tan(deg2rad(32)) 将 32 度角转换为对等的弧度值,并返回该角度的正切
符合指定条件的对象的二维上边界(最大 y 坐标)。相关函数:BotBound、LeftBound、RightBound
例如:
● 数据库标题单元格:=TopBound 返回数据库中每个对象的二维上边界
● 电子表格单元格:=TopBound(sel=true) 返回最上方选定对象的二维上边界
将一个表示数字的文本字符串转换为一个数字。
例如:=value('2e3') 返回 2 乘以 10 的 3 次冪后得到的数值
符合条件的所有对象的总体积,基于“单位”对话框中的“体积”单位。
例如:
● 数据库标题单元格:=Volume 返回数据库中每个对象的体积
● 电子表格单元格:=Volume(t=xtrd) 返回绘图中所有拉伸对象的总体积
符合指定条件的墙的一个墙面的组合二维总曲面面积。相关函数:WallArea_Net
例如:
● 数据库标题单元格:=WallArea_Gross 返回数据库中每个墙的一个墙面的总曲面面积
● 电子表格单元格:=WallArea_Gross(t=wall) 返回绘图中所有墙的一个墙面的组合总曲面面积
符合指定条件的墙的一个墙面的组合二维净曲面面积,不含门、窗和插入符号的面积。相关函数:WallArea_Gross
例如:
● 数据库标题单元格:=WallArea_Net 返回数据库中每个对象的一个墙面的净曲面面积,减去插入对象面积
● 电子表格单元格:=WallArea_Net(t=wall) 返回绘图中所有墙的一个墙面的组合净曲面面积,减去插入对象面积
墙的平均高度,包括墙最高点和不同的开始和结束高度。
例如:
● 数据库标题单元格:=WallAverageHeight 返回数据库中每个墙对象的平均高度
● 电子表格单元格:=WallAverageHeight((t=wall)&(sel=true)) 返回绘图中已选定所有墙的平均高度
(需要 Vectorworks Design Series)墙样式的名称。
例如:
● 数据库标题单元格:=WallStyleName 返回数据库中每个墙对象墙样式的名称
● 电子表格单元格:=WallStyleName(n='wall-1') 返回名为“wall-1”的对象的墙样式的名称
符合指定条件的墙对象的组合厚度。
例如:
● 数据库标题单元格:=WallThickness 返回数据库中每个墙对象的厚度
● 电子表格单元格:=WallThickness(t=wall) 返回绘图中所有墙的组合厚度
符合指定条件的对象的组合Δ x(宽度)。相关函数:高度
例如:
● 数据库标题单元格:=Width 返回数据库中每个对象的宽度(Δ x)
● 电子表格单元格:=Width(sel=true) 返回选定对象的组合宽度(Δ x 值)
符合指定条件的对象中心点的 x 坐标。相关函数:YCenter、ZCenter、XCoordinate
例如:
● 数据库标题单元格:=XCenter 返回数据库中每个对象二维边界中心的 x 坐标值
● 电子表格单元格:=XCenter(sel=true) 返回选定对象二维边界中心的 x 坐标值
符号、点插件对象和坐标点的插入点的 x 坐标。返回值相对于用户原点。相关函数:YCoordinate、ZCoordinate、XCenter
例如:
● 数据库标题单元格:=XCoordinate 返回数据库中每个对象的 x 坐标值
符合指定条件的对象中心点的 y 坐标。相关函数:XCenter、ZCenter、YCoordinate
例如:
● 数据库标题单元格:=YCenter 返回数据库中每个对象二维边界中心的 y 坐标值
● 电子表格单元格:=YCenter(sel=true) 返回选定对象二维边界中心的 y 坐标值
符号、点插件对象和坐标点的插入点的 y 坐标。返回值相对于用户原点。相关函数:XCoordinate、ZCoordinate、YCenter
例如:
● 数据库标题单元格:=YCoordinate 返回数据库中每个对象的 y 坐标值
符合指定条件的对象中心点的 z 坐标。相关函数:XCenter、YCenter、ZCoordinate
例如:
● 数据库标题单元格:=ZCenter 返回数据库中每个对象二维边界中心的 z 坐标值
● 电子表格单元格:=ZCenter(sel=true) 返回选定对象二维边界中心的 z 坐标值
符号、点插件对象和坐标点的插入点的 z 坐标。返回值相对于用户原点。相关函数:XCoordinate、YCoordinate、ZCenter
例如:
● 数据库标题单元格:=ZCoordinate 返回数据库中每个对象的 z 坐标值