ZPL手册911011

返回函数列表

功能:

设置表面的属性。


语法:

SETSURFACEPROPERTY surface, code, value1, value2 SURP surface, code, value1, value2


详述:

surface 是一个计算结果为整数的表达式,指定表面编号。code 是一个计算结果为整数的表达式, 或者是助记符,用于指定要修改表面的哪些属性。第三个和第四个变量表示指定表面属性的新值,可能是引号中的文本、字符串变量或数值表达式,具体取决于代码。对于大多数代码,需要修改 的属性由 value1 参数定义。少数操作数同时需要 value1 和 value2 定义,如下表所述。如果要修改的属性由多重结构编辑器控制,那么当前结构的多重结构数据也会发生变化,以显示 更改的属性。若要将某个表面设置为光阑面,请参阅 STOPSURF。SURP 是 SETSURFACEPROPERTY 的缩写,功能完全相同。代码特性表面基础数据。请参阅[镜头数据](Lens Data)。0 或 TYPE表面类型。value 是物体的名称,比如表示标准表面的 STANDARD。在表面数据概要的分类报表中列出了当前镜头数据编辑器中的每个表面类型名称。若要将表面类型更改为用户自定义表面,请首先使用代码 9 (SDLL) 来设置DLL 名称,然后将新的表面类型设置为 USERSURF。另请参阅[代码 17](Code 17)。1 或 COMM注释。2 或 CURV以镜头单位表示的曲率(不是半径)。使用 0 表示无穷大半径。3 或 THIC厚度,以镜头单位表示。4 或 GLAS玻璃名称。另请参阅[代码 18](Code 18)。5 或 CONI圆锥系数。6 或 SDIA净半口径或半口径。如果 value 为 0 或正数,则净半口径或半口径的求解类型 设置为固定。如果 value 为负数,则净半口径或半口径的求解类型设置为自 动,并且净半口径或半口径的值由下一个 UPDATE 关键字计算出来。7 或 TCE热膨胀系数。8 或 COAT膜层名称。将 value1 设置为空白字符串可删除膜层。9 或 SDLL用户自定义表面 DLL 名称。10 或 PARM参数值。value1 为新的数值。value2 为参数编号。11 或 EDVA附加数据值。value1 为新的数值。value2 为附加数据编号。12表面颜色,用 0 表示默认值。13表面透明度。14行颜色。15表面不能是超半球面。使用 1 可避免表面成为超半球面。16忽略表面。用 1 表示忽略表面,0 表示不忽略表面。17 或 CODE表面类型的整数代码。整数代码是使用代码 0 设置表面名称的备用选项。有关 更多详情,请参阅上文中对代码 0 的说明。18 或 GLAN玻璃编号。另请参阅[代码 4](Code 4)。表面孔径数据。请参阅[表面属性对话框中孔径选项卡](Surface properties aperture tab)。20 或 ATYP表面孔径类型代码。21 或 APP1表面孔径参数 1。22 或 APP2表面孔径参数 2。23 或 APDX表面孔径 x 偏心。24 或 APDY表面孔径 y 偏心。25 或 UDA用户自定义孔径 (UDA) 文件名。26 或 APPU表面孔径跟随求解的表面编号。用 0 表示无。27 或 CHZN 表面的延伸区。28 或 MCSD 机械半口径。如果 value 为 0 或正数,则机械半口 径的求解类型设置为固定。如果 value 为负数,则机械半口径的求解类型设置为自动,并且 机械半口径的值由下一个 UPDATE 关键字计算出来。物理光学传播设置。请参阅[表面属性 对话框中物理光学选项卡](Surface specific settings)。30物理光学设置[用几何光线传播到下一表面](Use Rays To Propagate To NextSurface)。用 1 表示勾选,0 表示未勾选。31物理光学设置[不用几何光线数据缩放光束尺寸](Do Not Rescale Beam SizeUsing Ray Data)。 用 1 表示勾选,0 表示未勾选。32物理光学设置[采用角谱算法](Use Angular Spectrum Propagator)。 用 1 表 示勾选,0 表示未勾选。33物理光学设置[在实体模型上显示 ZBF](Draw ZBF On Shaded Model)。 用 1 表 示勾选,0 表示未勾选。34物理光学设置 Recompute Pilot Beam Parameters。1 表示勾选,0 表示未勾 选。35物理光学设置[折射后重新采样](Resample After Refraction)。 1 表示勾 选,0 表示未勾选。36物理光学设置[自动重新采样](Auto Resample)。 1 表示勾选,0 表示未勾选。37物理光学设置[新建 X 采样](New X Resample)。1 表示 32,用 2 表示 64 等。38物理光学设置[新建 Y 采样] (New Y Resample)。 1 表示 32, 2 表示 64 等。39物理光学设置[新建 X 宽度](New X-Width)。数组的 X 方向全宽。40物理光学设置[新建 Y 宽度](New Y-Width)。数组的 Y 方向全宽。41物理光学设置[输出 Pilot 半径](Output Pilot Radius)。使用 0 表示最佳拟 合,1 表示更短,2 表示更长,3 表示 x,4 表示 y,5 表示平面,6 表示用户。42、43分别为物理光学设置 X-Radius 和 Y-Radius。44物理光学设置[采用 X 轴参考]( Use X-axis Reference)。1 表示勾选,0 表示 未勾选。膜层设置。请参阅[表面属性对话框中膜层选项卡](Surface coating tab)。另请参阅上文的code 8。50使用多膜层和折射率偏移。用 1 表示勾选,0 表示未勾选。51多膜层值。value1 为新的数值。value2 为膜层编号。52多膜层状态。value1 为状态,用 0 表示固定,1 表示变量,或者用 n+1 表示跟 随膜层 n。value2 为膜层编号。53膜层折射率偏移值。value1 为新的数值。value2 为膜层编号。54膜层折射率偏移状态。value1 为状态,用 0 表示固定,用 1 表示变量,或者 用 n+1 表示跟随膜层 n。value2 为膜层编号。55膜层消光偏移值。value1 为新的数值。value2 为膜层编号。56膜层消光偏移状态。value1 为状态,用 0 表示固定,用 1 表示变量,或者用n+1 表示跟随膜层 n。value2 为膜层编号。表 面 倾 斜 和 偏 心 数 据 。 请 参 阅[表 面 属 性 对话框 中 倾 斜/偏 心 选 项 卡](Surface tilt/decenter tab)。60 或 BOR面之前的倾斜和偏心顺序。用 0 表示偏心/倾斜,用 1 表示倾斜/偏心。61 或 BDX面之前 x 偏心。62 或 BDY面之前 y 偏心。63 或 BTX面之前 x 倾斜64 或 BTY面之前 y 倾斜65 或 BTZ面之前 z 倾斜66 或 APU面之后的状态:0 表示直接,1 或 2 表示跟随或翻转当前表面,3 或 4 表示跟 随或翻转当前表面减 1,5 或 6 表示跟随或翻转当前表面减 2,以此类推。70 或 AOR面之后倾斜和偏心顺序。用 0 表示偏心/倾斜,用 1 表示倾斜/偏心。71 或 ADX面之后 x 偏心。72 或 ADY面之后 y 偏心。73 或 ATX面之后 x 倾斜。74 或 ATY面之后 y 倾斜。75 或 ATZ面之后 z 倾斜。76坐标返回状态。仅在坐标变换面上有效。用 0 表示无,1 表示 仅方向,2 表示 XY 方向,3 表示 XYZ 方向。77坐标返回至表面。仅在坐标变换面上有效。表面散射数据。请参阅[表面属性对话框中散射选项卡](Surface properties scattering tab)。80设置散射代码:0 表示无,1 表示朗伯,2 表示高斯,3 表示 ABg,4 表示DLL,5 表示 BSDF,6 表示 ABg 文件,7 表示 IS 散射库。81设置散射因子,在 0.0 到 1.0 之间。82设置高斯散射 Sigma。83设置 ABg 文件名称。84设置用户自定义散射 DLL 的名称。若要设置参数,请参阅 Code181。85设置用户自定义散射 DLL 使用的数据文件名称。86设置 BSDF 文件名称。value 必须是 BSDF 文件的名称,且不含路径(如BrownVinyl.bsdf)。87设置 ABg 数据文件名称。value 必须是 ABGF 文件的名称,且不含路径(如 SampleABGF.abgf)。88设置 IS 散射库数据文件名称。value 必须为 ISX 文件名,且不含路径(如BrownVinyl.ISX)。110设置 IS 散射库散射的边。用 0 表示前面,1 表示后面。111设置 IS 散射库散射的采样。用 0 表示 5 度, 1 表示 2 度、 2 表示 1 度。表面绘制数据。请参阅[表面属性对话框中绘制选项卡](Surface properties draw tab)。90设置[隐藏这个表面的光线](Hide Rays To This Surface)复选框状态:0 表示 关闭,1 表示开启。91设置[光线忽略这个面](Skip Rays To This Surface)复选框状态:0 表示关 闭,1 表示开启。92设置[不显示此表面](Do Not Draw This Surface)复选框状态:0 表示关闭,1 表示开启。93设置[不显示此表面的边缘](Do Not Draw Edges From This Surface)复选框状 态:0 表示关闭,1 表示开启。96设置[边缘显示](Draw Edges As)状态:0 表示平方,1 表示锥形,2 表示平 面。97设置[镜面基底](Mirror Substrate)状态:0 表示无,1 表示平面,2 表示弯 曲。98设置镜面基底厚度值。


示例:

!Set the glass type on surface 7 to BK7
SETSURFACEPROPERTY 7, GLAS, "BK7"
!Set the thickness of surface 2 to the thickness of surface 1
SETSURFACEPROPERTY 2, THIC, THIC(1)
!Set the value of parameter 4 on surface 11 to 7.3
SURP 11, PARM, 7.3, 4


相关函数:

SPRO相关关键字SETSYSTEMPROPERTY、UPDATE



该文档由光学课堂(www.optkt.cn)生成

最后更新时间:2020/3/7 12:39:02

登录 后发表评论
0条评论
还没有人评论过~