公式示例

查看公式如何计算族中参数值的示例。

高级样例族包含不同种类的公式示例，演示了公式如何用于计算参数值并控制族的几何图形。样例族还说明了常用公式类型的语法。

高级样例族 (rac_advanced_sample_family.rfa) 随产品一起安装在以下目录：%ProgramFiles%\Autodesk\Autodesk Revit 2024 Release\Samples. 联机用户也可以从样例族文件页面下载文件。

高级样例族是放置于窗上方或项目中窗上的遮阳装置。用户定义遮光罩族与窗口关联方式的参数。遮光罩的几何图形将根据公式进行修改以提供窗口遮阳。以下图像显示了项目中遮光罩族的三维和立面视图。

基本数学

这些示例演示了公式中的基本数学函数。

参数	公式
Shadow_Length	Mounting_Height-Window_Sill_Height
Rel_Angle	90º-Sun_Angle
Max Louver Spacing	Support_Length-(Support_Length(Desired_Shading_Percent0.01))

Shadow_Length 参数是通过将族安装高度减去窗台高度而得出的。
结果是天窗系统要为窗口彻底遮阳所需的阴影长度。
Rel_Angle 参数是用常数 (90) 减去阳光角度后得出的。
此参数稍后将用于其他使用三角函数的公式以计算投射阴影所需的支座长度，长度由 Shadow_Length 参数定义。
“Max Louver Spacing”是通过支座的长度和所需的遮阳物而计算得出的。
公式首先将百分比转换为小数值，然后将该值乘以支座长度。结果值即为用天窗覆盖所需的遮阳量。

支座长度是由三角函数计算得出的，然后向上舍入为最接近的毫米 (mm)。

参数	公式
Support_Length	roundup((Shadow_Length/1mm)tan(Rel_Angle))1mm

所需的 Support_Length 是一个函数，由 Shadow_Length 乘以阳光与遮阳装置相对角度的正切（根据一年中的时间和项目的位置）。
这些变量条件将更改所需支座的必须长度以实现窗口彻底遮阳。
舍入函数获取计算的值并将其舍入到最接近的 mm。对于要使用的舍入函数，要舍入的数字必须为无单位。
在示例公式中，长度单位公式从 Shadow_Length 参数中删除，方法是首先将参数除以 1mm，然后再进行计算。
在数字舍入为最接近的毫米时，单位将乘以 1mm 再添加回数字。

在公式中可以使用条件语句来检查其他参数的值并根据这些值返回结果。有关其他信息，请参见在公式中使用条件语句。在该示例中，Support_Hanger 参数为 "Yes/No" 参数，用于控制遮光罩附加支座的可见性。

参数	公式
Support_Hanger	Support_Length>400mm
Shade_Factor	if(Desired_Shading_Percent<65,"Low",if(Desired_Shading_Percent<79,"Med",if(Desired_Shading_Percent<99,"High","Max.")))

一旦 Support_Length 参数超出 400mm，则语句为真，该参数值设置为“Yes”并且其他支座将可见。
如果在公式中使用条件语句来定义 Yes/No 参数，则结果“如果真”和结果“如果假”为隐含，无法按照公式的语法写入。
Shade_Factor 参数使用嵌套条件语句以得到 1 个结果（共 4 个结果），包括 低、中、高或最大。
检查根据 Desired_Shading_Percent 完成，并且基于此值，返回文本结果。
每个连续的 IF 语句都处于选中状态。如果条件不为真，则接下来的 IF 语句为估值，直到得到真实的结果。

族中的阵列可使用整数参数进行控制。如果阵列由公式控制，则公式必须包含语法来确保阵列值始终大于 1（阵列值必须始终大于 1）。

参数	公式
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1