跳轉到

SessionShell

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

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

命令家族

家族 負責什麼 用於
播放 執行程式 —— NC 檔與 NC 字串、CSV 驅動的播放、刀位 (CL) 檔,以及刀具瞬移。另有只解析不自動播放、回傳動作序列的變體。 基礎仿真、刀位 (CL) 播放
播放器控制 對執行中的播放器做節拍、暫停與重置:腳本插進播放流程裡的檢查點。 基礎仿真
解析度與快取 工件實體解析度、加工運動解析度模式、顯示快取大小。腳本對運行時間影響最大的單一因素。 基礎仿真、仿真 CPU 使用率
物理開關 是否評估銑削力、磨耗效應與碰撞檢測;每轉的角度分割數,SessionShell.MillingCycleDivisionNum (API),預設的 36 是給一般模擬用的:窄弧步的開關開著時,接觸窄到 36 分割取樣不夠的步改用 360 取樣,其餘的步分割得更細,平均讀到的峰值力高幾個百分點,也多花計算時間;窄弧步(某條刀刃在一轉裡保持接觸的那一段不到四個分割的切削步)的銑削力要不要在 MillingCycleDivisionNum 低於 360 時改用 360 個分割取樣,SessionShell.EnableNarrowArcFineDivision (API)(預設開,存進專案;每一步保有它播放時的分割數,所以改了之後要重新播放程式);熱模型讀哪一種掃掠弧長,SessionShell.EnableEngagementAngleSweepingArc (API)(預設開;關掉時照取樣的轉角數弧長,EnableNarrowArcFineDivision 也關掉時,溫度與磨耗照這個開關之前的算法讀);初始主軸溫度;失敗或碰撞時是否暫停;回饋模式的兩個開關,SessionShell.EnableChipStockTruncation (API) 與 SessionShell.EnableDeflectionTransformation (API),任務的物理模擬命令執行時會再設一次,所以腳本要排在那個命令下面設。 銑削力參數訓練、幾何驗證
資料匯出 步級 CSV 與波形 (shot) CSV,兩者都接受 [NcName] 樣板。 基礎仿真、銑削力參數訓練
播放結果 把一次播放記錄到結果資料夾 —— 每一步、每個刀具路徑位置、每個程式單節,連同加工完成的素材 —— 列出結果資料夾、刪除一個或刪除未完成的那些,以及不必播放就開啟記錄下來的播放來回顧,之後再關閉回顧。 記錄播放並回顧它
感測器映射 把量測資料擺到仿真結果旁邊:由 CSV 做一對一與序列映射、寫在 NC 註解裡的時間範圍選取,以及清除已映射的資料。 感測器資料映射
訓練 由映射資料訓練銑削係數、校正既有係數,以及把切削參數載入工件。 銑削力參數訓練
優化 優化器的檔案輸出與它整個設定面 —— 進給率與重新插補開關、進給與加減速上限、四個安全係數、目標切削力、豁免特定 NC 行的保留範圍,以及逐步日誌。 NC 優化
幾何 讀取、寫出與匯出網格幾何 (STL / OBJ / PLY)、將切削結果與目標比對、移除斷離殘料,以及掃描缺陷。 幾何驗證、幾何缺陷掃描
訊息 四種訊息嚴重度與檔案匯出,全部經由 ShellProgress。 所有工作流程
步存取 依索引讀取步、回報步總數、註冊自訂步變數與著色樹,以及批次寫入與讀取步的值。 步 (Step)
事件 步被建立或被選取時觸發的逐步掛勾。 NC 優化
運行時管理 清除這次運行的步、網格化的工件、緩衝區與已記錄的訊息,並以 Global 字典在腳本之間傳遞資料。 腳本命令
刀具設置 在運行時調整刀具本體的刃偏移角、刀具在刀把內的安裝角,以及智慧刀把的觀測高度。 智慧刀把訓練

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

  • 刀具設置是為了「對不上」而存在,不是拿來做配置的。 這些成員是為了實際安裝條件偏離已設定刀具的情況。兩者一致時,請改在刀具設定檔裡設定 —— 由腳本設定等於悄悄覆寫了其他人所讀到的值。
  • 幾何家族還認得隱藏的舊名。 WriteRuntimeGeom / ReadRuntimeGeom / ExportRuntimeGeomTo* / ScanRuntimeGeomInfDefect 在既有的播放器腳本中仍可執行,作為 MeshedGeom 新名的別名;新腳本請用新名。完整對照見升級頁的更名表(英文,未鏡像)。
  • 重置運行時會清掉紀錄。 到目前為止的步、網格化的工件與已記錄的訊息都會一併清除;這些訊息若還要用,請在呼叫 ResetRuntime 之前先以 AppendMessagesToFile 匯出 —— 見 ShellProgress。掛在工作階段事件上的處理器不受它影響,要等工作階段結束、也就是播放器「重置」時才會移除。
  • 任務之外,記錄由主機結束。 主機以 PlayNcFile 驅動的播放沒有任務結束:以 BeginNcResultRecording 開始的記錄,在 EndNcResultRecording() 或工作階段結束時完成,兩者都會寫入加工完成的素材;呼叫 LocalProjectService 的 Dispose() 時也會完成,但不寫入素材。由於結束會讀取工件,從主機自己的執行緒呼叫 EndNcResultRecording()——以及記錄開著時的 BeginNcResultRecording——會像工件呼叫一樣在播放器上執行,主機的執行緒等它做完:播放器閒置時,它以單次工作的形式執行,這段期間播放器處於執行中,啟動任務會以 Start--BusyOneShot 拒絕。另一條執行緒正在本工作階段播放 NC 或動作時,它以 MeshedGeomCall--BusyAnotherThread 拒絕,記錄保持開著、什麼都不寫:等那次播放結束後再呼叫一次。請勿在帶有 SynchronizationContext 的執行緒(例如 UI 執行緒)上、或在播放器的 IsRunningChangedEvent、IsLockedChangedEvent、ResetedEvent 處理器裡呼叫:它會在那裡等一件可能正需要這條執行緒的工作。

延伸閱讀