跳轉到

應用程式視窗 (The Application Window)

每個畫面外面都圍著同一個框架:頂端橫著一條選單列,中間是目前的頁面,底部橫著一條頁尾。框架只建立一次,整個工作階段都保持掛載,所以本頁描述的每樣東西在每個頁面上都在。專案變更是唯一會伸進框架裡、把中間所持有的內容重建的事件。

下圖是開著示範專案時位於 /execution 的整個框架。亮著的執行切換鈕指出了這一頁;右側那一組裡,只有欄快速切換鈕與連線標記是因為底下那一頁才出現的——標誌、三個下拉選單與頁面切換鈕不論開著哪一頁都在列上,而登出按鈕的有無取決於是否要求登入,而不是取決於頁面。最底下那一條是頁尾,寫著就緒,因為還沒有任何東西被回報。

執行前、位於應用程式框架內的執行頁:選單列帶著品牌標誌、版本標記、「檔案」、「偏好設定」、「說明」與四個頁面切換鈕——其中「執行」亮著——右端 LEFT、Center-Top、Center-Down、STEP 四顆都亮著,接著是綠色的「已連線」與登出;左側是控制樹與傳輸,綠色「就緒」徽章;中央 3D 渲染畫布畫著未切削的方塊,比例尺 15.5 mm,下面的工作階段資訊面板開在「視覺指標」,圖上讀著沒有任務資料,左下角是「時間 (s)」;右側步資訊欄的「單節資訊」與「步屬性」都說沒有選取;頁尾一行寫著「就緒」

選單列

從左邊數起:品牌標誌、版本標記、「檔案」、「偏好設定」與「說明」三個下拉選單,以及頁面切換鈕。版本標記寫著 v 加上執行中的版本,取自服務對自身的回覆,而不是來自專案裡的任何東西,所以專案還沒開啟它就已經帶著版本號;回報不出版本的服務會讓這個位置留白。在已安裝的 HiNC 上,它同時也是更新標記:它的顏色與圖示跟著更新狀態走——還沒檢查過、連不上更新伺服器,以及下載失敗正等著重試時是灰色;已是最新版本時是綠色並帶勾號;有較新的版本可用、正在下載、等著套用,或正在重新啟動為新版本時是橘色;執行中的版本已被撤回時是紅色——而它的工具提示會說明是哪一種。不論在哪種狀態,點一下都會打開軟體更新;在 Windows 上更新 HiNC逐步說明這個對話框。網頁服務單獨執行時——例如在伺服器上——這個標記就只標出版本:灰色外框,沒有其他狀態,也沒有工具提示,點一下也沒有任何作用。登入畫面上完全不畫這條列——登入卡改在它的標誌底下帶著一個版本標記。

「說明」收著服務自己提供的兩份參考資料,以及分隔線下方的日誌檢視器——網頁服務單獨執行時,它就是選單的最後一個項目;已安裝的 HiNC 則在它後面再加上檢查更新…,這一項打開的是和版本標記同一個軟體更新對話框,最後是授權…。授權…說明這份 HiNC 由什麼授權——它的 Sentinel 授權鎖(授權鎖版另有更新授權(開啟網站)),或它登入的雲端帳號——方案、帳號驗證、步數額度與下次同步——這時對話框也有使用資料與隱私、改在別台使用與登出按鈕(見用雲端帳號登入)。每份參考資料都在新的瀏覽器分頁開啟,所以眼前的頁面保有它的狀態:說明文件是本指南所對應的英文文件網站,位於 /HiAPI-docsite/;API 參考(Swagger)則是服務 REST 介面的 Swagger 頁面,位於 /swagger/index.html——見透過 HTTP 驅動網頁服務(英文,未鏡像)。兩者都來自視窗正在交談的同一個服務,也都不要求登入。日誌檢視器在這兩點上都不同:它是應用程式的一個頁面,讀的是服務自己當天的日誌檔——它是支援用的工具,不是現場作業用的,所以放在這裡而不放在列上——因此它在原處開啟,位於 /preference/log,並且和其他每個畫面一樣在同一道登入之後。見訊息與日誌。

頁面切換鈕是由四個按鈕組成的一個分段控制項——刀具庫、設備與執行依一件工作使用它們的順序排列,接著是檔案總管——畫面上那一頁的切換鈕是亮著的。按下亮著的切換鈕什麼也不做。其他幾個是連結,所以按滑鼠中鍵或 Ctrl 點擊,會在新分頁開啟那一頁。每一個通往這四頁之一的網址都會點亮它的切換鈕——?tree= 選取、瀏覽中的資料夾,以及重新導向進某棵樹的舊網址都算在內——而在沒有切換鈕的日誌檢視器上,沒有任何一個亮著;列上也沒有任何東西指出那一頁,它的標題在它自己的標題列裡。

