VisualApplets
Operator Reference

Operator Library: Memory

此運算子允許將主機 PC 的影像檔案上傳至擷取卡，以便連續輸出並作為影像來源使用。此處的影像檔案是用作通用的資料容器。因此，上傳的影像可以包含任何資料，例如係數。所有係數影像必須具有相同的像素寬度和高度，但可以採用完全不同的格式。例如，連結 0 的係數影像可以是 GRAY 8 bit 格式。連結 1 可以提供 RGB16 格式的影像。而連結 2 可以是二進位影像。所有係數影像都儲存在 Frame Grabber RAM (DRAM) 中。這需要一個類型為 RAM 的 VisualApplets 資源。請查看「Allocation of Device Resources」以取得更多資訊。關於運算子的延遲資訊，請參閱「表 46：Library Memory 中運算子的各別延遲」。

	imaFlex CXP-12 Quad 和 imaFlex CXP-12 Penta 平台不支援 CoefficientBuffer
	imaFlex CXP-12 Quad 和 imaFlex CXP-12 Penta 平台不支援 CoefficientBuffer。「使用 ImageInjector 載入測試影像的功能範例」範例展示了如何在 imaFlex CXP-12 Quad 或 imaFlex CXP-12 Penta 上使用 ImageInjector 運算子來替代 CoefficientBuffer 運算子的測試影像來源功能。 範例「使用 RamLUT 運算子進行 2D Shading Correction / 平場校正」展示了如何使用 RamLUT 代替 CoefficientBuffer 來進行 2D shading correction。

連結的數量對應於儲存在 CoefficientBuffer 中的係數影像數量。在未執行影像擷取的情況下，只能透過軟體將係數影像上傳到 FPGA 緩衝區。這是透過寫入參數 LoadCoefficients 來完成的。

運算子的輸出連接埠以同步方式運作。第一個影像像素的傳輸在所有輸出連接埠上完全於同一時刻開始。如果所有影像都已傳輸至接收運算子，CoefficientBuffer 會開始再次同步輸出影像。

	模擬期間的行為
	運算子連結上的影像會同時輸出。在一個模擬步驟中，運算子在每個連結上最多輸出一個影像。如果在模擬步驟中，所有儲存的影像（每個連結一個）都已轉發至接收運算子（即未發生阻擋），則相同的輸出（每個連結一個）將在接下來的模擬步驟中轉發。

CoefficientBuffer 也支援感興趣區域 (RoI) 管理。RoI 由 4 個參數 XOffset、XLength、YOffset 和 YLength 定義。XOffset 和 YOffset 定義 RoI 的左上角，即以像素為單位的起始座標。RoI 的尺寸不得超過由參數 BufferWidth 和 BufferHeight 定義的已儲存係數影像尺寸。RoI 可以在擷取期間動態更新，或者在未執行擷取時，透過將所有 4 個 RoI 座標參數設定為新值並寫入參數 UpdateROI 來更新。請注意，XLength 還必須符合連結 Bit Width 的粒度，即 XLength 對 LinkParallelism 取餘數等於 0。

對於每個輸出連結，緩衝區中都會儲存一個係數影像檔案，即係數影像 0 將在連結 0 上提供。係數影像必須在擷取開始之前載入到 CoefficientBuffer 中。係數影像必須儲存在由參數 CoefficientFile N 指定的檔案中。N 分別代表連結編號或係數影像編號。係數檔案必須以 TIF 格式編碼。

BufferWidth 指定儲存在 CoefficientBuffer 中的所有係數影像的寬度，單位為像素。

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

對於灰階連結，必須使用灰階影像檔案。對於彩色連結，必須使用 RGB 影像檔案。

如果連結的 Bit Width 大於影像檔案的 Bit Width，運算子將使用多個影像檔案像素來產生輸出像素。例如，22 bit 的連結將需要 8 bit 影像檔案中的 3 個像素。因此，影像檔案的影像寬度必須比參數 BufferWidth 大 3 倍。

如果連結的 Bit Width小於影像檔案的 Bit Width，運算子將僅使用輸入影像檔案的較低位元。例如，8 bit 的影像檔案和 3 bit 的連結將使用檔案的第 0、1 和 2 位元。

應謹慎使用 16 bit TIF 檔案。

參數 LoadCoefficients 用於在影像擷取開始之前，將係數影像載入到緩衝區中。載入是由對此參數的寫入週期或值 1 觸發的。寫入值 0 沒有作用。

參數 UpdateROI 用於在影像擷取正在執行或未擷取影像時，動態更新目前的 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 的 Bit Width決定了所有其他連結的 Bit Width。 設定連結 0 的 Bit Width會修正 XLength 值，使其能被新的 Bit Width整除。這在未來的 VA 版本中可能會以不同的方式處理。這意味著當使用連結 XLength 屬性微調方塊中的向上/向下按鈕時，XLength 可能會被修改。因此，建議在連接並指定所有連結後，檢查 XLength 設定。 如果 BufferWidth 和 BufferHeight 參數的設定導致任何座標超過新的影像尺寸，則會修正 RoI 座標。座標將被修正為最接近的有效值。 CoefficientBuffer 支援 2D、1D 和 0D 影像。若是 1D 和 0D 影像，運算子將持續提供以 2D 影像儲存的係數影像，而不會產生影格結束或行結束標記。 此 Operator 正在使用 1 個 DDRRAM 記憶庫。因此，係數影像的儲存空間僅限於一個 RAM 記憶庫的容量（例如在 mE5 機板上為 256MByte）每 1 個 operator。此外，由於 DDRRAM 的內部格式化，實際的儲存空間可能會比實體儲存空間略少一些。所使用的儲存空間分別與連線格式以及每個連線的像素寬度有關。在最佳情況下，所有連線像素寬度的總和可以被一個 RAM 記憶庫的容量（即 mE5 上的 256）整除。在這種情況下，所有係數影像可以一起儲存 在一個 Memory 銀行中。在任何其他情況下，儲存空間的利用率將會次佳。請查看 Device Resources 以了解更多關於硬體平台的資訊。

頻寬最佳化

通過使用 Frame Grabber RAM (DRAM) 之運算子的理論頻寬 [位元/秒]，是根據下列公式計算：

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

當 Bit Width 與 Parallelism 的乘積等於內部 RAM Port Width x 2（適用於唯讀參數）時，穿過 operator 的 maximum bandwidth 達到最大值。

	平台特定值
	RAM Port Width 和 System Clock 是平台特定的。有關您個別平台的詳細資訊，請參閱 Device Resources。

支援的 Link 格式

Link Parameter	輸出 Link 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	BufferWidth
Max. Img Height	BufferHeight

	對於無號輸入，輸出 Bit Width 的範圍是 [1, 64]。對於有號輸入，範圍是 [2, 64]。對於無號彩色輸入，範圍是 [3, 63]，而對於有號彩色輸入，範圍是 [6, 63]。
	Bit Width 與 Parallelism 的乘積不得超過原生 RAM 資料寬度。請參閱 Device Resources 以取得更多資訊。