VisualApplets
Operator Reference

Library: Memory 運算子

此操作員允許將影像檔案 從主機電腦上傳至幀擷取卡，該影像將持續輸出並用作 影像來源。此處將影像檔案用作通用資料容器。因此， 上傳的影像可包含任何資料，例如係數。 所有係數影像必須 具有相同的像素寬度和高度，但格式可以完全不同。例如， 連結 0 的係數影像可以是 8 位元灰階格式；連結 1 提供的 影像可以是 RGB16 格式；而連結 2 則可以是二進位影像。所有係數影像皆 儲存於 幀擷取卡 RAM (DRAM)中。需配置一個類型為RAM的 VisualApplets 資源。更多 資訊請參閱「裝置資源的分配」。關於此運算子的延遲資訊，請參閱表 46，「庫記憶體中各運算子的個別延遲」。

	imaFlex CXP-12 Quad 及imaFlex CXP-12 Penta 平台不支援CoefficientBuffer
	imaFlex CXP-12 Quad 及imaFlex CXP-12 Penta 平台不支援CoefficientBuffer。 範例「使用ImageInjector載入Test Images 的功能範例 」 說明了如何在 imaFlex CXP-12 Quad 或imaFlex CXP-12 Penta 上， 透過ImageInjector 運算子來替代 CoefficientBuffer運算子的功能，作為測試影像來源。 範例「2DShading Correction / 使用 RamLUT 運算子進行平面場校正」示範了如何在 2D 陰影校正中，使用RamLUT取代CoefficientBuffer。

連結的數量對應於 儲存於 CoefficientBuffer 中的係數影像數量。係數影像只能在 未執行任何影像擷取作業時，透過軟體上傳至 FPGA 緩衝區。此 操作是透過寫入LoadCoefficients 參數來實現的。

該運算子的輸出埠以 同步方式運作。第一個影像像素的傳輸會在所有輸出埠上 精確地於同一時刻開始。若所有影像均已傳輸至接收運算子， CoefficientBuffer 便會再次以同步方式輸出這些影像。

	模擬期間的行為
	操作員各鏈路上的影像會 同時輸出。在一個模擬步驟中，操作員在每條鏈路上最多輸出一張 影像。 若在某個模擬步驟中，所有儲存的影像（每條 鏈路各一張）均已轉發至接收方操作員，亦即未發生 阻塞的情況，則在接下來的 模擬步驟中，將轉發相同的輸出（每條鏈路一張影像）。

CoefficientBuffer 亦支援 感興趣區域 (RoI) 管理。RoI 由 4 個參數 XOffset、XLength、 YOffset 及 YLength 定義。XOffset 與 YOffset 定義 RoI 的左上角，即 以像素為單位的起始座標。 RoI 的尺寸不得超過 由參數 BufferWidth和 BufferHeight 所定義的儲存係數影像尺寸。RoI 可在擷取過程中動態更新， 或在無擷取任務執行時，透過將所有 4 個 RoI 座標 參數設定為新值，並寫入 UpdateROI 參數。請注意，XLength 必須 同時符合鏈結並行度的粒度要求，即 XLength 模 LinkParallelism = 0。

對於每個輸出鏈路，一個係數影像檔案 會儲存於緩衝區中，也就是說，鏈路 0 將提供係數影像 0。這些 係數影像必須在擷取開始前載入至 CoefficientBuffer 中。 係數影像必須儲存於由參數 CoefficientFile N 所指定的檔案中。N 分別代表連結編號或 係數影像編號。係數檔案必須以 TIF 格式編碼。

BufferWidth指定儲存於 CoefficientBuffer 中的所有係數 圖像的寬度（以像素為單位）。

BufferHeight指定由 CoefficientBuffer 管理之所有係數 影像的高度（單位為像素）。 BufferWidth與 BufferHeight決定所有輸出連結的 最大輸出影像尺寸。

若要建立灰階連結，必須 使用灰階圖像檔案。若要建立彩色連結，則必須使用 RGB 圖像檔案。

若連結的位元寬度高於 影像檔案的位元寬度，則操作員將使用多個影像檔案像素來產生 輸出像素。 舉例來說，一個 22 位的連結在 8 位元圖像 檔案中將需要 3 個像素。因此，圖像檔案的寬度必須是參數 BufferWidth 的 3 倍。

若連結的位元寬度小於 影像檔案的位元寬度，則此運算子將僅使用輸入影像檔案的 低位元。例如，一個 8 位元影像檔案與一個 3 位元連結，將使用該 檔案的第 0、1 和 2 位元。

