SearchWin屬性
執行階段專用
套用至
視覺物件：Blob, BoxFinder, CodeReader, ColorMatch, Contour, CornerFinder, Correlation, DefectFinder, Geometric, ImageOp, LineFinder, OCR, Text
說明
定義搜尋視窗的位置及尺寸。
用途
SearchWinType ≠ Arc時
VGet Sequence.Object.SearchWin, LeftVar, TopVar, WidthVar, HeightVar
VSet Sequence.Object.SearchWin, Left, Top, Width, Height
- Sequence
- 序列名稱或表示序列名稱的字串變數
- Object
- 物件名稱或表示物件名稱的字串變數。物件必須存在於指定序列中。
- LeftVar
- 表示搜尋視窗左上角之左側位置的整數變數（單位：像素）。從SearchWinLeft屬性獲取值，或設定值。
- TopVar
- 表示搜尋視窗左上角之頂部位置的整數變數（單位：像素）。從SearchWinTop屬性獲取值，或設定值。
- WidthVar
- 表示搜尋視窗寬度的整數變數（單位：像素）。從SearchWinWidth屬性獲取值，或設定值。
- HeightVar
- 表示搜尋視窗高度的整數變數（單位：像素）。從SearchWinHeight屬性獲取值，或設定值。
- Left
- 表示搜尋視窗新的左上角之左側位置的整數值或運算式（單位：像素）
- Top
- 表示搜尋視窗新的左上角之頂部位置的整數值或運算式（單位：像素）
- Width
- 表示搜尋視窗新寬度的整數值或運算式（單位：像素）
- Height
- 表示搜尋視窗新高度的整數值或運算式（單位：像素）
SearchWinType = Arc時
VGet Sequence.Object.SearchWin, CenterXVar, CenterYVar, RadiusInnerVar, RadiusOuterVar
VSet Sequence.Object.SearchWin, CenterX, CenterY, RadiusInner, RadiusOuter
- Sequence
- 序列名稱或表示序列名稱的字串變數
- Object
- 物件名稱或表示物件名稱的字串變數。物件必須存在於指定序列中。
- CenterXVar
- 表示搜尋視窗X中心位置的整數變數（單位：像素）。從SearchWinCenterX屬性獲取值，或設置值。
- CenterYVar
- 表示搜尋視窗Y中心位置的整數變數（單位：像素）。從SearchWinCenterY屬性獲取值，或設置值。
- RadiusInnerVar
- 表示搜尋視窗的內圓週半徑大小的整數變數（單位：像素）。從SearchWinRadiusInner 屬性獲取值，或設置值。
- RadiusOuterVar
- 表示搜尋視窗的外圓週半徑大小的整數變數（單位：像素）。從SearchWinRadiusOuter屬性獲取值，或設置值。
- CenterX
- 表示搜尋視窗中心X座標的整數值或運算式（單位：像素）
- CenterY
- 表示搜尋視窗中心Y座標的整數值或運算式（單位：像素）
- RadiusInner
- 表示搜尋視窗的內圓週半徑大小的整數值或運算式（單位：像素）
- RadiusOuter
- 表示搜尋視窗的外圓週半徑大小的整數值或運算式（單位：像素）
數值
所有數值單位皆為像素。如需精確的數值資料，請參閱以下內容。
- SearchWinLeft屬性
- SearchWinTop屬性
- SearchWinWidth屬性
- SearchWinHeight屬性
- SearchWinCenterX屬性
- SearchWinCenterY屬性
- SearchWinRadiusInner屬性
- SearchWinRadiusOuter屬性
詳細說明
加上SearchWin屬性可方便從SPEL+語言存取SearchWinTop、SearchWinLeft、SearchWinWidth、SearchWinHeight屬性及SearchWinCenterX、SearchWinCenterY、SearchWinRadiusInner、SearchWinRadiusOuter屬性。SearchWin屬性允許以1個函數呼叫進行四種屬性設定。使用者可能會希望以動態方式定義搜尋視窗的位置及尺寸，因此建立了SearchWin屬性。
即使視窗旋轉，Left及Top數值也可指定視窗左上角的位置。
SearchWinRadiusInner及SearchWinRadiusOuter使用最初實數值，但僅在此屬性中執行VSet及VGet時使用整數值。
請勿將SearchWin數值設定過大。若數值過大，則偵測時間會越長，且可能會導致錯誤偵測。
參考
Blob物件、CodeReader物件、Correlation物件、Geometric物件、ImageOp物件、LineFinder物件、OCR物件、SearchWinCenterX屬性、SearchWinCenterY屬性、SearchWinHeight屬性、SearchWinLeft屬性、SearchWinRadiusInner屬性、SearchWinRadiusOuter屬性、SearchWinTop屬性、SearchWinWidth屬性、BoxFinder物件、Contour物件、CornerFinder物件、Text物件