如何使用可编程界面及示例（球面）

为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。

可编程界面所在位置：目录

提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。

可编程界面所在位置：组件

编写代码

•右侧面板显示了可用的独立参数列表。
•x和y表示独立变量，即平面上的2D坐标。
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
•使用Snippet Body将支持函数中的部分代码分组。

提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。

表面梯度的定义

•精确计算界面的梯度是光学仿真的基础。
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。

用户自定义的表面梯度

•右侧面板显示了相同的可用独立参数列表。
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！

可编程界面的输出

•输出是3D表面，其可用于定义系统中实际光学组件的界面。
•在有需要时，可在实际组件内直接编程自定义界面。
•或者，将其保存在目录中供后续使用。

对球形表面进行编程
    球形表面

可编程界面所在位置：目录

可编程界面所在位置：组件

设置表面的定义区域

•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。
•在本例中，我们使用圆孔。
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！

进入可编程界面

可编程界面：全局参数

•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。
•在那里，添加和编辑一个参数：
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。