列的其餘部分推到右側,依下列順序呈現,連線標記與登出按鈕之前各有一道分隔線:

  • 欄快速切換鈕 — 目前頁面實際顯示幾個部分,就有幾個按鈕,出現在三個樹頁面上。執行頁四個;和每一顆快速切換鈕一樣,它們上面沒有文字,本手冊依各自填滿的頁面部分,稱它們為 LEFT、Center-Top、Center-Down 與 STEP。它們的工具提示依序是切換控制樹/編輯器停靠欄、切換 3D 渲染畫布、切換工作階段資訊面板、切換步驟資訊欄。Center-Top 與 Center-Down 可以單獨開;兩個都關時中欄不畫出來。設備頁四個(控制樹、編輯器、畫布、拓樸),刀具庫也是四個(刀具清單、控制樹、編輯器、刀具畫布),刀具庫顯示圖面檢視、把後三欄換掉時,後三個會變灰。每個圖示都是一幅頁面的小地圖,把自己那一部分塗滿;每個工具提示都寫出它所切換的東西。
  • 連線標記 — 只在執行頁上。見下文。
  • 雲端徽章 — 只在用雲端帳號登入的已安裝 HiNC 上,每一頁都有,前面自帶一道分隔線:方案與授權同步了沒(離線時帶還能用的分鐘數、已暫停、授權已到期、在另一台使用中、需要同意條款、未登入)。點一下打開授權…對話框。見用雲端帳號登入。
  • 登出按鈕 — 以已登入的使用者名稱作為標籤,服務沒有名稱可給時則寫作登出。只有在服務要求登入、且這個瀏覽器已通過登入時它才會在。它讓這個瀏覽器登出服務;雲端版的 HiNC 要登出雲端帳號,則是用 「說明」›「授權…」›「登出」。

頁面區

兩條列之間的一切就是目前的頁面,而工作階段中到過的每一頁都保持建好的狀態:沒有上限,也沒有任何頁面被排除在外。回到某一頁時,它的元件狀態、改到一半的編輯,以及已建立的渲染連線,都和離開時一模一樣。

有兩樣東西不會帶過去。面板內的捲動位置不會被還原:回到某一頁時,它的面板會捲到全新掛載時的位置。而瀏覽器重新整理不是一次導覽——它會重建整個應用程式並清空快取;能撐過去的是活在頁面區之外的東西:網址(包括其中的 ?tree= 選取)、瀏覽器替自己保存的版面配置——執行頁的也在內:是否顯示 3D 畫布、顯示哪些工作階段資訊分頁、開著的是哪一個——以及服務所持有的偏好設定:語言、顯示物理選項,以及執行頁的工作階段資訊面板與步屬性面板是否開著、它的哪幾張週期圖展開著。

欄按鈕是逐頁記住的——三個樹頁面各自保有自己的選擇——而只要兩頁有同一種欄,寬度就是共用的。樹的寬度是三頁共用的一個設定:執行頁的左側停靠欄,以及設備頁與刀具庫的控制樹欄,所以在執行頁把停靠欄拉寬,另外兩頁的樹欄也跟著變寬。編輯器欄的寬度是設備頁與刀具庫共用的一個設定,刀具清單則有它自己的寬度。從沒拖曳過的瀏覽器,開出來的刀具清單是 300 px、樹是 240、編輯器是 420。已展開的樹節點清單也是單一設定,三頁共用同一份清單。

F5 到 F8 屬於執行頁。 它們驅動該頁的傳輸列——F5 開始或繼續,F6 暫停,F7 執行一行 NC,F8 執行一個加工步——而且只在該頁是螢幕上那一頁時才綁定,所以在其他每個畫面上,F5 就是瀏覽器自己的重新整理。當下對應按鈕不可用的按鍵,或是焦點在文字欄位裡時按下的按鍵,會轉交回瀏覽器。這對 F5 影響最大:執行進行中時開始鈕不可用,所以這個鍵會重新整理頁面,工作階段建好的那些畫面也隨之消失。

專案變更會做什麼

新增、載入、重新載入、存到與目前開啟位置不同之處的另存新檔,以及關閉專案,都會捨棄工作階段建好的每一頁,並依變更之後的專案是什麼來重建——關閉專案之後,就是什麼都沒有。這就是為什麼畫面不會繼續顯示已經不再開啟的專案的數值,也是為什麼從未儲存的頁內狀態撐不過專案變更——只有下面說的另存新檔是例外。每個因此失去修改的編輯器,會在它的畫面拆掉時說一句:專案已變更,「…」未儲存的修改已捨棄。CSV 的圖表檢視器若在專案變更前送出的增刪列儲存沒有收到回應,則改說無法確定列是否已寫入,請先檢查檔案再繼續編輯。

決定要不要重建的是服務開啟或關閉了專案,或是視窗的路徑移動了。單純的儲存兩者都不是,從不重建。另存新檔存回目前已開啟的路徑,行為和儲存完全一樣,什麼都不重建;而另存新檔存到別的位置,則把視窗移到那個路徑上,一切重建。在另一個瀏覽器做的另存新檔,在這裡也一樣:服務把新路徑告訴連到它的每一個瀏覽器,這個視窗就移到那個路徑上並重建。另存新檔保留服務持有的那個專案,只是換了新名字,所以步變數或著色樹尚未套用的修改,會在它造成的重建之後交還給各自的編輯器。在載入開啟的檔案瀏覽器裡挑到已經開啟的那個專案,會和重新載入一樣重建:檔案在服務端會再讀一次,每個畫面都依它重建。

