Action Maker 程式與 Divooka 文件
Action Maker 沒有自己的檔案格式。程式就是一個 Divooka 文件(.dvk),與 Divooka Explore 和 Divooka Compute 開啟的是同一種文件,而各行是讀寫文件中 Routine 的另一種方式。在 Divooka Compute 中開啟儲存好的程式,你看到的是同一個程式以畫布上的節點呈現;在畫布上編寫一個 Routine,Action Maker 通常也能把它讀成各行。
如果你兩者都用,這一頁就是為你寫的。
簡而言之
- 一個文件,兩種檢視。 Action Maker 把文件的 Routine 顯示為各行。Divooka Explore 和 Compute 把同樣的 Routine 顯示為節點和連線。
- 沒有自己的執行時。 Action Maker 中的 Run 用 Divooka 自己的直譯器執行文件,與編輯器執行 Routine 的方式完全相同,因此程式無論在哪裡執行,行為都一樣。
- 它的動作就是發行版的動作。 Action Maker 提供的是與它一起安裝的 Divooka 的動作:隨 Divooka Compute 提供時就是 Compute 的全部動作,隨 Explore 提供時就是 Explore 的全部動作,免費的獨立版則是一個較小的集合。
程式如何儲存
| 在 Action Maker 中 | 在 Divooka 文件中 |
|---|---|
| Main | 文件的入口圖:一個名為 Main 的 Routine |
| 另一個例程 | 文件中位於 Main 旁邊的一個 Routine;它的輸入是其 Begin 節點的輸出,它的輸出是其 Return 節點的輸入 |
| 例程的變數 | 該 Routine 的區域變數 |
| 資料成員 | 文件的資料成員,由其中每個圖共享——包括 Action Maker 不顯示的圖 |
| 一行 | 一個節點,作為語句放置,並按各行的順序沿執行連線連線 |
| If、迴圈、Sequence、Try | 它們的流程控制節點;所包含的每個塊都掛在它自己的輸出上——True 和 False、Next、Sequence 的各部分 |
| 輸入的值 | 寫在節點輸入上的值,或連到該輸入上的一個小 Number、Text 或 Truth 節點 |
| 一個 Operation | 一個沒有執行引腳的節點(純節點),連到該輸入上 |
| 迴圈的目前值、前面某行的結果 | 一條來自那個節點輸出的連線 |
結果的名稱,例如 multiply1 |
節點在 Properties 面板中的 Name,編譯後的程式碼也使用它 |
| 行註解 | 節點的標籤 |
| 塊註解 | 一個分組,框住流程控制以及它所包含的各行,不多不少 |
| 斷點 | 節點的斷點 |
在畫布上,節點按各行的閱讀順序佈局:每一行在其例程中佔一個單獨的橫帶,它算出的值位於其左下方,每個塊位於包含它的那一行下面。
編輯時會發生什麼
在 Action Maker 中。 每次儲存和每次執行時,Action Maker 都會根據各行重新寫出它所顯示的每個 Routine:它清除該 Routine 的節點——保留 Begin、變數以及註解、分組和繪圖——為每一行重新放置一個節點,並重新佈局。文件中的其他一切都保持原樣:Function、Events 圖、型別、標題和資源。
在 Divooka Explore 或 Compute 中。 就是普通的編輯。下次 Action Maker 開啟該文件時,它會從每個 Routine 的 Begin 開始沿執行連線讀取,一個節點一行。
If 之後的行
在 Divooka 中,Branch 的兩條路徑永遠不會再匯合,Sequence 也沒有“之後”。所以當你在 Action Maker 中在 If 之後寫行時,文件會用 Divooka 的方式表達:一個 Sequence,第一部分是 If,第二部分是它後面的各行。Action Maker 會把這個 Sequence 讀回成你寫的那些行。
在畫布上,你會看到一個你從未新增過的 Sequence 節點。別去動它:如果你給它新增第三部分,或者在第一部分中放入 If 以外的東西,Action Maker 就會把它讀成一個 Sequence 行——程式還是同一個,只是寫法不同。單步執行這樣的程式時,執行也會經過這個 Sequence,而它並不對應任何一行。
需要注意的事項
Action Maker 掌管它所顯示的 Routine 的佈局。 你在某個 Routine 中手動排列的節點,會在 Action Maker 下次儲存或執行程式時被重新佈局。你在畫布上新增的註解、分組和繪圖會被保留,但它們周圍的節點會移動,所以你畫的分組可能不再框住原來的內容。如果某個 Routine 的排列對你很重要,就只在一個工具中編輯它。
結果的名稱是給出的,不會被保留。 你在 Divooka Compute 的 Properties 中為節點輸入的 Name,會在 Action Maker 下次寫出該 Routine 時,被 Action Maker 為那一行的結果所起的名稱(multiply、multiply1……)取代。在更上方插入一行,會讓它下面的名稱重新編號。
有些東西不能成為行。 Action Maker 會把它無法表達為行的內容顯示為黃色標記的行,並且在該行被替換之前拒絕儲存或執行程式,因此它不理解的文件永遠不會被改寫成不同的內容。以下情況會這樣:
- Switch;
- 這一份 Action Maker 沒有的動作——例如在 Divooka Compute 中編寫、使用了免費獨立版所不帶的包的文件;
- 來自某個行無法指向的位置的連線,例如在另一個塊內部算出的值。
Function 永遠不會成為行。 Function 是資料流圖,沒有可讀的語句順序,所以 Action Maker 只顯示文件的 Routine。Function 和其他圖都保持原樣。
被兩行共用的計算會變成兩份。 在畫布上,一個純節點可以同時供給兩條語句。寫成各行時,每一行都有自己的 Operation,所以 Action Maker 寫出該 Routine 後,那個節點會有兩份。對大多數計算來說,這沒有區別。對於應當只執行一次的計算——一個隨機數、某個耗時的操作——先把它的結果存進一個變數,再在兩行中讀取這個變數。
註解就是標籤,標籤就是註解。 如果一個節點的標籤與它自己的標題不同,Action Maker 會把這個標籤顯示為該行的註解。只有當一個分組恰好框住一個流程控制以及它所包含的各行時,它才會成為塊註解;其他分組按原樣留在畫布上。
變數按名稱和型別匹配。 在畫布上重新命名區域變數或修改其型別,在 Action Maker 中會被讀成另一個變數。資料成員在兩個工具中重新命名都是安全的:它們在宣告處被修改,讀取它們的每個圖都會隨之更新。
在 Divooka Compute 中對 Routine 的單個節點所做的設定是 Action Maker 不瞭解的,所以在 Action Maker 寫出該 Routine 之後,請檢查這些設定。
入口必須是 Routine。 Action Maker 開啟入口圖是 Routine 的文件。以 Events 圖或 Flows 圖開始的文件會被拒絕,並顯示相應的提示。