VisualApplets
Operator Reference

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

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

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

此參數用於指定物件的最大高度。舉例來說， 若高度設定為 10 位元，則物件的高度不得超過 1024 影像行。

若某個物件超過此限制，則會被分割成兩個或更多 個獨立的物件。若發生此情況，端口 ErrorFlagsO 的第 3 位元處的錯誤標誌將與恢復的物件一同被設定。

選取最大輸出幀大小，即單一輸出幀中 的物件最大數量。

最大輸出幀大小透過參數 「max_output_frame_size」指定。若物件數量超過此大小， 運算子可選擇產生新幀，或捨棄超出部分的物件。 生成新幀將導致幀結束，亦即該幀已 完成。若物件被捨棄，該運算子將在 ErrorFlagsO 埠的第 2 位元處輸出錯誤標誌，並隨同該幀的最後一個有效物件一併輸出。

請注意，在執行「flush」指令時，系統也會產生一個新的幀。

此參數用於抑制因清空 狀況且無物件資料所導致的空輸出幀。

詳細的時序圖可參閱〈輸出幀的產生 — 清空幀、空幀與資料捨棄〉一節。

每個物件的「line_marker」會輸出至「LineMarkerO」。位元寬度 由輸入連結 LineMarkerI 決定。若未使用線標記， 則位元寬度會設定為 1，且其輸出為常數零。

邊界框表示剛好包覆物件的最小軸對齊矩形。每個座標值都是相對於影像的左上角。Bounding Box X0 表示每個物件的最低 x 座標。它會輸出於「BoundingX0O」。Bit Width 由輸入影像決定。若未使用邊界框，則 Bit Width 會設為 1 個 bit，且其輸出為固定的零。

邊界框表示剛好包覆物件的最小軸對齊矩形。每個座標值都是相對於影像的左上角。Bounding Box X1 表示每個物件的最高 x 座標。它會輸出於「BoundingX1O」。Bit Width 是由輸入影像決定。若未使用邊界框，則 Bit Width 會設為 1 個 bit，且其輸出為固定的零。

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

此功能可取代線條標記。不過，線條 標記提供更多可能性，並能實現複雜的配置。

此功能會於「BoundingY0O」輸出。位元寬度由 輸入影像決定。若未使用邊界框，則位元寬度會設定為 1，且 其輸出為恆定值 0。

在 1D 運算子中（有別於 2D 運算子），邊界框 y1 代表物件的高度。其輸出位於「BoundingY1O」。 位元寬度 由輸入影像決定。若未使用邊界框，則位元寬度 將設定為 1，且其輸出為常數 0。

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

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

只有在參數「area_mode」設為「use_area_with_specified_bits」時，此參數才會啟用。如果物件的面積大於所選 bits 允許的大小，blob analysis 將會在輸出連結「ErrorFlagsO」的位元編號 4 輸出溢位旗標。

有關重心（center of gravity）的說明，請參閱 '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"。如果偵測到溢位（overflow），算子將會在輸出連結 "ErrorFlagsO" 的第 5 位元輸出 ONE。

有關重心（center of gravity）的說明，請參閱 '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"。如果偵測到溢位（overflow），算子將會在輸出連結 "ErrorFlagsO" 的第 6 位元輸出 ONE。

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

若選取此功能，可依據所選的鄰域，透過 參數「contour_length_bits_orthogonal_connected」及 「contour_length_bits_diagonal_connected」來選擇所需的位元數。 若選取 4-連通鄰域，則輪廓長度僅能 在正交方向上計算。若選取 8-連通鄰域， 則輪廓長度將在正交及對角方向上計算。

若將「contour_length_mode」設定為「contour_length_used」，則可在此 選擇用以表示正交相連像素等高線長度所需的 位元數。

若將「contour_length_mode」設定為「contour_length_used」，則可在此 選擇用以表示對角相鄰像素輪廓長度所需的位元數。 此功能僅在選取 8 鄰域時才可用。 否則，此參數將被停用。

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