ZPL手册

返回函数列表

功能:

设置 NSC 物体的属性。


语法:

SETNSCPROPERTY surface, object, code, face, value


详述:

此关键字需要 4 个计算结果为整数的数值表达式,用于指定非序列组件表面编号(在非序列模式 下,surface 值设为 1)、物体编号、指定修改物体对应属性的代码以及物体的对应面编号(如果 没有使用设置的属性,则 face 值设为 0)。第五个变量 value 表示指定属性的新数值,可以是引号中的文本、字符串变量或者数值表达式。代码如下:代码属性以下代码表示设置 NSC 编辑器中的值。1设置物体注释。2设置参考物体编号。3设置[在内部](inside of)的物体编号。4设置物体材料。以下代码用于设置[物体属性](Object Properties)对话框中的[类型](type)选项卡上对应的值。0设置物体类型。value 必须是物体的名称,比如表示标准镜头的 “NSC_SLEN”。在 分类报表中列出了 NSC 编辑器中每个物体类型的名称 。所有 NSC 物体名称均以 “NSC_”开头。13设置[用户自定义孔径](User Defined Aperture),用 1 表示勾选,用 0 表示未勾选。14设置[用户自定义孔径](User Defined Aperture)文件名。15设置[使用全局 XYZ 旋转命令](Use Global XYZ Rotation Order)复选框,用 1 表示勾选,用 0 表示未勾选。16设置[光线忽略物体](Rays Ignore This Object)选项,用 0 表示从不,1 表示始终,2 表示启用。17设置[物体为探测器](Object Is A Detector)复选框,用 1 表示勾选,用 0 表示未勾 选。18设置[考虑物体](Consider Objects)列表。此变量是一个字符串,列出需要考虑物体 的编号,用空格隔开,比如“2 5 14”。19设置[忽略物体](Ignore Objects)列表。此变量是一个字符串,列出需要忽略物体的 编号,用空格隔开,比如“1 3 7”。20设置[使用像素插值](Use Pixel Interpolation)复选框,用 1 表示勾选,用 0 表示未 勾选。30设置 [ 光 线 分 裂 时 使 用 考 虑/忽 略 物 体 ]( Use Consider/Ignore Objects WhenSplitting)复选框,用 1 表示勾选,用 0 表示未勾选。以下代码用于设置[物体属性](Object Properties)对话框中[膜层/散射](Coat/Scatter)选项卡 上对应的值。5设置指定表面的膜层名称。6设置指定表面的配置文件名称。7设置指定表面的散射模型。0 = 无,1 = 朗伯,2 = 高斯,3 = ABg,4 = 用户自定义,5 = BSDF,6 = ABg 文件,7 = IS 散射库。8设置指定表面的散射系数。9设置指定表面的散射光线数。10设置指定面的高斯 Sigma(高斯散射模型)或采样方位角(BSDF 或IS 散射库散射模型)。11设置指定表面的反射 ABg 数据名称。12设置指定表面的透射 ABg 数据名称。27设置用户自定义散射 DLL 的名称。21-26设置用户定义的散射 DLL 的参数值。28设置用户定义的散射数据文件的名称。29设置指定表面的[面为](Face Is)属性。0 表示[物体默认]( Object Default),1 表示[反射](Reflective),2 表示[吸收](Absorbing)。31设置指定面的反射 BSDF 数据文件。value 必须是 BSDF 文件的名称,且不含路径(如 BrownVinyl.bsdf)。32设置指定面的透射 BSDF 数据文件。value 必须是 BSDF 文件的名称,且不含路径(如 BrownVinyl.bsdf)。33设置指定面的反射 ABg 数据文件。value 必须为ABGF 文件名,且不含路径(如 SampleABGF.abgf)。34设置指定面的透射 ABg 数据文件。value 必须为ABGF 文件名,且不含路径(如 SampleABGF.abgf)。35设置指定面的反射 IS 散射库数据文件。value 必须为 ISX 文件名,不含路径(如BrownVinyl.ISX)。36设置指定面的透射 IS 散射库数据文件。value 必须为 ISX 文件名,不含路径(如BrownVinyl.ISX)。37设置指定表面的薄板散射选项。使用 0 可关闭选项(不勾选复选框中的选项),用 1 可 开启选项(勾选复选框中的选项)38设置 IS 散射库散射的采样面反射率。用 0 表示前面,1 表示后面。39设置 IS 散射库散射的采样面透过率。用 0 表示前面,1 表示后面。40设置 IS 散射库散射的采样反射率。用 0 表示 5 度,1 表示 2 度、2 表示 1 度。41设置 IS 散射库散射的采样透过率。用 0 表示 5 度,1 表示 2 度、2 表示 1 度。以下代码用于设置[物体属性](Object Properties)对话框中 [体散射](Volume Physics)选项卡上对应的值。81在 体 散 射 选 项 卡 上 设 置 [ 模型 ](Model) 的 值 。 用 0 表示 [ 无 体 散 射 ](No Bulk Scattering),1 表示[角度散射](Angle Scattering),2 表示[DLL 文件散射](DLL Defined Scattering),3 表示[荧光散射]()。82设置要用于体散射的平均光程。83设置要用于体散射的角度。84设置要用于体散射的 DLL 文件名称。85设置要传递到 DLL 的参数值,其中 face 值用于指定需要定义的参数。第一个参数为1,第二个参数为 2,以此类推。86设置波长漂移字符串。以下代码用于设置[物体属性](Object Properties)对话框中[衍射](Diffraction)选项卡上对应 的值。91在[衍射](Diffraction)选项卡上设置[分裂](Split)值。0 表示[不按次序分裂](Don’t Split By Order),1 表示[按以下表格分裂](Split By Below),2 表示 [根据 DLL 函 数分裂]( Split By DLL Function)。92设置要用于衍射分裂的 DLL 的名称。93设置起始次序值。94设置终止次序值。95、96在[衍射](Diffraction)选项卡上设置参数值。这此参数传递到衍射分裂 DLL 函数, 同样也是[按以下表格分裂](Split By Below)选项使用的次序值。face 值用于指定需 要定义的参数。第一个参数为 1,第二个参数为 2,以此类推。代码 95 用于反射属 性,96 用于透射属性。以下代码用于设置[物体属性](Object Properties)对话框中[光源](Sources)选项卡上对应的 值。101设置光源物体的[随机偏振](random polarization)。用 1 表示勾选,用 0 表示未勾选。102设置光源物体[逆向光线](reverse rays option)选项。用 1 表示勾选,用 0 表示未勾选。103设置光源物体琼斯 X 值。104设置光源物体琼斯 Y 值。105设置光源物体相位 X 值。106设置光源物体相位 Y 值。107设置光源物体[初始相位](initial phase)值(以度为单位)。108设置光源物体[相干长度](coherence length)值。109设置光源物体[预传播](pre-propagation)值。110设置光源物体采样方法;0 表示随机,1 表示 Sobol 采样。111设置光源物体体散射方法;0 表示多次、1 表示一次、2 表示从不。112设置[阵列类型](array mode),0 表示无,1 表示矩形,2 表示圆形,3 表示六边,4 表 示六角。113设置[光源颜色模型](source color mode)。有关可用模式的完整列表,请参阅[定义光 源颜色和光谱的目录]( Defining the color and spectral content of sources)。 光源颜色模型从 0 开始编号,0 表示系统波长,然后从 1 到 n 分别表示对话框中列出 的模型序号。114-116分别设置光谱步长数量、起始波长和终止波长。117设置光谱文件的名称。161-162设置阵列类型整数变量 1 和 2。165-166设置阵列类型双精度变量 1 和 2。181-183设置光源颜色模型变量,例如,三色刺激值 XYZ 。以下代码用于设置[物体属性](Object Properties)对话框中[梯度折射](Grin)选项卡上对应的 值。121设置使用 [DLL 定义梯度折射率介质](Use DLL Defined Grin Media)复选框。用 1 表示勾选,用 0 表示未勾选。122设置[最大步长](Maximum Step Size)值。123设置 DLL 名称。124设置 Grin DLL 参数。这些是传递到 DLL 的参数。face 值用于指定需要定义的参数。 第一个参数为 1,第二个参数为 2,以此类推。以下代码用于设置[物体属性](Object Properties)对话框中[绘图](Draw)选项卡上对应的值。141设置[不显示此物体](do not draw)复选框。用 1 表示勾选,0 表示未勾选。142设置物体透明度。用 0 表示 100%,1 表示 90%,2 表示 80%,以此类推。143设置物体的[绘图精度](drawing resolution)。用 0 表示标准,1 表示中等,2 表示高,3 表示精密,4 表示用户自定义。144在[绘图精度](drawing resolution)设置为 Custom 时,设置绘图精度中输入的第一个分 辨率的值(例如,环形非球面镜头物体的“角”分辨率)。在使用此代码之前,必须 将[绘图精度](drawing resolution)设置为 Custom。145在[绘图精度](drawing resolution)设置为 Custom 时,设置绘图精度中输入的第二个分 辨率的值(例如,环形非球面镜头物体的“径向”分辨率)。在使用此代码之前,必 须将[绘图精度](drawing resolution)设置为 Custom。以下代码用于设置[物体属性](Object Properties)对话框中[散射路径](Scatter To)选项卡上 对应的值。151设置散射路径模型。用 0 表示散射路径(Scatter To List),1 表示重点采样。152设置重点采样目标数据。变量必须是一个字符串,列出光线编号、物体编号、尺寸和 极值,并且用空格分隔,以下是用于设置光线 3、物体 6、尺寸 3.5 和极值 0.6 重点采 样的语法:“3 6 3.5 0.6”。153设置[散射路径](Scatter To List)值。变量是一个字符串,列出了散射路径上的物体编 号,用空格分隔,比如“4 6 19”。以下代码用于设置[物体属性](Object Properties)对话框中[双折射]( Birefringence)选项卡 对应的值。171设置[双折射介质](Birefringence Media)复选框。用 0 表示未勾选,用 1 表示勾选。172设置双折射介质模式。用 0 表示追迹寻常光线和非寻常光线,1 表示只追迹寻常光 线,2 表示只追迹非寻常光线,3 表示波片模式。173设置[双折射介质反射](Birefringent Media Reflections)状态。用 0 表示追迹反射 和折射光线,1 表示只追迹反射光线,2 表示只追迹折射光线。174-176设置 Ax、Ay 和 Az 值。177设置轴长。以下代码不设置任何值,此处只是为了返回函数 NPRO 的值。200通过函数 NPRO 确定某个物体的折射率。语法为::NPRO(表面, 物体, 200, 波长编 号)201-203通过函数 NPRO 确定某个物体的 nd (201)、vd (202) 和 dpgf (203) 参数(使用模型玻 璃求解方式)。语法为::NPRO(表面, 物体, 201, 0)以后会增加其它代码值,根据用户的需求来设置 NSC 物体的其它属性。


示例:

SETNSCPROPERTY 1, 2, 0, 0, "NSC_SLEN"


相关函数:

INSERTOBJECT、SETNSCPARAMETER、SETNSCPOSITION



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

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

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