已知問題：VisualApplets 版本 3.4.0
資訊
若您在已安裝Xilinx Vivado 2017.2 或 2017.3 版本的電腦上安裝 WindowsWindows 10「秋季創作者」更新（版本 1709），Xilinx Vivado 可能無法正常運作。因此，您可能無法編譯使用VisualApplets 所建立的設計。
請依照 Xilinx 技術支援部門提供的解決方案，讓您的Xilinx Vivado 2017.2 或 2017.3 安裝重新正常運作。
資訊
若您安裝上述Windows 10 更新，在使用早於 Vivado 2017.4 版本的Xilinx 工具時，建置流程可能會無法正常運作。因此，您可能無法建置使用VisualApplets 所建立的設計。
對於早於 Vivado 2017.4 的 Vivado 版本，Xilinx 工具鏈的日誌輸出中可能會出現錯誤訊息，指出某些黑盒子實例的內容未定義。至於 ISE，則無法確定Xilinx 工具的版本，導致 FPGA 類型檢查失敗。
Follow the workaround provided by Xilinx Support to make the ISE installation work again (section "ISE 14.7 64-bit - Turning off SmartHeap"). The same workaround can be used for Vivado where you need to perform the file substitution actions in directory <VivadoInstallDir>/ids_lite/ISE/lib/nt64.
一般資訊
| 摘要： | VisualApplets 若同時開啟多個執行個體，僅第一個執行個體會讀取建置設定的配置 |
| 說明： | 當開啟多個VisualApplets 執行個體時，建置設定僅對第一個執行個體為唯讀狀態，其餘執行個體則改為使用預設的建置設定。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 309983 |
| 摘要： | 自動更新通知無法正常運作 |
| 說明： | 在VisualApplets 3.4.0 中，自動更新通知功能無法正常運作。這表示當VisualApplets 有新版本推出時，系統不會自動通知您。 |
| 解決方法： | 請定期並手動至Basler 軟體下載網站，查看VisualApplets 的更新資訊。 |
| 票證編號： | 311264 |
| 摘要： | VisualApplets 使用 Vivado 2024.1 編譯 Applet 時可能會發生當機 |
| 說明： | 安裝 Vivado 2024.1 時，VisualApplets 在從Vivado.exe 偵測 Vivado 版本資訊的過程中可能會當機。 |
| 解決方法： | 若要解決程式凍結的問題，請終止Vivado.exe程序。接著，您可以透過 Tcl 控制台設定不同的工作目錄，例如輸入指令`cd c:`，如此一來即可呼叫建置流程。Basler 不建議使用 Vivado 2024.1 或更高版本，請改用 2023.2 及更早的 Vivado 版本。 |
| 票證編號： | 309714 |
| 摘要： | 對於 mE5 平台和 imaFlex 平台，資源估算值可能過低 |
| 說明： | 對於 mE5 和 imaFlex 平台，某些運算子的資源估算（即 Blob 進行明確的生命週期管理即呼叫 Histogram) 可能會低估已使用區塊 RAM 的數量。視模組配置而定，區塊 RAM 資源的實際使用量可能比此數值高出 50% 以上。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 297790 |
| 摘要： | 無法透過剪貼簿複製內容 |
| 說明： | 無法透過剪貼簿（複製與貼上）將在VisualApplets 3.4.0中開啟的設計內容複製到先前版本的VisualApplets 中開啟的設計中。不過，從先前版本的VisualApplet複製到VisualApplets 3.4.0則是可行的。 |
| 解決方法： | 請將您的設計儲存為舊版*.va檔案格式，在舊版《VisualApplets 》中開啟該檔案，並從中複製內容。 |
| 票證編號： | – |
| 摘要： | 載入至模擬探針檢視器的 RGB 影像可能會被儲存為單色影像（8 位元） |
| 說明： | 在「模擬探針檢視器」中，若 RGB 影像的各色通道值均相同，則會以單色影像（即 8 位元影像）的形式儲存，而非 24 位元影像。 |
| 解決方法： | 若要保留通道，請將圖片儲存為BMP檔案格式。 |
| 票證編號： | 266977 |
| 摘要： | 在 imaFlex CXP-12 Quad 上，自訂操作員無法使用記憶體介面 |
| 說明： | 在 imaFlex CXP-12 Quad 平台上，自訂運算子無法使用記憶體介面。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 240876 |
| 摘要： | Xilinx ISE 建置工具鏈不支援Windows s 11 |
| 說明： | Xilinx 的ISE建置工具鏈不支援Windows 11。因此，無法使用Xilinx 的ISE來建置VisualApplets 設計。 |
| 解決方法： | 若您要為需使用Xilinx ISE 進行編譯的平台建立 Applet，請在Windows 10 環境下安裝VisualApplets 。若您的目標平台受 Vivado 支援，請使用Xilinx Vivado 來編譯 Applet（Vivado 支援Windows 11）。請參閱系統需求，了解 Vivado 支援哪些平台。 |
| 票證編號： | 236990 |
| 摘要： | 在某些Xilinx Vivado版本中，無法為mE5-CL平台編譯Applets |
| 說明： | 無法使用 2020.2 至 2021.1 之間的 Vivado 版本來編譯適用於 mE5-CL 平台的 Applet。 |
| 解決方法： | 此問題已透過Xilinx Vivado 2021.2 版本修復。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 票證編號： | 217879 |
| 摘要： | 將設計轉換至不同的硬體平台時，可能無法取得依賴硬體的操作子函式庫 |
| 說明： | 因此，在將VisualApplets 設計轉換至其他硬體平台時，在某些情況下，可能無法取得目標平台的硬體相關運算子函式庫。 |
| 解決方法： | 要解決此問題，請重新啟動VisualApplets 。 |
| 票證編號： | – |
| 摘要： | Xilinx 建置 Applet 時出現的 Vivado 警告 |
| 說明： | 當您使用 Vivado 的「Xilinx 」工具建置 Applet 時，可能會收到關鍵警告（出現在建置步驟「LinkDesign」中）。這些警告是因「Xilinx 」工具鏈內部的問題所致。此問題已通報給Xilinx ，目前正在進行修復。範例：
CRITICAL WARNING: [Shape Builder 18-137] Cannot obey LUTNM/HLUTNM constraint for instances …/PART1174 and …/PART1175. Illegal to place instance …/PART1174 on site SLICE_X2Y0. The location site type does not match the instance type. Instance …/PART1174 belongs to a shape with reference instance …/PART1175. Shape elements have relative placement respect to each other. The invalid location might result from a constraint on any of the instance in the shape..
|
| 解決方法： | 請忽略這些警告。對於在VisualApplets 中建立的設計而言，此問題並不嚴重。 |
| 票證編號： | – |
| 摘要： | *.va 檔案名稱僅支援 ASCII 字元 |
| 說明： | 在為*.va檔案命名時，僅能使用基於 ASCII 字元的字型；這表示，例如亞洲、西里爾、希臘或阿拉伯字體均不支援用於檔案名稱。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | – |
| 摘要： | 設定僅會儲存於該程式的第一個執行個體中VisualApplets |
| 說明： | 僅有第一個啟動的VisualApplets 實例能夠儲存其設定。所有之後啟動的VisualApplets 實例僅擁有臨時設定，這些設定會在實例關閉時被清除。這涉及的項目包括（例如）建置設定、函式庫設定、系統設定，以及VisualApplets 的一般設定。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 342725 和 347964 |
| 摘要： | 當層級框中的 M 型運算子直接連接至輸入埠時，會發生設計規則檢查錯誤 |
| 說明： | 若您使用階層式方塊，在某些特定情況下，設計規則檢查可能會顯示以下錯誤訊息：「運算子 ABC（階層式方塊）的輸入 XYZ 必須連接至 O 型運算子，例如 NOP。」 原因在於，某些置於階層式方塊內的 M 型運算子無法直接連接至該階層式方塊的輸入埠。此限制僅適用於特定類型的 M 型運算子。 |
| 解決方法： | 您可以在（階層化方塊內）將一個 NOP 運算子置於階層化方塊的輸入埠與 M 型運算子的輸入埠之間，藉此解決此問題。 |
| 票證編號： | – |
| 摘要： | 使用逐行一維模擬模式時出現設計規則檢查錯誤 |
| 說明： | 對於某些在VisualApplets 早期版本中通過「設計規則檢查」的設計，系統可能會報告與最大影像高度相關的連結錯誤。特別是當涉及一維處理，且啟用了新的逐行模擬模式（預設設定）時，此情況可能發生。原因在於，在逐行模式下，某些運算子將輸入連結的最大影像高度傳遞至輸出連結的方式，與先前有所不同。 |
| 解決方法： | 您可以透過切換至傳統模擬模式，或新增SetDimension模組來調整最大影像高度值，藉此解決此問題。 |
| 票證編號： | – |
| 摘要： | 使用逐行一維模擬模式時，運算時間會增加 |
| 說明： | 對於某些設計，模擬的執行時間可能會比VisualApplets 的舊版本長得多。特別是當涉及一維處理、啟用了新的逐行模擬模式（預設設定），且設計中包含大量模擬探針時，可能會發生這種情況。 |
| 解決方法： | 您可以透過切換至傳統模擬模式，或減少模擬探針的數量來解決此問題。 |
| 票證編號： | – |
| 摘要： | CXP 開發套件 (SDK)：使用者必須自行編寫程式來存取 SISO_GenICam 函式庫 |
| 說明： | CXP 的 SDK：對 SISO_GenICam 程式庫的存取不會自動產生，必須由使用者進行程式設計。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | – |
| 摘要： | 提高 FPGA 設計時鐘頻率可能會導致建構速度變慢 |
| 說明： | 提高 FPGA 設計時脈頻率可能會導致建置流程耗時甚久，甚至因無法滿足時序約束而失敗。這在很大程度上取決於「VisualApplets 」設計的內容。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 8513 |
| 摘要： | 模擬探針中不會顯示大圖像 |
| 說明： | 當模擬探針包含非常大的影像時，由於記憶體限制，VisualApplets 可能無法正確顯示這些影像。在此情況下，系統會顯示一張灰階影像（即所有像素的值皆為 205（0xCD））。 |
| 解決方法： | 在模擬時請使用較小的圖片。 |
| 票證編號： | 6822 |
| 摘要： | 模擬功能僅支援小於 2 GB 的圖片 |
| 說明： | 在模擬過程中，任何影像的內部緩衝區大小均限制為 2 GB。若模擬所用的影像大於 2 GB，系統將顯示錯誤訊息並中止模擬。 |
| 解決方法： | 進行模擬時，請使用小於 2 GB 的影像。 |
| 票證編號： | 240989 |
Library Blob
Blob_Analysis_1D 運算子
| 摘要： | 當 Blob_Analysis_1D 運算子 設定 object size exceeds maximum 標記「與預期不符」 |
| 說明： | 若某個物件因超過由 max_object_height_bits 參數，對應的 object size exceeds maximum 該標記設定在截斷的物件中，而非前一個物件中。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 9685 |
| 摘要： | 當 Blob_Analysis_1D 運算子並未設定該 label overflow 旗幟 |
| 說明： | 當 label overflow 表示所有標籤均已使用且無法為當前物件加上標籤的標誌，絕不會被設定。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 9691 |
| 摘要： | 當 Blob_Analysis_1D 運算子允許每行比定義數值少 20 個標籤 |
| 說明： | 透過 Label_bits 該參數減少了 20 個標籤。例如，如果 Label_bits 若設定為 5，則僅有 12 個（2^5 - 20）標籤可用，而非預期的 32 個（2^5）。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 9688 |
| 摘要： | 《》的模擬 Blob_Analysis_1D 運算子不等於硬體行為 |
| 說明： | 物件特徵輸出的順序在硬體與軟體中可能有所不同。這是因為硬體輸出取決於資料的時序，而此時序無法在VisualApplets 中進行模擬。此外，FlushI 輸入與影像資料輸入是異步的，因此可能無法以貼近實際的方式模擬已完成的輸出幀。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 7709 |
Library Color
| 摘要： | 某些色彩轉換的效果與預期不符 |
| 說明： | 該的營運商 彩色 應謹慎使用此函式庫：某些顏色轉換的結果可能與使用者預期不符：
- HSI2RGB 將 HSL 轉換為 RGB，
- RGB2YUV 將 RGB 轉換為 YCbCr，
- XYZ2LAB 根據以下定義使用常數： www.easyrgb.com
|
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | – |
| 摘要： | 負變換係數的限制條件 |
| 說明： | 當 ColorTransform 該運算子僅在輸入格式為有符號格式，或係數為靜態時，才支援負的轉換係數。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 251344 |
BAYER5x5Linear 運算子
| 摘要： | VisualApplets 中的資源估算，適用於 BAYER5x5Linear 與以下估算不同：Xilinx |
| 說明： | BAYER5x5Linear：在某些情況下，VisualApplets 中此運算子的資源估算（於對話框 FPGA Resource Usage) 可能與「Xilinx 」工具在完成佈置與佈線後所顯示的估算結果有所不同。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 6426 |
Library Compression
JPEG_Encoder 運算子
| 摘要： | 運算子的輸出傳遞 JPEG_Encoder 比實際影像資料傳輸更早開始 |
| 說明： | 操作員：為了優化影像吞吐率（頻寬），操作員會在啟用標頭生成功能後立即輸出標頭——即使影像資料尚未抵達操作員的輸入端。如此一來，由於標頭是預先傳輸的，因此標頭資料的傳輸便不會中斷影像資料的傳輸。 此做法的缺點在於，操作器的輸出傳輸會比實際影像資料的傳輸更早開始。這在特定情況下可能會造成困擾：
如果您正在使用 SourceSelector 運算子緊接在……之後 JPEG_Encoder: SourceSelector 操作員一拿到標頭資料，便會將該部分處理過的幀進行註冊。因此，如果 SourceSelector 已切換為從 JPEG_Encoder, SourceSelector 無法切換至任何其他來源，因為它總是偵測到未完成的幀。此外，當啟用標頭產生功能時，且 SourceSelector 從另一個來源切換到 JPEG_Encoder 通道中，第一張圖片遺失了。 |
| 解決方法： | 若在 eVA 裝置上進行作業，請務必在開始感測器資料傳輸之前，確認輸出端已具備接收資料傳輸的能力。 |
| 票證編號： | – |
Library Debugging
ImageFlowControl 運算子
| 摘要： | 溢流事件後框架受損 |
| 說明： | 使用 ImageFlowControl 在虛幀產生模式下，該運算子可能會導致輸出幀受損。這種情況通常發生在溢出事件之後，當系統發送一系列虛幀以補償丟失的幀時。 |
| 解決方法： | 請將 `VisualApplets ` 更新至 3.6.0 版。此問題已在 `VisualApplets ` 3.6.0 版中修復。 |
| 票證編號： | 248227 |
Library Filter
DILATE 運算子
| 摘要： | 在《》的硬體實作中，DILATE 操作員，結構元素已旋轉 |
| 說明： | 該的硬體實作 DILATE 該運算子的運作方式與模擬結果及文件所述有所不同。在硬體實作中，結構元件會被旋轉。 |
| 解決方法： | 請將 `VisualApplets ` 更新至 3.6.0 版。此問題已在 `VisualApplets ` 3.6.0 版中修復。 |
| 票證編號： | 267460 |
FIRKernelNxM 運算子
| 摘要： | 運算子 FIRKernelNxM 可能會導致處理錯誤 |
| 說明： | 當 FIRKernelNxM 若發生以下情況，該運算子可能會導致處理錯誤： EdgeHandling 當參數設定為常數、欄數 > 2*並行度、核心欄數為偶數，且並行度 > 1 時，可在影像的左邊緣觀察到錯誤，該處畫面內核心位置所使用的像素資料不正確。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 2939 |
觸發運算子
| 摘要： | 觸發運算子可能會導致觸發輸出線出現尖峰 |
| 說明： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出端產生突波。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | – |
Library Memory
RamLUT運算子
| 摘要： | 將初始化資料寫入 RamLUT 在資料擷取過程中，操作員不會對 imaFlex 平台產生影響 |
| 說明： | 將初始化資料寫入 RamLUT 在資料擷取過程中，此運算子對 imaFlex 平台並無影響。僅在停止資料擷取時，才可設定記憶體內容。 |
| 解決方法： | 在將初始化資料寫入該檔案之前，請停止這項取得操作 RamLUT 運算子。或者將VisualApplets 更新至 3.6.0 版，因為此問題已在VisualApplets 3.6.0 中修復。 |
| 票證編號： | 319280 |
LineMemory 運算子
| 摘要： | 執行期間無法編輯動態參數 |
| 說明： | 在使用VisualApplets 3.4.0 及 3.4.1 版本所建構的小程式中，無法修改動態參數 XOffset 進行明確的生命週期管理即呼叫 XLength 的 LineMemory 在執行期間的運算子。 |
| 解決方法： | 此問題已在VisualApplets 版本 3.5.0 中修復。請將您的VisualApplets 版本更新至 3.5.0。 |
| 票證編號： | 312662 |
ImageBufferMultiRoiDyn 運算子
| 摘要： | 小圖檔的時序錯誤 |
| 說明： | 當 ImageBufferMultiRoiDyn 當輸入影像非常小時，此運算子可能會導致時序錯誤。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | – |
ImageSequence 運算子
| 摘要： | 由運算子引起的建置錯誤 ImageSequence |
| 說明： | 當 ImageSequence 該運算子可能會導致建置錯誤（時序錯誤）。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票證編號： | 2422 |