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處理器裡呼叫:它會在那裡等一件可能正需要這條執行緒的工作。
延伸閱讀¶
SessionShell完整 API 文件 — 本頁所對照的自動產生參考- 腳本命令 — 命令所處的語法與生命週期
- 步 (Step) — 步存取家族回傳的資料模型
- ShellProgress — 訊息家族寫入的訊息主體