跳轉到

SessionShell

SessionShell (API) 是 HiNC 腳本引擎的全域作用範圍：腳本直接以名稱使用它的成員，不需要物件參考、也不需要 using。腳本能對一個工作階段做的每一件事 —— 啟動播放、設定解析度、匯出檔案、訓練係數、讀取步 —— 都是這一個型別的成員。

命令、屬性與事件的完整且最新清單，是自動產生的 SessionShell API 參考。本頁是對照到它的地圖 —— 哪個家族負責什麼、哪個工作流程會用到。這裡刻意不再重列成員：手抄的 API 清單在 API 一改動就開始漂移，而且沒有任何建置檢查抓得到。

命令家族

家族 負責什麼 用於
播放 執行程式 —— NC 檔與 NC 字串、CSV 驅動的播放、刀位 (CL) 檔，以及刀具瞬移。另有只解析不自動播放、回傳動作序列的變體。 基礎仿真、刀位 (CL) 播放
播放器控制 對執行中的播放器做節拍、暫停與重置：腳本插進播放流程裡的檢查點。 基礎仿真
解析度與快取 工件實體解析度、加工運動解析度模式、顯示快取大小。腳本對運行時間影響最大的單一因素。 基礎仿真、仿真 CPU 使用率
物理開關 是否評估銑削力、磨耗效應與碰撞檢測；每轉的角度分割數；初始主軸溫度；失敗或碰撞時是否暫停。 銑削力參數訓練、幾何驗證
資料匯出 步級 CSV 與波形 (shot) CSV，兩者都接受 [NcName] 樣板。 基礎仿真、銑削力參數訓練
感測器映射 把量測資料擺到仿真結果旁邊：由 CSV 做一對一與序列映射、寫在 NC 註解裡的時間範圍選取，以及清除已映射的資料。 感測器資料映射
訓練 由映射資料訓練銑削係數、校正既有係數，以及把切削參數載入工件。 銑削力參數訓練
優化 優化器的檔案輸出與它整個設定面 —— 進給率與重新插補開關、進給與加減速上限、四個安全係數、目標切削力、豁免特定 NC 行的保留範圍，以及逐步日誌。 NC 優化
幾何 讀取、寫出與匯出網格幾何 (STL / OBJ / PLY)、將切削結果與目標比對、移除斷離殘料，以及掃描缺陷。 幾何驗證
訊息 四種訊息嚴重度與檔案匯出，全部經由 ShellProgress。 所有工作流程
步存取 依索引讀取步、回報步總數，以及註冊自訂步變數。 步 (Step)
事件 步被建立或被選取時觸發的逐步掛勾。 NC 優化
運行時管理 清除這次運行的步、網格化的工件、緩衝區與已記錄的訊息，並以 Global 字典在腳本之間傳遞資料。 腳本命令
刀具設置 在運行時調整刀具本體的刃偏移角、刀具在刀把內的安裝角，以及智慧刀把的觀測高度。 智慧刀把訓練

自動產生的參考不會告訴你的三件事

  • 刀具設置是為了「對不上」而存在，不是拿來做配置的。 這些成員是為了實際安裝條件偏離已設定刀具的情況。兩者一致時，請改在刀具設定檔裡設定 —— 由腳本設定等於悄悄覆寫了其他人所讀到的值。
  • 幾何家族還認得隱藏的舊名。 WriteRuntimeGeom / ReadRuntimeGeom / ExportRuntimeGeomTo* / ScanRuntimeGeomInfDefect 在既有的播放器腳本中仍可執行，作為 MeshedGeom 新名的別名；新腳本請用新名。完整對照見升級頁的更名表（英文，未鏡像）。
  • 重置運行時會清掉紀錄。 到目前為止的步、網格化的工件與已記錄的訊息都會一併清除；這些訊息若還要用，請在呼叫 ResetRuntime 之前先以 AppendMessagesToFile 匯出 —— 見 ShellProgress。掛在工作階段事件上的處理器不受它影響，要等工作階段結束、也就是播放器「重置」時才會移除。

延伸閱讀