VisualApplets 的使用者介面

VisualApplets 提供了一個用於小程式設計的圖形化使用者介面,無需 進行程式設計或腳本編寫。其直覺的工作流程讓使用者能夠在不撰寫程式碼的情況下, 建立複雜的影像處理設計。此工具的設計宗旨,是讓 沒有程式設計背景的使用者也能輕鬆上手。

此外,VisualApplets 也為偏好使用腳本或透過命令 列進行操作的使用者,提供了「命令列選項」 及腳本 功能。

主視窗

VisualApplets 的主視窗由以下工具列和面板組成:

主程式視窗

圖 3. 主程式視窗


主選單列可讓您直接存取程式功能。請使用工具列 上的按鈕,快速存取重要功能。您可以在 「設定」 → 系統設定 → 一般:

三個面板提供不同的資訊與選項:

  • 設計面板:設計面板顯示您的VisualApplets 專案。您總是 會有一個主要設計視窗,但根據專案的結構, 您可能還會同時使用多個子視窗。在 「視窗」 中,可選擇多種檢視模式(平鋪、階梯式、分頁檢視)。 透過位於 「視窗」 → 圖表Windows ( Ctrl+F8 ),您便能輕鬆選取當下想要進行編輯的 設計圖窗。

  • 資訊面板:在主程式視窗的預設設定下, 資訊面板會始終顯示。它以分頁視圖形式提供 各種資訊視窗:

    • Project Info

    • Module Info

    • Parameter Info

    • DRC Log

    • Build Log

    • Help

    (有關各資訊視窗的詳細內容,請參閱下文。)

  • 函式庫面板:在主程式視窗的預設設定下,函式庫 面板會始終顯示。它以分頁視圖形式提供三個函式庫視窗:

    • 運算子函式庫:運算子函式庫是一組 子函式庫的集合,其中包含VisualApplets 運算子,也就是 個別的影像處理函式。

    • 使用者函式庫:使用者函式庫可包含自訂函式庫,其中 包含使用者自訂的運算子組合(階層式方塊)。如需 更多資訊,請參閱「使用者函式庫」。

    • 自訂函式庫:若要將運算子匯入自訂函式庫,請參閱 「自訂運算子函式庫」。

[提示] 特定運算子

運算子庫中顯示的某些運算子,可能不適用於 您目前正在設計的平台。不支援的運算子會以灰色顯示, 以表示它們無法在當前的設計配置中使用。

目前選定的目標硬體平台不支援此運算子

圖 4. 目前選取的目標硬體 平台不支援此操作員


資訊面板

本主題提供有關 資訊面板的相關資訊。所謂的 「資訊面板」 包含以下檢視:

資訊面板

圖 5. 資訊面板


Project Info

「專案資訊」視窗彙整了當前專案的相關資訊。

Project Info

圖 6. 專案資訊


以下為相關資訊:

  • 名稱:專案名稱(即檔案名稱)

  • 建立日期:建立日期

  • 最後修改時間:最後修改日期

  • 版本:專案的版本號;此項目可從 設計 → 專案詳細資訊 選單中進行編輯(請參閱「專案屬性」)

  • 說明:專案的文字描述;此項目可從 設計 → 專案詳細資訊 選單中進行編輯(請參閱「專案屬性」)

  • 類型:顯示目標硬體上目前使用的 FPGA 類型(請參閱 「目標硬體移植」)

  • 目標執行時間:顯示目標執行時間(請參閱「目標執行時間」)

  • 設計規則檢查第 1 級:顯示發現的錯誤或檢查 成功(請參閱「設計規則檢查」)

  • 硬體小程式:表示存在硬體小程式。若VisualApplets 先前曾為該專案產生 HAP 檔案,則此項目 會被勾選。

  • 資源:顯示資源估算的結果。另請參閱「FPGA 資源估算」。

  • 系統:顯示偵測到的 XILINX 版本、可用的Framegrabber SDK 版本,以及Framegrabber SDK 的安裝目錄。此資訊 將由VisualApplets 用於建置 HAP 以及產生最終的 HAP 輸出。詳情請參閱 「建置」章節。

Module Info

「模組資訊」視窗會顯示該專案中所有已使用模組的清單 (前提是該視窗的輸入欄位為空)。此清單的 結構依專案的層級架構而定。

模組搜尋

圖 7. 模組搜尋


在「模組資訊」視窗中,您可以輕鬆搜尋特定的模組或 模組類型。這在處理大型設計時非常有用。在開始 搜尋之前,您應先設定篩選條件:

  • 若要搜尋您為該模組所指定的名稱, 請啟用「名稱」功能。

  • 若要搜尋模組類型(即您目前正在搜尋其實例的 運算子的名稱),請啟用 「類型」選項。

