ye4GHAm,p 为您的
光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该
函数是在
参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置
系统中的光学组件。在
VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本
教程中，我们使用球面作为简单的
编程示例。
8,)<,g-/= e8k|%m<Sp 
Y 9BKd78Y 可编程界面所在位置：目录
9e;:(jl^ +*wo iSD 
C-^8;xd 提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。
?' ,GR aD Y,-! QFS# 可编程界面所在位置：组件
Xj<xen( <ti,W n. 
./ CD W :,.HJ[Vg& FMT_X 编写代码
* b"aJ<+ JHJ]BMm q<cxmo0S •右侧面板显示了可用的独立参数列表。
nHQWO
•x和y表示独立变量，即平面上的2D坐标。
!HF<fn •由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。
%kuUQ %W1 •主函数中的代码必须每x，y点返回一个双
精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
A H^ud*3F •使用Snippet Body将支持函数中的部分代码分组。
`6v24?z 5
axt\ 
n9V 8A[QJ cEK#5 提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。
"71Y{WQ D&D- E~b^ 表面梯度的定义
n
m .5!. Q5*"t*L!N !z]{zM % •精确计算界面的梯度是光学仿真的基础。
%
"^CrG •VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由
软件自动执行）或解析模式（由用户另外编程）。
p\tA&>3- 
4XSq\.@G !y3XIbdS" 用户自定义的表面梯度
pbG v\S F fbJa$ m>!aI?g •右侧面板显示了相同的可用独立参数列表。
rE?B9BF3O •该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。
I:YE6${k! •尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！
dlMjy$/T )+f"J$ah 
p@wtT"Y _!%@V= 可编程界面的输出
1|$J> 9jllW[`2F 2>m"CG •输出是3D表面，其可用于定义系统中实际光学组件的界面。
$I9U.~* •在有需要时，可在实际组件内直接编程自定义界面。
z h%b< •或者，将其保存在目录中供后续使用。
%:7/ym[ d26#0Gt-4i 
Gg%pU +'T J!yK/*sO, 2 nSK}q g>{t>B%v^K z\Z +>A
&0OH:P% 对球形表面进行编程
q'% !qa+ 球形表面
U :8cz=# m[Qr>= " 
b6'ZVB 可编程界面所在位置：目录
5T r c#i<\ y .a)M?3 
x6Q_+!mnk sfsK[c5bm 可编程界面所在位置：组件
#y1M1O g Rj-4K@a8#N 
y4Nam87;/? 设置表面的定义区域
Ee=!bv(%70 H:o=gP60] \mw5
~Rf; •在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。
h2
>a_0" •在本例中，我们使用圆孔。
t!0 IQ9\[* •请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！
|j 4;XaG) 0I*{CVTQj 
'N/u< `) 进入可编程界面
;p:CrFv th+LScOX 
c\rP"y|S}; EH]qYF. 可编程界面：全局参数
&& WEBQ v=-T3
n 3 *eS<n[uG •打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。
;Eh v1{; •在那里，添加和编辑一个参数：
$Eo-58<q - 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。
{Vf].l:kn •使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。
P#AS")Sj i \@a&tw 可编程界面：代码段帮助（Snippet Help）
O*c<m, H)5" <=] Q 2 B •可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。
,6x>gcR •此选项对于使用可编程元素跟踪进度非常有用。
;;Jx1Q •当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！
:%IB34e =@MJEo` D 
aX.//T:':? `Cz_^>]|= 
,m5tO R HmT$^= 可编程界面：编写代码
1}OM"V = lx~tSiS 
^_uCSA'X ZN!<!"~ 可编程界面：用户自定义梯度
'v5q/l yE R 
|q
Pu*vR 可编程界面：使用您的代码段（Snippet）
k!d<2Qp W rf]x5%ij 
p+${_w>pl{ gN[^ ,u 可编程界面的输出
c;88Wb<|W wM! dz& 
]aYuBoj h/*@ML+bB8 此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平）
?B <.d8i S(_DR 8 将自定义界面保存到目录中
)g`~,3G X5+$:jq& 
N: 5 N}am dyB@q h~H 提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。
LXf| n j)#GoU=w 故障排除提示
i_av_ I- }l_8~ /9 
f 0*_& rP Qki?
>j" 您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？
593!;2/@ 877Kv); 
*TPWLR ^ I^G6aw %I@ vM s^ 测试代码!
ul!q)cPb{ \ !IEZ 
AsI. 8" N3w y][bo 