同樣的重建在啟動時也會跑一次,不需要任何人做任何事:瀏覽器連上一個已經開著專案的服務時,會把那個路徑當成自己的第一次專案變更收下,並在其上建構。

新增、載入、重新載入、儲存、另存新檔與關閉專案一次只跑一個。第一個還在跑時發起的第二個會被拒絕,而不是排隊;拒絕以一則警告送達,寫著另一項專案操作正在進行中,請稍後再試。 什麼都不重建,也什麼都不會丟失。這一輪在整個操作期間都被佔著,所以載入還在讀取時要求的關閉會被同樣拒絕,關閉還在拆除專案時要求的載入也一樣。

頁尾

一條 29 像素高的橫條,容納三個區域,各自獨立於另外兩個。

左——最新回報的一行,後面跟著最近的那些。 文字是應用程式最近一次發出的訊息,還沒有任何訊息之前則是就緒;它的工具提示帶著完整內容,連同它附帶的副標 (caption)。前方的圖示標示嚴重性:一般狀態行是灰色的資訊符號,成功是綠色勾號,警告是琥珀色三角形,失敗是紅色符號。旁邊的時鐘按鈕打開最近訊息——最新的在前,上限一百則,每一列以左緣的一道色條重述其嚴重性,並帶著它送達的時間。這份清單屬於這個瀏覽器與這個工作階段:清除會清空它並讓前面那一行回到就緒,重新整理會清空它,而且它不會被寫到任何地方。

中——工作階段條。 只有在執行已產出東西時才畫出來,新增、載入、重新載入與關閉專案會把它清空——另存新檔保留專案,也就保留它——其餘時間這個位置就是空的。每一行由一個圖示開頭——游標更新是定位符號,其他則是訊息自己的嚴重性符號——只要該筆項目帶有錨點,後面就以等寬字前綴接上錨點:游標行帶著 Sn 與它所在的語句索引,訊息行則帶著訊息自己提供的錨點。滑鼠停在上面會打開它背後的最近活動——最新的在前,上限三十則,連續的一串游標更新會摺疊成其中最新的那一筆;點一下會把那份清單釘住不收。

右——背景作業區。 只在「檔案」選單的某項操作進行中時出現——關閉專案也算——寫出該操作與它正在處理的路徑,操作結束就消失。

切換語言會立刻、不經導覽地以新語言重新呈現整個介面:選單、頁面切換鈕與瀏覽器分頁標題全都會變。兩個訊息區域不跟著變。最近訊息清單與工作階段條裡的每一行都保留它發出時的語言,所以切換語言之後讀到的頁尾是語言混雜的,這是刻意的設計。

連線標記

選單列上的這個標記只屬於執行頁;其他畫布在自己的面板裡帶著自己的標記。它把該頁的渲染連線和各面板背後的服務連線彙總起來,只有集合裡每一條連線都通時才顯示綠色的已連線——只要有任何一條正在連線或重新連線就是橘色,而只有在沒有任何一條在連線、卻仍有一條斷著時才是紅色。

這個集合不是固定的。在那一頁上,渲染連線永遠被納入,但服務連線只在真的有東西在用它時才加入——一個開著的面板,或框架本身。沒有任何東西在消費的連線會被排除在外,而不是被強迫連線。ExecutionStatus 在整個工作階段都有消費者,因此永遠在集合裡;其餘的來來去去,這就是為什麼展開與收合面板會改變標記所回報的內容。綠色標記的意思是使用中的每一條連線都健康,而不是存在的每一條連線都健康。

只有兩種問題狀態帶有工具提示——全部連上時沒什麼好解釋,也就不出現。工具提示為每條連線列出一列,Rendering、Shell、NcDiag 等等,這些名稱是識別字而不是介面文字:在翻譯過的工作階段裡,只有每個名稱旁邊的狀態會換語言。

延伸閱讀

  • 基礎 — 每個畫面上其餘成立的事
  • 登入 — 讓登出按鈕出現在這條列上的起因
  • 專案 — 「檔案」選單,以及它每個項目做什麼
  • 畫面導覽 — 頁面切換鈕與它們背後的各個畫面
  • 偏好設定 — 「偏好設定」選單,以及不在其中的那些設定
  • 訊息與日誌 — 頁尾所摘要的那些介面,以及「說明」選單裡日誌檢視器背後的日誌
  • 在 Windows 上更新 HiNC — 已安裝的 HiNC 上的更新標記,它的各種狀態代表什麼,以及它與「說明」選單的「檢查更新…」所打開的「軟體更新」對話框
  • 用雲端帳號登入 — 「說明」選單最後一項打開的授權對話框,以及雲端版 HiNC 的登入與登出
  • 開始與逐步執行 — 那些 F5–F8 鍵所驅動的傳輸列,以及列上標記所回報的連線
  • 觀看執行 — 中欄的兩個切換鈕所顯示與隱藏的畫布與工作階段資訊面板