其他任務（microDisplay X ）

設定使用者偏好設定

您可以在 `microDisplay X ` 中設定會影響以下項目的參數：

• microDisplay X 的 GUI 顯示（小程式顯示，以及參數值的十進位／十六進位／二進位顯示）
• 擷取參數（緩衝區數量、擷取超時、最大 DMA 緩衝區大小）
• 攝影機偵測與攝影機控制的運作方式

若要設定使用microDisplay X 的偏好設定：

1. 在microDisplay X 中，從「工具」選單中選取「設定」。

2. 在隨後開啟的對話方塊中，請調整您要變更的設定：

   • 小程式的顯示： 按一下 GUI，以及在 Applet 佈局／檢視模式, 決定小程式在程式視窗的「小程式佈局窗格」中應以何種方式顯示。請選擇要按程序（程序模式）或按資源類型（資源模式）列出小程式的資源（連接埠）：
     • 在程序模式下，屬於某個程序（某個擷取通道）的資源（埠）會以「擷取程序」這個實體的形式，列於小程式佈局窗格中。
     • 在「資源」模式下，於「DMA」項目中，會列出所有處於活躍狀態的 DMA 埠（即載入於microDisplay X 中的小程式所對應的埠）。在「相機埠」項目中，則會列出所有連接至相關幀擷取卡的相機。
   • 預設整數顯示模式：在程式視窗中顯示參數和像素值時，您可以選擇十進位、十六進位或二進位顯示模式。

   • 擷取參數：要設定擷取參數，請按一下「擷取」，並設定您的偏好設定：

     

   • 探索設定：若要設定探索參數，請按一下「探索」，並設定您的偏好設定：

     

儲存 Applet 設定

在您完成小程式的設定（透過microDisplay X 或Framegrabber API ）後，即可儲存設定。

儲存 Applet 的設定，可讓您下次載入該 Applet 時（無論是在幀擷取器上、microDisplay X 中，或是您的軟體中），所有參數皆已預先設定好。

資訊

請務必確保在儲存小程式設定時與實際使用時，皆採用相同的Framegrabber SDK 版本。舉例來說，若您使用Framegrabber SDK 版本 5.9.0 來設定小程式並儲存該設定，則應僅在版本 5.9.0 的環境中載入該設定。

以下各節提供了您處理 MCF 檔案所需的所有資訊。

MCF 與 MFS 檔案

MCF 檔案

當您儲存小程式設定時，設定資料會儲存至檔案中。該設定檔案的副檔名為 *.mcf。（MCF =microEnable 設定 檔）

MCF 檔案是以文字格式儲存的，因此您不僅可以透過 microDisplay X 或 API 調整，還能直接在此檔案中修改。

MCF 檔案包含：

• 它所屬的小程式的名稱。
• 您所進行的所有參數設定（唯獨欄位值除外）。
• 如有需要，請提供 MFS 檔案的連結（該檔案包含您在 Applet 設定過程中所定義的欄位值）。

在獨立的XML 檔案中設定相機參數

MCF 檔案不包含攝影機設定。您可以將攝影機設定儲存於獨立的 *.xml 檔案中。MCF 檔案僅包含小程式設定。

MFS 檔案

一個小程式的配置可能包含場參數，例如 LUT。這些場參數並非直接儲存於 MCF 檔案中，而是儲存於一個副檔名為 *.mfs 的獨立檔案中。（MFS =microEnable Field Storage）

您完全不需要直接處理 MFS 檔案：

• 如果您的 Applet 設定中包含欄位參數，當您儲存 Applet 設定時，系統會自動建立 MFS 檔案，並同時建立 MCF 檔案。
• 載入小程式設定時，只需載入 MCF 檔案即可，因為 MFS 檔案（欄位參數）的內容會隨 MCF 檔案一併自動載入。

資訊

針對每款幀擷取卡型號，均提供一套免費的小程式。這些小程式稱為「擷取小程式」。所有擷取小程式的檔案副檔名皆為 *.dll。擷取小程式以小程式套件形式提供（每款幀擷取卡型號對應一套）。小程式套件可與「Framegrabber SDK 」一併安裝，或透過獨立的小程式套件安裝程式進行安裝（可於Basler 網站的下載專區取得）。 安裝完成後，擷取小程式會位於Framegrabber SDK 安裝目錄下的 Dll 子目錄中。（例如：C:\Program Files\Basler\FramegrabberSDK5.x.x\Dll。）擷取小程式可於可程式化及不可程式化的幀擷取卡（即A 系列與 V 系列幀擷取卡）上運行。

所有資料擷取小程式皆包含欄位參數。因此，每當您儲存資料擷取小程式的設定時，系統便會建立兩個檔案：*.mcf 檔案與 *.mfs 檔案。不過，您無需另行處理 *.mfs 檔案，因為當您儲存或載入 *.mcf 檔案時，系統會自動建立或載入 *.mfs 檔案。

以下陣列（欄位參數）是所有或部分擷取小程式的一部分：

