转换CODE V文件到OpticStudio文件(Convert CODE V to OpticStudio)
选择该功能将调用一个自定义扩展。自定义扩展可用于将采用Code V生成的*.SEQ文件转换成可供OpticStudio读取的格式。首先会弹出一个界面，要求用户输入要转换的输入*.SEQ文件的名称。该名称必须包含找到文件所使用的完整路径；界面左下角的浏览（Browse）按钮可用于直接导航至包含该文件的文件夹，以便直接选择文件。
选择文件并开始转换过程后，将出现一个窗口，询问您是否要保存当前的光学系统。
自定义扩展转换选项（User Extension Conversion Options）
- 如果未选中显示概要（Show Summary），概要HTML文档将不会自动显示，但会被保存。如果选中显示概要，HTML概要将在转换完成后自动打开。
- 如果未选中实时更新（Real-Time Updates），则不会显示光学系统的实时更新。如果选中实时更新，将显示实时更新，反映镜头数据编辑器（LDE）、多重结构编辑器（MCE）和系统选项（System Explorer）中的更改。
- 如果未选中导入到当前设计（Import to Current Design），系统将从空白状态开始，并将所有选定的参数导入到新系统中。如果选中导入到当前设计，则导入的参数将附加到现有系统。
- 如果未选中自动关闭（Autoclose），转换器界面将保持打开。如果选中自动关闭，转换器界面将自动关闭。
ZMX文件会在转换过程结束时自动保存，默认保存位置设置为与转换后的Code V文件相同的文件夹。
在将非常普通的文件转换为复杂程度适中的文件时，自定义扩展的运行效果通常很好，但可能无法完全转换极为复杂的文件。转换功能目前支持的功能列表主要基于转换*.SEQ文件中所列的以下操作数：
支持Code V命令的列表
| 常规（General） | |
|---|---|
| ! | 注解行 |
| LEN | 新透镜数据初始化 |
| GO | 更新系统 |
| RDM | 替代曲率的半径模式 |
| 系统选项（SYSTEM EXPLORER） | |
|---|---|
| WL | 要求波长以nm为单位 |
| WTW | 波长权重 |
| REF | 参考波长编号 |
| TITLE、TIT | 镜头系统标题 |
| INI | 设计者姓名的大写字母 |
| EPD | 入瞳直径 |
| FNO | 像空间光锥F/# |
| NAO | 物空间数值孔径 |
| DIM | 强制变更单位 |
| DDM | 默认尺寸I-英寸、C-厘米、M-毫米 |
| XIM | 视场(Field)：X近轴像高（Field: X Paraxial Image Height） |
| YIM | 视场(Field)：Y近轴像高(Field: Y Paraxial Image Height) |
| XAN | 物空间的X角（度） |
| YAN | 物空间的Y角（度） |
| XOB | 视场(Field)：X物高(Field: X Object Height) |
| YOB | 视场(Field)：Y物高（Field: Y Object Height） |
| XRI | 视场(Field)：X实际像高(Field: X Real Image Height) |
| YRI | 视场(Field)：Y实际像高（Field: Y Real Image Height） |
| WTF | 视场权重 |
| VLX | 入瞳半径裁剪部分（-X方向） |
| VLY | 入瞳半径裁剪部分（-Y方向） |
| VUX | 入瞳半径裁剪部分（+X方向） |
| VUY | 入瞳半径裁剪部分（+Y方向） |
| 镜头数据编辑器（LENS DATA EDITOR） | |
|---|---|
| S | 增量面指示器 |
| SO | 物面表面定义 |
| SI | 像面表面定义 |
| STO | 将表面指定为光阑面 |
| INS | 面插入（面的专用格式） |
| THI | 厚度插入（面的专用格式） |
| RDY | 半径插入（面的专用格式） |
| CUM | 镜面基面背面曲率指示器 |
| THM | 镜面基板的厚度 |
| SPH | 球面面型 |
| SPS |
将面型设置为特殊形状 ZRN – Standard Zernike QBF – Q型非球面 QCN – Q型非球面 ZFR – Fringe Zernike |
| SCO | 特殊表面操作数 |
| GLA | 玻璃插入（面的专用格式） |
| GL1 | 玻璃描述，表面1 |
| GL2 | 玻璃描述，表面2 |
| RMD | 反射/折射模式指令 |
| CIR | 设置孔径半直径 |
| ADX | X方向孔径偏心 |
| ADY | Y方向孔径偏心 |
| REX | 矩形孔径的X向半宽 |
| REY | 矩形孔径的Y向半宽 |
| SLB | 给面加一个标签（在ZOS中：注解栏） |
| PIM | 近轴像距离求解 |
| CCY | 面曲率控制（旋转对称） |
| THC | 厚度结组控制 |
| ADC | X轴关联组倾斜控制 |
| BDC | X轴关联组倾斜控制 |
| CDC | Z轴关联组倾斜控制 |
| XDC | X关联组偏心控制 |
| YDC | Y轴关联组偏心控制 |
| CYL | Toroidal面 |
| XTO | XToroid面 |
| YTO | Y Toroid面 |
| ASP | 偶次非球面表面 |
| A | 4阶系数 |
| B | 6阶系数 |
| C | 8阶系数 |
| D | 10阶系数 |
| E | 12阶系数 |
| F | 14阶系数 |
| G | 16阶系数 |
| H | 18阶系数 |
| J | 20阶系数 |
| CON | 圆锥系数面型（通常后跟"K"操作数） |
| K | 圆锥系数值（通常在操作数"CON"之后） |
| GRO | 光栅级次 |
| GRS | 光栅间隔 |
| GRT | 光栅面型 |
| DIF | 指定衍射面型（2字命令） |
| HOE | 全息面 |
| HV1 | 第1结构点的类型 |
| HV2 | 第2结构点的类型 |
| HOR | 全息衍射级次 |
| HWL | 结构波长（全息图） |
| HX1 | 第1结构点的X坐标 |
| HX2 | 第2结构点的X坐标 |
| HY1 | 第1结构点的Y坐标 |
| HY2 | 第2结构点的Y坐标 |
| HZ1 | 第1结构点的Z坐标 |
| HZ2 | 第2结构点的Z坐标 |
| HCT | 多项式或全息图信息 |
| HCO | 非球面相位 |
| HCC | 全息图变量控制 |
| DIF | 2词操作数的第一部分（例如DIF GRT） |
| RET | 坐标返回的求解：方位XYZ |
| GLB | 全局坐标数据参考 |
| ADE | X轴倾斜 |
| BDE | Y轴倾斜 |
| CDE | Z轴倾斜 |
| XDE | X偏心 |
| YDE | Y轴偏心 |
| ZDE | Z轴偏心 |
| BEN | 镜面偏心和偏转 |
| DAR | 偏心并返回操作数 |
| LIBRARIES | |
|---|---|
| PRV | 自用玻璃库的起点端 |
| PWL | 自用玻璃库的波长 |
| END | 定制玻璃库的描述截止 |
| HAR | 哈特曼（Hartmann）色散公式 |
| LAU | Laurent色散公式 |
| GML | 玻璃制造商Laurent色散公式 |
| GMS | 玻璃制造商Sellmeier色散公式 |
| SLM | Sellmeier色散公式 |
| CAU | 柯西色散公式 |
| 多重结构编辑器 | |
|---|---|
| ZOO | 变焦位置 |
| TIT | 标题（按结构） |
| EPD | 入瞳直径 |
| FNO | F/#系统孔径值 |
| CIR | 环形孔径 |
| ADE | X轴倾斜 |
| BDE | Y轴倾斜 |
| CDE | Z轴倾斜 |
| XDE | X方向偏心 |
| YDE | Y方向偏心 |
| ZDE | Z方向偏移 |
| THI | 厚度 |
| CUY | 表面的曲率 |
| WL | 波长（不支持特定结构） |
| REF | 主波长编号 |
| WTW | 波长权重 |
| WTF | 视场权重 |
| XAN | 物空间的X角（度） |
| XIM | 视场(Field)：X近轴像高（Field: X Paraxial Image Height） |
| XOB | 视场(Field)：X物高(Field: X Object Height) |
| XRI | 视场(Field)：X实际像高(Field: X Real Image Height) |
| YAN | 物空间的Y角（度） |
| YIM | 视场(Field)：Y近轴像高(Field: Y Paraxial Image Height) |
| YOB | 视场(Field)：Y物高(Field: Y Object Height) |
| YRI | 视场(Field)：Y实际像高(Field: Y Real Image Height) |
| GLA | 玻璃材料(Glass) |
| GL1 | 玻璃描述，表面1 |
| GL2 | 玻璃描述，表面2 |
| RMD | 反射/折射模式指令 |
| VLX | 入瞳半径裁剪部分（-X方向） |
| VLY | 入瞳半径裁剪部分（-Y方向） |
| VUX | 入瞳半径裁剪部分（+X方向） |
| VUY | 入瞳半径裁剪部分（+Y方向） |
*.SEQ文件的任何其它操作数都不能转换，因此必须小心确保已转换的输入文件的正确性。对转换*.SEQ文件额外操作数的支持将在未来宏自定义扩展版本中添加。
- 如果*.SEQ文件包含上面未列出的任何操作数，HTML报告中的转换完成 - 不支持/无法识别的命令（Conversion Complete - Not Supported / Unrecognized Commands）部分将显示一条消息，总结每个无法识别的操作数。
- 如果*.SEQ文件包含转换过程中失败的任何操作数，HTML报告中的转换完成 - 失败的命令（Conversion Complete - Failed Commands）部分将显示一条消息，总结每个失败的操作数。
输入的*.SEQ文件必须符合一些基本要求才能转换，例如文件必须至少包含3个面（允许在OpticStudio中定义OBJECT、STOP和 IMAGE面）。如果您发现*.SEQ文件中有任何不受支持的操作数，请通过www.ansys.com/support向Ansys客户支持空间（Ansys Customer Support Space）发送电子邮件。这将有助于我们增强对OpticStudio和转换器未来版本的转换支持。
孔径边界限制（Aperture Boundary Limitation）：孔径形状和边界条件的选择目前仅限于预定义的选项（例如，圆形、矩形），这可能会限制自定义形状的使用。这种限制是由于两种软件之间孔径堆叠顺序的差异造成的。在大多数情况下，最后定义的孔径将被转换成转换后的设计。对于Code V中的复杂孔径配置，用户可以考虑使用用户定义的孔径进行转换。
批量SEQ文件处理（Batch SEQ File Processing）
- 只需导航到Documents\Zemax\ZOS-API\Extensions下的Zemax目录，即可运行CODE V Converter.exe。运行该应用程序后，您将看到一个弹出窗口，要求您导航到SEQ文件或目录。要在转换单个SEQ文件或目录之间进行更改，只需取消选中或选中文件目录（Directory of Files）选项。
使用Windows命令行，您可以将转换器作为自动脚本的一部分进行调用。转换器最多接受三个参数。第一个参数必须始终是
-convert，后跟SEQ文件（带完整路径）或包含多个要转换的SEQ文件的目录路径。最后，如果您的计算机上安装了多个版本，最后一个可选参数可以指定您要使用的OpticStudio版本的程序文件目录。以下是几个使用示例："CODE V Converter.exe" -converter "C:\CODE V Files\test.seq" "CODE V Converter.exe" -converter "C:\CODE V Files" "CODE V Converter.exe" -converter "C:\CODE V Files" "C:\Program Files\Ansys Zemax OpticStudio 2024 R2.02"
转换后的文件（以及概要报告）将与SEQ文件保存在相同的目录中。如果从Windows命令行（或使用列出的参数）打开该工具，则转换完成后，它将自动关闭。每次转换都会报告其进度，并让您知道它是失败还是成功，如截图所示。
下一部分：