附件下載

聯(lián)系工作人員獲取附件

介紹

OpticStudio提供了一個用于導入CODE V設計的擴展工具。這個擴展旨在取代和改進傳統(tǒng)的ZPL宏（CodeV to OpticStudio Converter.ZPL）。若要導入一個CODE V設計，必須將其保存為基于文本的SEQ文件。通過逐行讀取CODE V命令，轉換器可以在OpticStudio中動態(tài)重建設計。該擴展還提供了一個界面，可以一個接一個地直接輸入命令來構建或修改設計。需要注意的是，并非所有CODE V命令和功能都完全支持這個擴展。

安裝擴展

安裝前，請先關閉OpticStudio。然后將附件中的文件解壓到\Zemax\ZOS-API\Extensions中。確保CODEV Converter.exe?位于該文件夾的根目錄。啟動OpticStudio后，您將在用戶擴展列表中看到CODE V轉換器。

轉換設計的過程

將CODE V設計導出為文本格式的SEQ文件后，您可以在OpticStudio的“編程”選項卡上訪問該擴展工具:

打開擴展后，您將看到主界面。要完成轉換，只需導航到SEQ文件并點擊轉換系統(tǒng)。轉換過程中有幾個選項可供選擇：

1.轉換擴展現(xiàn)在提供了更詳細和格式化的輸出HTML文件。如果勾選了“Show Summary”,則轉換完成后HTML摘要將自動打開。

2.如果您勾選“Real-Time Updates”選項將在轉換執(zhí)行過程中實時顯示OpticStudio中的變化。如果未勾選此選項，則轉換完成后才會顯示導入的系統(tǒng)。

3.通常在轉換過程中，OpticStudio中的當前系統(tǒng)會被刪除，SEQ命令將創(chuàng)建一個新系統(tǒng)。但是，如果您有一個SEQ文件，其中的命令您想要修改當前系統(tǒng)（而不是先刪除它），那么勾選“Import to Current Design”選項將對當前系統(tǒng)進行修改。

4.“自動關閉”選項將在轉換成功完成后自動關閉轉換器。

轉換完成后，工具將生成一個詳細的轉換報告（如下所示），作為HTML文件輸出。報告中顯示了轉換信息以及執(zhí)行過程中記錄的錯誤和警告。報告開頭還有一個摘要，包括失敗命令的數(shù)量或未識別命令的數(shù)量等指標。

批處理SEQ文件處理

集成的用戶擴展包括批處理功能，可以一次轉換多個SEQ文件。這也可以顯著快于作為用戶擴展運行，因為它不需要與OpticStudio GUI交互。要使用此功能，您需要從OpticStudio外部調用它。有兩種模式的選項：

1、運行CODE V Converter.exe，一旦您運行應用程序，您將看到一個彈出窗口，要求您導航到單個SEQ文件或目錄。要切換轉換單個SEQ文件或目錄，只需取消勾選/勾選“Directory of Files”選項。

2、使用Windows命令行，您可以將轉換器作為自動化腳本的一部分來調用。轉換器最多接受三個參數(shù)。第一個參數(shù)必須始終是"-convert "，后面跟著SEQ文件(帶完整路徑)或包含多個要轉換的SEQ文件的目錄路徑。最后，如果您的計算機上安裝了多個版本，最后一個可選參數(shù)可以指定您要使用的OpticStudio版本的Program Files目錄。

“CODE V Converter.exe” -converter [file/folder path] [optional: OpticStudio path]

以下是一些使用示例：

“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命令行(或使用列出的參數(shù))打開該工具，它會在轉換完成后自動關閉。每次轉換都會報告其進度，并會提示您轉換是成功還是失敗，如屏幕截圖所示。

附錄

當前支持的命令列表

下表顯示了轉換器當前支持的命令。請注意，即使該命令被列為支持，也可能有不支持的命令參數(shù)情況也可能有命令參數(shù)或情況不受支持。如果您希望與我們分享有關如何導入命令或您收到的錯誤的信息，請聯(lián)系我們工作人員。