Creo Elements/Direct Modeling 巨集設定：Lisp 載入、自動載入與出錯檢查

Creo Elements/Direct 的巨集能做什麼

PTC 文件說，Creo Elements/Direct Modeling 的指令、對話框與介面控制都是在 Lisp 層撰寫， Integration Kit 提供進入這一層的方式。巨集可以做的事例如：

• 把多個固定步驟串成一個指令，例如出圖、存檔、輸出
• 建立自己的對話框，選取零件、輸入數值後一次完成
• 批次填寫或讀取零件屬性，例如料號、材質
• 整理 BOM、依規則命名與分資料夾

做好的巨集會跟原生指令一樣在軟體裡操作，使用的人不需要懂程式。

巨集怎麼載入：指令輸入區用 (load)

Creo Elements/Direct Modeling 的指令輸入區（提示文字是 Enter Command）可以直接輸入 Lisp。 Lisp 原始檔的慣例是以 .lsp 結尾，載入時輸入，例如：

(load "C:/tools/macros/my_tool.lsp")

• 路徑用正斜線 /：PTC 文件的範例，包括 Windows 的安裝路徑 C:/Program Files/PTC/…，都是這樣寫
• (load) 只載入到目前這次開啟的軟體，下次開啟不會自動載入；要每次自動載入，見下面的自訂檔
• 載入後，巨集提供的指令或對話框就能使用；Dialog Generator 做的對話框也可以在輸入區直接輸入名稱呼叫

第一個自訂指令：Recorder 與 sd-defdialog

Integration Kit 文件建議的起步方式：

1. 開著 Recorder，在軟體裡手動做一次要自動化的步驟，用到的指令會寫進 Recorder 檔
2. 想好要讓使用者輸入什麼
3. 從文件的範例裡找最接近的一個複製來改
4. 把 Recorder 檔的內容複製到程式裡，當成要執行的動作
5. 把輸入變數和動作組起來，載入軟體

文件中的基本範例 my_extrude 用 sd-defdialog 定義一個對話框：輸入零件、工作平面與距離（預設 42）， 按 OK 時用 sd-call-cmds 執行 extrude。對話框可以從 toolbox 的按鈕或自訂的 ribbon 分頁執行， 也可以在輸入區直接輸入 my_extrude 呼叫。18.0 起，要出現在 toolbox 的對話框必須在定義裡加:toolbox-button t。完整程式碼見 PTC 的Creating a User Defined Command。

每次開啟都自動載入：sd_customize 與四層自訂目錄

要讓巨集每次開啟都能用，把 (load …) 寫進自訂檔。主自訂檔是 sd_customize（沒有副檔名，不是 .lsp），啟動時會讀取以下四層目錄裡的 sd_customize（英文版、20.9 的說明）：

• Corp 和 Site 是選用的，沒設系統變數就不會讀
• 德、義、法、西、日文版的原廠目錄是 personality 下的語言子資料夾
• 在個人層的 sd_customize 加一行 (load …) 指向巨集檔，之後每次開啟都會載入
• 自訂檔的 Lisp 寫錯（例如少了右括號、字串沒有收尾），啟動時會出現 LISP error，檢查方式見下面的表；修改前先備份

要確認實際用到哪些資料夾：File > Settings > UI，在 Customizations 分頁按 Show Directories， 會在輸出對話框顯示自訂目錄與位置。要看啟動時從哪個目錄載入了哪些自訂檔，用 -v 參數啟動，主控台視窗會列出。

全公司共用：SDSITECUSTOMIZEDIR

• 把 sd_customize 與巨集放在共用資料夾，每台電腦把系統變數 SDSITECUSTOMIZEDIR 設成那個資料夾， 大家啟動時都會讀同一處；更新時換共用資料夾裡的檔案
• 個人層（User）的設定可以覆蓋 Site、Corp、SD 層，同事各自改過的設定，可能讓共用版看起來沒生效
• 使用者在畫面上調整介面時自動產生的自訂檔，可以複製到 Site 或 Corp 目錄給大家共用
• 不同版本並存時，可以把系統變數 SDVERSIONDEPCUSTOMIZEDIRS 設為 1，Site 目錄就改讀 $SDSITECUSTOMIZEDIR/20.9 這種依版本分的子資料夾（資料夾必須先建立）
• 保留一份簡單的清單：每個巨集做什麼、誰負責、最後修改日期
• 升級軟體版本前，先挑一台電腦把在用的巨集都跑過一次

升級或換電腦後巨集出錯，先檢查這些

Lisp 自訂從 SolidDesigner Rev.4 的 Integration Kit 就有。下表是 PTC 文件列出、會讓舊程式出錯的情況：

另外兩個跟環境有關的檢查方向：

• 路徑：巨集裡指定的資料夾或伺服器位置，換電腦或換版本後不存在
• 載入順序：幾個巨集互相依賴，但載入的先後順序不對，用到的函式還沒定義
• 只剩編譯過的檔案：原廠的 Lisp 編譯會把可讀的程式轉成二進位碼，無法直接修改； 編譯檔只在同一個主版本內相容，換主版本要有原始 .lsp 才能重新編譯，原始碼遺失時只能依操作行為重新製作

各版的不相容變更，整理在CoCreate 舊巨集維護的盤點清單。

需要更進一步時

前人留下的巨集沒有文件、升級後大量出錯，或想把出圖、BOM、屬性填寫做成全公司共用的工具，見Creo Elements/Direct Modeling 巨集・二次開發與CoCreate 舊巨集維護。

參考資料：PTC Creo Elements/Direct Modeling 20.9 Integration Kit（英文）Introduction、The ME Macro Programmer's Introduction to Lisp、Creating a User Defined Command、Customization Guide for Administrators and Advanced Users、Unicode and String Processing、What's New、Command Syntax Changes and Enhancements、Advanced Topics； Creo Elements/Direct Modeling 20.9 說明Change UI settings； PTC 日本官方部落格2DCAD ME10・3DCAD ME30 から Creo 誕生までの歴史（Rev.4 起有 Integration Kit）。