VisualApplets
Operator Reference

此參數設定內部用於標記物件的位元數。它也會影響由 2^label_bits 決定的兩條影像行內可能共存的最大物件數。請注意，blob 分析所需的 Memory 資源幾乎會隨著每個額外位元而加倍。此參數的良好數值範圍在 7 到 9 位元之間，這對於幾乎所有應用來說都應該足夠。

如果偵測到此位址空間溢位，運算子會在連接埠 "ErrorFlagsO" 的第 0 和 1 位元輸出錯誤旗標。這些旗標會在偵測到溢位時設定，並在輸出畫格結束時重設。

選取 Object Detection 所需的鄰域。如需像素鄰域的詳細說明，請參閱 'Definition'。

需要此參數來指定物件的最大高度。例如，10 bit 的高度將不允許超過 1024 影像行的物件。

如果物件超過此限制，它將會被分割成兩個或更多個分離的物件。若發生此情況，ErrorFlagsO 連接埠第 3 位元的錯誤旗標將會與恢復的物件一同被設定。

選擇最大輸出影格大小，也就是單一輸出影格中的最大物件數量。

最大輸出畫面大小是透過參數 "max_output_frame_size" 來指定的。如果物件數量超過此大小，算子可以產生新的畫面，或者捨棄超出範圍的物件。產生新畫面會導致畫面結束，亦即該畫面已完成。如果捨棄物件，算子會在 ErrorFlagsO 連接埠的第 2 個 bit 輸出錯誤旗標，並隨附該畫面的最後一個有效物件。

請注意，使用 flush 輸入也會產生新的畫面。

此參數用於抑制因 flush 條件且無物件資料而產生的空白輸出畫面。

詳細的時間圖表可在 'Generation of Output Frames - Flush, Empty Frames, Discarding Data' 中找到。

每個物件的 "line_marker" 會輸出於 "LineMarkerO"。Bit Width 由 LineMarkerI 輸入連接連線決定。如果未使用 line marker，Bit Width 將設為 1，且其輸出固定為零。

邊界方框（bounding box）表示適合包覆該物件的最小軸平行矩形。每個座標值皆相對於影像的左上角。Bounding Box X0 表示每個物件的最低 x 座標。它會輸出於「BoundingX0O」。Bit Width 由輸入影像決定。如果未使用邊界方框，則 Bit Width 會設為一個 bit，且其輸出為固定的 0。

邊界方框（bounding box）表示適合包覆該物件的最小軸平行矩形。每個座標值皆相對於影像的左上角。Bounding Box X1 表示每個物件的最高 x 座標。它會輸出於「BoundingX1O」。Bit Width 是由輸入影像決定。如果未使用邊界方框，則 Bit Width 會設為一個 bit，且其輸出為固定的 0。

邊界方框 y0 代表每個物件的最低 y 座標。此座標基於算子的內部 Counter。它從處理的第一個影像行開始計數。其最大值等於透過參數 max_object_height_bits 設定的最大高度。發生溢位後，Counter 會重新從零開始。

此功能可用來取代 line marker。不過，line marker 提供更多可能性，並允許進行複雜的設定。

該功能會輸出於 "BoundingY0O"。Bit Width 由輸入影像決定。如果未使用邊界方框，Bit Width 將設為 1，且其輸出固定為零。

使用 1D 算子時（與 2D 算子相反），邊界方框 y1 代表物件的高度。它會輸出於 "BoundingY1O"。Bit Width 由輸入影像決定。如果未使用邊界方框，Bit Width 將設為 1，且其輸出固定為零。

物件的面積定義為所有物件前景像素的總和。此參數用於選擇所需的面積模式。若選擇「use_area_with_maximum_required_bits」，運算子會自動決定物件可能的最大尺寸所需的 bit。物件可能的最大尺寸取決於輸入連接鏈 I 處的最大寬度與高度。當影像的所有像素皆由前景值組成（即整個白色輸入影像為一個大物件時），即可達到物件的理論最大值。

如果使用者能確信物件的面積不會大於指定的值，則可以進行此參數設定。如果已知最大物件尺寸，請選擇「use_area_with_specified_bits」。使用「area_bits」參數來指定 bit 數量。如果完全不需要面積，請選擇「area_not_used」。在「area_not_used」模式下，Bit Width 會設為 1，且其輸出為固定的 0。

此參數僅在「area_mode」參數設為「use_area_with_specified_bits」時啟用。如果物件面積大於所選 bit 允許的大小，斑點分析將會在輸出連接埠「ErrorFlagsO」的第 4 個 bit 輸出一個溢位旗標。

有關重心的說明，請參閱 'Center of Gravity'。

請注意，進行 blob 分析後，必須將輸出除以面積以獲得正確的結果。

如果參數設為 "use_cX_width_maximum_required_bits"，運算子將自動決定輸出位元數。如果使用大型輸入影像，所需的位元數可能會非常高。

如果參數值使用 "use_cX_with_specified_bits"，則位元數是可以調整的。

如果不需要 x 方向的重心，可以透過選擇 "cX_not_used" 來關閉。

如果 "center_of_gravity_x_mode" 設為 "use_cX_with_specified_bits"，則可以在此變更位元。否則，此參數將會停用。

如果手動設定 x 方向重心的位元數，此參數將會啟用並可設為 "used"。如果偵測到溢位，運算子將在輸出連線 "ErrorFlagsO" 的第 5 個位元輸出 1。

有關重心的說明，請參閱 'Center of Gravity'。

請注意，進行 blob 分析後，必須將輸出除以面積以獲得正確的結果。

如果參數設為 "use_cY_width_maximum_required_bits"，運算子將自動決定輸出位元數。如果使用大型輸入影像，所需的位元數可能會非常高。

如果參數值使用 "use_cY_with_specified_bits"，則位元數是可以調整的。

如果不需要 y 方向的重心，可以透過選擇 "cY_not_used" 來關閉。

如果 "center_of_gravity_y_mode" 設為 "use_cY_with_specified_bits"，則可以在此變更位元。否則，此參數將會停用。

如果手動設定 y 方向重心的位元數，此參數將會啟用並可設為 "used"。如果偵測到溢位，運算子將在輸出連線 "ErrorFlagsO" 的第 6 個位元輸出 1。

物件的輪廓長度包含所有邊緣，甚至是孔洞處的邊緣。如需詳細說明，請參閱 'Contour Length'。

如果選取此功能，所需的 bit 可以根據所選的鄰域，透過參數 "contour_length_bits_orthogonal_connected" 和 "contour_length_bits_diagonal_connected" 來選擇。如果選取 4 連通鄰域，則只能在正交方向上決定輪廓長度。如果選取 8 連通鄰域，則會在正交和對角方向上決定輪廓長度。

如果將 "contour_length_mode" 設為 "contour_length_used"，可以在此選擇表示正交連通像素的輪廓長度所需的 bit。

如果將 "contour_length_mode" 設為 "contour_length_used"，可以在此選擇表示對角連通像素的輪廓長度所需的 bit。這只有在選取 8 連通鄰域時才有可能。否則，此參數將會停用。

輪廓長度可能會導致溢位。如果使用此旗標，若發生溢位，將會在連接埠 "ErrorFlagsO" 的第 7 位元設定一個錯誤旗標。