摘要
LFf`K)q dRaO Gm) 为您的
光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在
参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置
系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本
教程中，我们使用球面作为简单的
编程示例。
nidr\oFUIn {mTytT 
BKIjNV3 f.6~x$:)`E 可编程界面所在位置：目录
Kq)MTlP0g L0NA*C
p&Ed\aQ%z; 3BQ!qO17^d 提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。
Q(Gl{#b )uheV,ZnY 可编程界面所在位置：组件
d@ J a}` N#ioJ^}n: 
'@=PGpRF P_Hv%g 编写代码
6.c^u5; /+|#^:@ •右侧面板显示了可用的独立参数列表。
1G^#q,%X_v •x和y表示独立变量，即平面上的2D坐标。
M(Zc^P}N •由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。
\Qy$I-Du •主函数中的代码必须每x，y点返回一个双
精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
w _wslN,) •使用Snippet Body将支持函数中的部分代码分组。
'LS z f/w Jxl6a: 
hdma=KqZ( %)(Cp-b! 提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。
Mps5Vv ZH 6\><My 表面梯度的定义
1iBP,:>* h6D^G5i •精确计算界面的梯度是光学仿真的基础。
)> a B •VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由
软件自动执行）或解析模式（由用户另外编程）。
O XP\R H17-/|-;0! 
cr;`Tl~}s gm"#:< ) 用户自定义的表面梯度
ec3<%+0f R.9V,R5 YN/ }9. •右侧面板显示了相同的可用独立参数列表。
SU.ythU2,c •该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。
EH f \L •尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！
Vu8,(A7D%O #q\x$ 
/~p+j{0L3W S.*~C0" 可编程界面的输出
yYZxLJ=' o4y']JSN •输出是3D表面，其可用于定义系统中实际光学组件的界面。
A!i q ->+ •在有需要时，可在实际组件内直接编程自定义界面。
1GCzyBSbb •或者，将其保存在目录中供后续使用。
/0MDISQy9 2}U!:bn( 
qoMfSz "( gb|Q%LS9R 对球形表面进行编程
f .
}c7 C~%
1w%nn 球形表面
nw: -J1kWR iA
}vKQ 
?# A]{l e GL1 可编程界面所在位置：目录
EbNd=Z'J J Yb}Zw; 
I0'WOV70 m"eteA,"k_ 可编程界面所在位置：组件
kS 5_&#
>/$Fh:R- 
O `1! ,MPB/j^o5! 设置表面的定义区域
(.Y/ k44Q):ncY7 •在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。
bPK Ow< •在本例中，我们使用圆孔。
k; W@LfP •请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！
OPJ: XbG
h B;VCg8 
l\0w;:N3 E>LkJS y= 进入可编程界面
2-*V=El iSLGwTdLn 
:nN1e `O?T.p) 可编程界面：全局参数
B;6]NCx D $lA
V 6I. •打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。
p/Sbt/R •在那里，添加和编辑一个参数：
Cs3^9m6;d - 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。
eDI= nSo •使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。
e> rRTN 提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。
EI~"L$? ^ >x|z. 
N;oQ^B' J@pb[O L, 可编程界面：代码段帮助（Snippet Help）
lA(Q@yEW }GMbBZ:nKK •可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。
d$ACDX2 •此选项对于使用可编程元素跟踪进度非常有用。
p^kUs0$GS •当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！
fc=Patg f"u *D,/sS 
~[o 4a ' _ZB\L^j) 
Y}*\[}l:&x mMx ;yZ 可编程界面：编写代码
8M*PML4r 1LJuCI=~ 
+6$g! S5{ |'ln?D:& 可编程界面：用户自定义梯度
5<pftTcZ 5vAf7\* 
c\6+=\ 可编程界面：使用您的代码段（Snippet）
j:T/ iH!YF hRI"y":zD 
'TC/vnM up3O|lj4 可编程界面的输出
}eQRN<}P 93qwH% 
SKuIF*"! S XY.5Rno4 此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平）
u cwnA =p^He! 将自定义界面保存到目录中
iI@jZVk a {}|Bf< 
,t{,_uP JY "vCM}F 提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。
l\AMl
\ SVlua@]ChU 故障排除提示
q+ KzIde|% etT + 
.x`M<L#M( l+V,DCE 您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？
CM )Q& : $WYbm}j 
`-`q dda 9odJ r] 测试代码!
-7/s]9o' &mj6 rIz 
TSA U?r\P <Llp\Xc Z 
fP
tm0.r i&njqK!wS 文件信息
>&g}7d% |py6pek| 
v5;I]?72l~ {U
'd}Q （来源：讯技光电）