模組搜尋

圖 8. 模組搜尋


現在您可以輸入搜尋詞彙。只需輸入名稱的一部分 即可。點擊「模組資訊」 視窗中列出的其中一個模組,便會將對應的設計視窗置於前台(在設計面板中), 並選取該模組並加以標示。

Parameter Info

「參數資訊」視圖會顯示所有參數及其 運算子,這些均屬於當前設計。您也可以在 「參數資訊」視圖中編輯這些參數。

Parameter Info

圖 9. 參數資訊


「參數資訊」視圖提供了一項搜尋功能, 讓您能夠搜尋參數、參數值或運算子名稱。您可以 使用「僅限執行時參數」篩選器,僅顯示 動態參數,也就是您可以在執行時編輯的參數。

DRC Log

「DRC 記錄」視窗會顯示最近一次設計 規則檢查的結果。點擊警告/錯誤訊息下方列出的其中一個模組名稱, 即可將對應的設計視窗置於焦點位置(在設計面板中),並 選取該模組並加以突出顯示。

DRC 日誌資訊

圖 10. DRC 日誌資訊


Build Log

「建置日誌」視窗會顯示上次建置的結果。

建置日誌資訊

圖 11. 建置日誌資訊


Help

「說明」視窗提供針對個別 運算子的情境式說明。

若要開啟情境式說明,您可以:

  1. 請直接在您的設計中選取您想查詢資訊的運算子,並 按下 F1 以開啟並在「說明」視窗中顯示對應的 資訊。

  2. 請從「運算子庫」 視窗中選取一個運算子。說明視窗將始終顯示 當前選取項的說明。

範例:顯示 MergeKernel 運算子的資訊

圖 12. 範例:顯示 MergeKernel 運算子的資訊


若您按下 F1 ,或點擊任何其他視窗中的「說明」按鈕, 系統將開啟針對當前選取視窗或功能的 情境式使用者手冊說明。當然,您亦可直接從這份使用者 文件中存取操作員說明。請參閱《操作員參考手冊》。

圖庫面板

「函式庫」面板以分頁視圖顯示「運算子函式庫」視窗、「使用者函式庫」視窗以及 「自訂函式庫」視窗。

所有函式庫(運算子函式庫、使用者函式庫,以及自訂函式庫及其所有 子函式庫)均以樹狀結構組織。每個函式庫都包含運算子。

可透過選擇「樹狀圖」、「清單」 或「圖示」檢視模式,來變更結構的視覺化呈現方式。

展示「操作員函式庫」的函式庫面板

圖 13. 顯示「操作員庫」的庫面板


在搜尋欄中,可輸入搜尋字串以篩選清單, 僅顯示所需的操作員。 例如輸入「攝影機」 ,例如,系統將列出所有 包含 camera 的操作員。

Operator Library

「運算子函式庫」是一組包含各項運算子的子函式庫集合,VisualApplets 也就是說,這些子函式庫包含個別的影像處理函式。

您可以透過在「運算子庫」視窗中點擊運算子 名稱,然後在資訊面板中點擊 「說明」索引標籤,來取得每個運算子的詳細資訊。

展示「操作員函式庫」的函式庫面板

圖 14. 顯示「操作員函式庫」的函式庫面板


有關如何將新運算子新增至 圖表,請參閱「插入運算子」。所有運算子的詳細說明請參閱《運算子參考手冊》。

User Library

「使用者函式庫」可包含自訂函式庫,其中包含由使用者定義的 運算子組合(階層式方塊)。如需更多資訊,請參閱「使用者函式庫」。

Custom Library

若要將運算子匯入「自訂函式庫」,請參閱「自訂運算子函式庫」。

調整程式視窗

您可以透過多種方式,將《VisualApplets 》的主程式視窗調整為符合您 個人偏好的樣式:

調整工具列

工具列可透過拖放來重新排列,或透過右鍵點擊來新增/移除。

還原主程式視窗的預設設定

如果您不小心將視窗或工具列排列成不希望的樣式, 您可以透過選取 「視窗」 → 重設停靠區Windows ( Ctrl+O )。

將圖表標籤取消停靠至獨立視窗