使用 16 位元 TIF 檔案時應格外謹慎。

參數 LoadCoefficients 用於在 影像擷取開始之前，將係數影像載入緩衝區。此 載入作業會由寫入週期或將此參數設為 1 所觸發。將此參數寫入 0 則 無效。

「參數更新 RoI」用於在 影像擷取執行期間，或當未擷取任何影像時， 動態更新當前的 RoI。 在寫入此參數之前，必須先透過 4 個 RoI 座標參數指定新的 RoI。 寫入的值不會影響更新過程，僅有 寫入週期才會觸發更新，也就是說，寫入的值可以是 0 或 1。

參數 XOffset 指定從 影像左邊緣到 RoI 第一欄的 水平方向偏移量。該 指定值以像素為單位，且不得超過 BufferWidth-1 的值。

Parameter XLength specifies the length of the RoI in horizontal direction in pixels. The specified value must not exceed BufferWidth and must be divisible by the output link parallelism. Also the following constraint must be met: XOffset + XLength <= BufferWidth.

參數 YOffset 指定從 影像頂部邊界到 RoI 第一行在垂直方向上的偏移量。YOffset 必須 以像素為單位指定，且不得超過 BufferHeight-1。

Parameter YLength specifies the length of the RoI in vertical direction in pixels. The length must not exceed BufferHeight. Furthermore, the following constraint must be met: YOffset + YLength <= BufferHeight.

參數 CoefficientFile N 指定 以 TIF 格式儲存的連結 N 的係數圖像之檔案名稱。

注意

鏈路 0 的並行性決定了所有其他鏈路的並行性。 設定連結 0 的並行度時，會將 XLength 值修正為 可被新並行度整除的數值。此處理方式在 未來的 VA 版本中可能會有所不同。這表示當您在 連結並行度屬性的旋轉方塊中使用上下按鈕時，XLength 可能會被修改。 因此，建議在所有連線均已 連接並設定完畢後，檢查 XLength 的設定。 設定參數 BufferWidth 和 BufferHeight 可修正 RoI 的座標，以防其中任何座標超出新影像的尺寸範圍。這些 座標將被修正為最接近的有效數值。 CoefficientBuffer 支援 2D、1D 及 0D 影像。對於 1D 和 0D 影像，該運算子會連續提供係數影像（這些影像以 2D 影像的形式儲存），且不會分別產生幀尾或 行尾標記。 該運算子使用 1 個 DDRRAM 銀行。因此， 係數影像的儲存空間受限於每個運算子 1 個 RAM 銀行的容量（例如， mE5 板卡上的 256MByte）。此外， 由於 DDRRAM 的內部格式化，實際儲存空間可能會 比物理儲存空間稍小一些。已使用的儲存空間 與連結格式以及各連結的像素寬度相關。在 最佳情況下，所有連結像素寬度的總和應能被 一個 RAM 銀行的容量（即在 mE5 上為 256）。在此 情況下，所有係數影像皆可共同儲存於單一記憶體銀行中。在 任何其他情況下，儲存空間的使用效率將低於最佳狀態。請檢查 裝置資源 以獲取更多關於硬體平台的資訊。

頻寬最佳化

流經使用 Frame Grabber RAM (DRAM) 之 operator 的理論頻寬 [bits/second] 是根據下列公式計算：

然而，由於 DRAM 效率的關係，實際頻寬總是小於理論頻寬。

流經運算子的 最大頻寬 是在 Bit Width 與 Parallelism 的乘積等於內部 RAM Port Width x 2 時達到（適用於唯讀參數）。

	平台特定值
	RAM Port Width 與 System Clock 因平台而異。如需關於您個人平台的詳細資訊，請參閱 Device Resources。

Supported Link Format

Link Parameter	輸出連結 O[n]
Bit Width	[1, 64]
Arithmetic	{unsigned, signed}
Parallelism	any
Kernel Columns	1
Kernel Rows	1
Img Protocol	{VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format	any
Color Flavor	any
Max. Img Width	緩衝區寬度
Max. Img Height	緩衝區高度

	對於無符號輸入，輸出位寬的範圍為 [1, 64]。至於 有符號輸入，其範圍為 [2, 64]。對於無符號色彩輸入，其範圍為 [3, 63]；至於有符號色彩輸入，其範圍為 [6, 63]。
	位元寬度與並行度的乘積不得超過 原生 RAM 資料寬度。請檢查 裝置資源 以取得更多 資訊。