(B+ CI%=
D 为您的
光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该
函数是在
参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置
系统中的光学组件。在
VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本
教程中，我们使用球面作为简单的
编程示例。
v\lhbpk Yx#?lA2gx 
&k53*Wo 可编程界面所在位置：目录
v X?MB n0)0"S|y1 
-nK\+bTL} 提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。
fG dT2}gd \iL{q^Im 可编程界面所在位置：组件
B|I9Ex~L M $J{clr 
Z01BzIsR '0b!lVe t .\<Q#bN# 编写代码
mH`K~8pRg [p Y1\$, s rL|Y&8 p •右侧面板显示了可用的独立参数列表。
4e`GMt p •x和y表示独立变量，即平面上的2D坐标。
r< MW 8 •由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。
9N[(f-` •主函数中的代码必须每x，y点返回一个双
精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
~W/|RP7S •使用Snippet Body将支持函数中的部分代码分组。
O Ko)p`BX b?^CnMO 
=`st1K mv,p*0 提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。
vQH 6CB" FH3^@@Y% 表面梯度的定义
>PbB /-> Ty&O k* !#[B#DZc( •精确计算界面的梯度是光学仿真的基础。
!=)b2}e/> •VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由
软件自动执行）或解析模式（由用户另外编程）。
JX)%iJq# 
^QG;:.3v XfZ^,' z 用户自定义的表面梯度
OK] _.v} 3a Y^6& #jqcUno •右侧面板显示了相同的可用独立参数列表。
8el\M/ u{ •该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。
HuI?kLfj\ •尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！
1Zo"Xb 0PP5qeqN2n 
F[@M? $-w&<U$E 可编程界面的输出
GbB :K2 XM#xxf* Y O~*`YsL9 •输出是3D表面，其可用于定义系统中实际光学组件的界面。
) .$ q9G •在有需要时，可在实际组件内直接编程自定义界面。
E+"m @63 •或者，将其保存在目录中供后续使用。
eAl;:0=%L zz m[sX} 
Gnthz 0\]{ hu at,zLS WU +OS( aj`_* T "A ,9.-A-Yw ~PZIYG"D 对球形表面进行编程
u*6Y>_iA 球形表面
Vh}F#~BrI 8! X K[zL 
rtn.^HF 可编程界面所在位置：目录
WKvG|YRDq 'DdR2 
P dD, ~N# =}K"@5J 可编程界面所在位置：组件
Dt~ |)L+ AuIg =-xR 
(:r80: 设置表面的定义区域
%0Mvd;#[ Sg+0w7:2 NpAZuISD! •在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。
L ]Y6/Q •在本例中，我们使用圆孔。
<|>7?#s2= •请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！
<$@*'i^7Ez %1Nank!Zj 
B,(zp#&yB 进入可编程界面
),rd7GB> n6C]JWG\/U 
}!9KxwC( X:kr$ 可编程界面：全局参数
I-L:;~. cVf}8qf) * LOUf7` •打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。
x^V9;V@6 •在那里，添加和编辑一个参数：
]t)#,'$^[W - 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。
3 aU WQP2 •使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。
$d\>^Q 提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。
L/KiE+Y ,LodP%%UV 
4apaUP=Jp 0^9%E61Y R 可编程界面：代码段帮助（Snippet Help）
0K' ^g0G .8dlf7* , ; S~ •可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。
PD $'
~2 •此选项对于使用可编程元素跟踪进度非常有用。
yOswqhz •当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！
nsN|[E8 )8&;Q9'o 
EWC{896, <! Z06 
[ f;o3 73kU\ux 可编程界面：编写代码
O48*"Z1 bmQ -5SE 
b <z)4 <44A*ux 可编程界面：用户自定义梯度
%4,v2K D^ )?*( 
yvIzgwN%s! 可编程界面：使用您的代码段（Snippet）
$(fhO 6-Id{m x 
lPZYd 8 b Od<x
>@ 可编程界面的输出
Xrr3KQaK& Pr'Ij 
1n!xsesSc c zg9tG8 此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平）
F[)5A5+:Y >/.w80<' 将自定义界面保存到目录中
0b(x@> -]Y@_T.C 
p6X-P%s $*+IsP! 提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。
+SNjU"x 'h87 A-\!F 故障排除提示
({0:1*lF@ K_ Od u^ 
W2BZG( dm A/!"+Yfw 您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？
S eh(G =/Ph ]f9 
2 9#jKh Q!y% N& _=_<cg y1u 测试代码!
26ae|2 ?
Sjp ]TWj 
vYg>^!Q LYO2L1u) 