您可以在 設計面板 中將圖表分頁解除錨定, 讓設計內容顯示於浮動視窗中。透過此功能, 您可利用多個螢幕來編輯設計。此功能可透過三種 方式存取:

  1. 透過右鍵選單:

    1. 在該分頁上按右鍵。

    2. 點擊「浮動」。

    透過快顯選單解除停靠

    圖 15. 透過快顯選單解除停靠


  2. 使用 Float 按鈕:

    1. 將游標懸停在分頁上即可顯示 「浮動」 按鈕,該按鈕位於 關閉 按鈕左側的浮動按鈕。

    2. 點擊 「浮動」 按鈕。

    透過「浮動」按鈕解除停靠

    圖 16. 透過「浮動」按鈕解除停靠


  3. 雙擊左鍵:

    1. 在該分頁上雙擊左鍵。

已解除停靠的圖表視窗可像一般視窗一樣自由使用和排列。Windows

[注意] 視窗狀態未儲存

儲存設計時,不會儲存視窗狀態。因此,該設計 將在沒有分離視窗的情況下載入。

這同樣適用於 「返回」 和 「前進」 功能,這些功能會關閉已解除停靠的視窗。

若要將浮動視窗重新固定,有一個 「固定」 按鈕。此按鈕會將圖表視窗停靠至當前 顯示區域的最後一個位置。

浮動裝置重新對接Windows

圖 17. 浮動體重新對接Windows


分割主視窗內的設計面板

您可以將 「設計面板」 進行分割,使 各圖表標籤頁能在主視窗中並排顯示。此功能讓您能夠 同時檢視及編輯多個圖表標籤頁。

若要分割您的 設計面板:

  1. 在您要移動的圖表標籤上按右鍵。此時會開啟 一個快顯選單。

  2. 選取 移至其他檢視。

    開啟分屏檢視

    圖 18. 開啟分屏檢視


因此,圖表分頁會並排顯示於主視窗中:

分屏視圖

圖 19. 分割視圖


若要結束分屏檢視,請選取 「將所有視圖移至其他 視圖」 。此操作會將所有圖表視窗分頁從 選取的顯示區域移至另一顯示區域。

[注意] 視窗狀態未儲存

儲存設計時,不會儲存視窗狀態。因此,該設計 將以未分割視圖的方式載入。

這同樣適用於 「返回」 和 「前進」 功能,這些功能會關閉分割視圖。

File -> Recent Designs 下的檔案數量

在 「檔案」 → 「最近的設計」VisualApplets 會顯示您最近開啟的VisualApplets 檔案 (*.va) 清單。您可以設定實際顯示的檔案數量。

若要設定顯示多少個最近開啟的檔案:

  1. 前往選單 設定 → 系統設定 並選擇類別 「一般」。

  2. 在 「近期設計」下,請設定您 希望顯示的檔案數量(最多 24 個)。

  3. 請向 「確定」。

設定顯示的近期設計數量

圖 20. 設定顯示的近期設計數量


多重程序

VisualApplets 專案可能包含多個流程。流程是 圖的最高層級,可包含任意數量的運算子及 層級方塊。每個流程均可 個別啟動與停止。

一個使用四個程序的典型例子,就是四鏡頭應用程式,例如 examples\Acquisition\BasicAcquisition\iF-CXP12-Q\QuadCXP12x1AreaGray8.va 舉例來說。請參閱 下圖。圖中顯示了四個程序,每個程序中都包含一台攝影機、一個緩衝區以及一個 DMA 操作員 。

具有四個程序的小程式

圖 21. 包含四個程序的小程式


使用該小程式時,這四個進程(即四台攝影機)均可 分別啟動與停止。若四台攝影機皆位於同一個進程中,則必須 同時啟動與停止,因為一個進程中的所有 DMA 都必須一併啟動。

若要進一步了解如何在硬體上使用VisualApplets 小程式,請參閱「在硬體上執行您的程式」一節,以及/或Framegrabber SDK 的文件。

管理程序

若要新增一個程序,請按一下 「設計」 → 新增流程 ,或點選「編輯」工具列中的圖示。

建立新流程

圖 22. 建立新程序


若要移除一個流程,請先選取該流程所屬的 任一圖形視窗,然後選取 設計 → 移除流程 ,或點選「編輯」工具列中的圖示。

程序的編號總是從 0 開始,且必須按升序排列。若某個程序 被移除,編號較高的程序將依序遞移以填補空缺。

鍵盤快速鍵

以下是《VisualApplets 》中所有可用快捷鍵的清單。

主程式視窗