• LUTs
• KneeLUTs
• PoCXPStatePort_x（marathon 僅限 CXP 板卡）
• PoCXPCurrentPort_x（marathon 僅限 CXP 板卡）
• PoCXPVoltagePort_x (marathon 僅限 CXP 板卡))

資訊

將所有欄位資料儲存至獨立檔案中，可保持小程式配置檔 MCF 的簡潔，並確保向下相容性。

在 mDisplay X 中的儲存與載入

將 Applet 設定儲存至檔案中microDisplay X

在 microDisplay X中，您可以將目前載入的 Applet 的設定儲存至檔案。

1. 從「檔案」選單中，選擇「儲存設定」。

   

2. 請選擇要儲存小程式設定檔 (*.mcf) 的目錄。

3. 請為您的 *.mcf 檔案命名。
4. 按下「儲存」。

*.mcf 檔案會被建立，並儲存於您在第二步中指定的目錄中。若小程式設定中包含欄位值，系統會額外建立一個 *.mfs 檔案，其中包含該小程式設定的所有欄位參數值。若小程式包含欄位參數，系統會自動建立 MFS 檔案。

從檔案載入 Applet 設定，位於microDisplay X

1. 在 microDisplay X中，請選擇您要使用已設定小程式的幀擷取卡。

   

2. 從「檔案」選單中，選取「開啟設定」。

   

3. 在隨後開啟的對話方塊中，請導航至包含您的 Applet 設定的目錄。

4. 選取您要使用的 *.mcf 檔案，然後按一下「開啟」。

已配置的小程式會載入至 microDisplay X 並在幀擷取卡上啟用。若小程式設定中包含欄位參數，系統會自動從對應的 *.mfs 檔案載入欄位值。您無需另行載入 *.mfs 檔案。

透過以下方式儲存與載入Framegrabber API

透過 將 Applet 設定儲存至檔案Framegrabber API

若要儲存小程式設定檔，Framegrabber API （函式庫）中提供了以下函式 fglib5.lib, 標頭檔 basler_fg.h）：

int Fg_saveConfig (Fg_Struct *Fg, const char *Filename)

參數：

• Fg: 系統中的幀擷取卡（板卡索引）。請在此指定您要從其中儲存當前配置（當前小程式及其參數設定）的幀擷取卡。
• Filename : 請在此處指定設定檔的名稱與路徑。檔案副檔名始終為 *.mcf。

如果 Applet 設定中包含欄位值，系統會建立一個額外的 *.mfs 檔案，其中包含該 Applet 設定的所有欄位參數值。若 Applet 包含欄位參數，系統會自動建立該 MFS 檔案。

透過 從檔案載入 Applet 設定Framegrabber API

若要從檔案載入小程式設定，可使用多種函式（函式庫 fglib5.lib, 標頭檔 basler_fg.h）：

幀擷取卡初始化

您可以透過 *.mcf 檔案直接初始化板卡。由於 MCF 檔案中包含小程式名稱，因此幀擷取卡會根據 MCF 檔案中指定的小程式進行初始化，且 *.mcf 檔案中儲存的小程式設定（參數化）已預先設定於幀擷取卡上。

如果您的 Applet 設定包含欄位參數，且相應的 *.mfs 檔案儲存於與 *.mcf 檔案相同的目錄中，則在呼叫此函式時，系統會自動載入這些欄位參數。

Fg_Struct* Fg_InitConfig (const char * Config_Name, unsigned int BoardIndex)

參數：

• Config_Name: 請在此處指定設定檔的名稱與路徑。檔案副檔名始終為 *.mcf。
• BoardIndex: 請在此處（透過其電路板索引）指定您要使用 *.mcf 檔案進行初始化的幀擷取卡。在呼叫 Fg_InitConfig, 影像擷取卡會根據 *.mcf 檔案中指定的 Applet 名稱，以及該檔案中設定的 Applet 配置進行初始化。

正在載入 Applet 設定

您也可以在使用該小程式初始化幀擷取器之後，再載入該小程式的設定。

使用此函式的先決條件：

• 該影像擷取卡已透過函式完成初始化 FG_Init 或作為主節點，搭配 FG_InitEx.
• 儲存於 *.mcf 檔案中的小程式設定，適用於用於初始化幀擷取器的該小程式。（如有疑問，請查看 *.mcf 檔案。小程式的名稱會列於 *.mcf 檔案的前幾行。）

如果您的 Applet 設定中包含欄位參數，且相應的 *.mfs 檔案與 *.mcf 檔案儲存於同一目錄下，則在呼叫此函式時，系統會自動載入這些欄位參數。

在幀擷取卡初始化後載入小程式設定的函式：

int Fg_loadConfig (Fg_Struct *Fg, const char *Filename)

參數：

• Fg: 請在此處指定您要透過 *.mcf 檔案中的小程式設定來設定參數的幀擷取卡（透過板卡索引）。
• Filename: 請在此處指定設定檔的名稱與路徑。檔案副檔名始終為 *.mcf。

資訊

透過函式使用幀擷取卡後，請勿忘記釋放幀擷取卡的資源

int Fg_FreeGrabber (Fg_Struct *Fg)

此函式還會釋放先前透過 Fg_AllocMem().