捷徑 選單項目
Ctrl+N 檔案 →新增專案
Ctrl+O 檔案 →開啟專案
Ctrl+S 檔案 →儲存專案
Ctrl+P 檔案 →列印可見的圖表
Ctrl+Q 檔案 →結束應用程式
Ctrl+Z 編輯 →撤銷
Ctrl+Shift+Z 編輯 →重做
Ctrl+Z 編輯 →撤銷
Ctrl+X 編輯 →剪下
Ctrl+C 編輯 →複製
Ctrl+V 編輯 →貼上
Del 編輯 →刪除
F2 編輯 →重新命名模組
Ctrl+I 設計 →新增運算子
Mouse 3+ 設計 →新增運算子
Ctrl+F 設計 →搜尋模組
F9 分析 →開始模擬
Ctrl+F7 分析 →設計規則檢查第 1 級
Ctrl+F8 分析 →設計規則檢查第 2 級
F7 建構 →建置
F5 建置 →啟動 microDisplay
F11 檢視 →全螢幕
Ctrl++ 檢視 →放大示意圖
Ctrl+- 檢視 →縮小圖表
Ctrl+滑鼠滾輪向上 檢視 →放大示意圖
Ctrl +滑鼠滾輪向下 檢視 →縮小圖表
Ctrl+Return 檢視 →還原縮放比例
退格鍵 檢視 →視窗向上
Ctrl+空格鍵 檢視 →切換手形工具/選取工具
Ctrl+向右箭頭鍵 視窗 →下一個圖表
Ctrl+左箭頭鍵 視窗 →上一張圖
拖放 專案檔案可直接拖放至主視窗中。

表 1. 主程式視窗的快捷鍵清單


Simulation Viewer

捷徑 選單項目
Ctrl+Q 檔案 →關閉模擬檢視器
Ctrl+C 編輯 →將圖片複製到剪貼簿
Del 編輯 →移除選取的圖片
Ctrl+Del 編輯 →移除所有圖片
左箭頭 導覽 →上一張圖片
向右箭頭 導覽 →下張圖片
Ctrl++ 檢視 →放大
Ctrl+滑鼠滾輪向上 檢視 →放大
Ctrl+- 檢視 →縮小
Ctrl +滑鼠滾輪向下 檢視 →縮小
Ctrl+滑鼠 3 檢視 →標準尺寸 1:1
F11 檢視 →全螢幕
Ctrl+F 檢視 →調整為視窗大小
Ctrl+T 檢視 →對應縮圖
Ctrl+R 檢視 →重設參數
拖放 圖片可直接拖放至模擬檢視器 (來源) 或模擬來源模組。

表 2. 模擬檢視器的快捷鍵清單


Command Line Options

VisualApplets 提供了一些命令列參數,以便在使用VisualApplets 時, 例如在批次腳本中,或將該程式連結至系統環境中。

其語法遵循以下模式:

<VISUALAPPLETSINSTALLDIR>\VisualApplets <-COMMAND> <ARGUMENTS>

以下表格列出了各項指令及其預期參數: :

命令列 論點與涵義

-檔案

執行儲存於指定 Tcl 腳本中的指令。

論點:

  • Tcl 腳本的檔案名稱 (*.tcl)

-編譯

載入指定檔案並建立小程式。該設計將 根據設計規則進行檢查。

論點:

  • VisualApplets 設計檔案 (*.va) 的檔案名稱

  • 生成的 Applet 檔案名稱 (*.hap)

-sdk

產生一個 SDK 範例(C 語言原始碼),用於將該小程式與 Framegrabber SDK 搭配使用。系統將依據設計 規則來檢查該設計。

論點:

  • VisualApplets 設計檔案 (*.va) 的檔案名稱

  • PixelPlant 小程式的檔案名稱 (*.hap)

-保留合成追蹤檔案

生成硬體小程式時的額外選項。用於在建置完成後, 為追蹤目的而保留 建置過程中所產生之中間檔案。

<VA file name>

載入指定的VisualApplets 設計檔案。

例如,在指派時使用 *.va 或 *.vad 可透過雙擊 資源管理員開啟的檔案。

論點:

  • VisualApplets 設計檔案的檔案名稱 (*.va 或 *.vad)

表 3. 命令列選項及其對應的參數


Print / Screenshot

VisualApplets 提供列印圖表視窗或將其內容複製為圖片並存入系統剪貼簿的功能。 列印/螢幕截圖功能將套用至目前選取的圖表視窗。 即使因解析度限制導致部分內容無法完全顯示 於當前螢幕上,系統仍會選取包含所有運算子與連結的完整視窗進行輸出。

要開始列印,請選取所需的圖表視窗,然後選取 「檔案」 → 列印 ( Ctrl+P )。 設計會自動調整大小。

若要擷取螢幕截圖並將內容複製到剪貼簿,請選取所需的圖表視窗,然後點擊 編輯 → 「截圖至剪貼簿」。 若您希望直接將螢幕截圖儲存為圖片檔案,請選取 「編輯」 → 「將螢幕截圖儲存為檔案」。