康耐視自己總結(jié)vp控件參數(shù)說明中文cnlsearch edit control

1、CNLSearch Edit ControlPage 1 of 7折疊全部Cognex Vis onPro代碼：全部CNLSearch Edit Control發(fā)送反饋本包含以下章節(jié)。Control Buttons (控件按鈕)CNLSearch Edit Control Buffers (CNLSearch 編輯控件緩沖區(qū))Train Params Tab (Train Params 選項卡)Train Region and Origab (Train Region and Origin 選項卡)Run Params Tab (Run Params 選項卡)Search Region Tab

2、 (Search Region 選項卡)Graphics Tab (Graphics 選項卡)Results Tab (Results 選項卡)CNLSearch 編輯控件為 LSearchTool 視覺工具及其組件提供圖形用戶界面。CNLSearch 工具可以搜索圖像中像素值的已訓(xùn)練樣板。CNLSearch 工具的用法為：首先對訓(xùn)練圖像的一部分或全部進(jìn)行訓(xùn)練，使其成為已訓(xùn)練樣板，然后在一張或多張搜索圖像中搜索已訓(xùn)練樣板。通過抓取樣板來訓(xùn)練圖像，指定訓(xùn)練區(qū)域、樣板原點(diǎn)以及其他訓(xùn)練參數(shù)，然后對樣板進(jìn)行訓(xùn)練，即可完成樣板訓(xùn)練。通過提供搜索圖像并指定搜索參數(shù)就可以搜索已訓(xùn)練樣板。CNLSearch

3、編輯控件包括以下組件：一排位于左上角的控件按鈕。一個工具顯示窗口，用于顯示以下 CNLSearch 工具圖像緩沖區(qū)：Current.TrainImage、Current.InputImage 和 LastRun.InputImage。這些緩沖區(qū)包含已訓(xùn)練樣板，CNLSearch 工具在其中搜索樣板的搜索圖像，以及包含搜索結(jié)果的同一圖像。右鍵單擊工具顯示可打開包括縮放圖像或顯示像素或子像素網(wǎng)格的菜單選項。一組按功能組織的選項卡。這些功能包括運(yùn)行工具的參數(shù)設(shè)置、關(guān)注搜索區(qū)域的參數(shù)設(shè)置、工具顯示的顯示設(shè)置以及訓(xùn)練結(jié)果。按下Control + Tab 鍵在選項卡組之間滾動。一個位于控件左下角的狀態(tài)欄。

4、綠色圓圈表示工具已成功運(yùn)行；紅色圓圈表示工具未成功運(yùn)行。狀態(tài)欄還會顯示運(yùn)行工具的時間以及所有錯誤代碼或消息。狀態(tài)欄首次顯示的時間是工具的原始執(zhí)行時間。狀態(tài)欄第二次顯示的時間包含更新編輯控件所需的時間?？丶辉诳梢姞顟B(tài)下才能更新。Control Buttons (控件按鈕)下表介紹了位于編輯控件左上角的按鈕。表 1. 控件按鈕按鈕說明運(yùn)行 CNLSearch 工具。必須在 Current.InputImage 緩沖區(qū)中提供圖像（相當(dāng)于 InputImage）。此按鈕會調(diào)用 Run 方mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12C

5、NLSearch Edit ControlPage 2 of 7法。請注意，您必須已經(jīng)訓(xùn)練過樣板。CNLSearch Edit Control Buffers (CNLSearch 編輯控件緩沖區(qū))CNLSearch 編輯控件具有三個圖像緩沖區(qū)。其中兩個緩沖區(qū)使用底層 CNLSearch 工具的 InputImage 和 TrainImage；第三個緩沖區(qū)顯示運(yùn)行 CNLSearch 工具的最后一個輸入圖像以及該搜索的結(jié)果。全部三個緩沖區(qū)均可顯示在本地和浮動工具顯示窗口中。Current.InputImage 為 CNLSearch 工具提供輸入圖像，此為 CNLSearch 工具的 Inpu

6、tImage 緩沖區(qū)。Current.TrainImage 包含已訓(xùn)練樣板，此為 TrainImage 緩沖區(qū)。LastRun.InputImage 緩沖區(qū)顯示最近運(yùn)行此工具的最后一個圖像。使用 Graphics 選項卡突出顯示搜索區(qū)域和搜索結(jié)果。通過單擊 Run 按鈕運(yùn)行 CNLSearch 工具時，工具會搜索 Current.InputImage，以尋找 Current.TrainImage 緩沖區(qū)中的樣板。此搜索的結(jié)果顯示在 Results 選項卡上，結(jié)果圖形則顯示在 LastRun.InputImage 緩沖區(qū)上（選擇 Results 選項卡上的結(jié)果可突出顯示其在顯示屏上的圖形；單擊顯

7、示屏上的圖形可突出顯示其在 Results 選項卡上的結(jié)果）。您可以使用 Current.InputImage 作為已訓(xùn)練樣板；為此，轉(zhuǎn)到 Train Params 選項卡并單擊 Grab Train Image 按鈕。此按鈕會將Current.InputImage到 Current.TrainImage 緩沖區(qū)，您可以在其中使用它來訓(xùn)練 CNLSearch 將搜索的樣板。請注意，您的應(yīng)用程序負(fù)責(zé)將圖像到編輯控件的 Current.InputImage 緩沖區(qū)。使用 Tool Group Edit Control 創(chuàng)建從 AcqFifo 工具輸出圖像到 CNLSearch 工具輸入圖像的，然后

8、運(yùn)行 AcqFifo 工具或工具組，即可完成此操作。Train Params Tab (Train Params 選項卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12切換為電動模式。將其選中后，如果更改了某些參數(shù)，CNLSearch 工具將自動運(yùn)行。編輯控件處于電動模式時，這些參數(shù)會顯示閃電圖標(biāo)。打開或關(guān)閉本地工具顯示窗口。此窗口有一個選擇框，您可用它來指定您想要查看的圖像緩沖區(qū)。打開一個或多個浮動工具顯示窗口，以提供額外的工具顯示窗口。與本地工具顯示窗口一樣，您可指定要查看的圖像緩沖區(qū)。加載 ViPro 固有 (.vpp)

9、文件，此文件包含該視覺工具對象類型的一組已保存屬性。為其他對象類型加載固有文件時會出現(xiàn)錯誤，加載會失敗。有關(guān) ViPro 固有功能的信息，請參閱 ViPro 中的“Persistence”。將底層工具的當(dāng)前屬性保存至 ViPro 固有文件?？梢赃x擇保存整個工具，也可選擇保存不含其圖像或結(jié)果的工具。將底層工具的當(dāng)前屬性保存至新的 ViPro 固有文件。將底層工具重置為默認(rèn)狀態(tài)。打開 Image Mask Editor，以創(chuàng)建要添加至訓(xùn)練圖像的掩模。打開單獨(dú)的新結(jié)果窗口，不用轉(zhuǎn)至 Results 選項卡即可查看運(yùn)行結(jié)果。啟用或禁用此編輯控件中單個項目的工具提示顯示。打開此幫助。CNLSearch

10、Edit ControlPage 3 of 7使用 Train Params 選項卡來配置和訓(xùn)練 CNLSearch 樣板。利用此選項卡執(zhí)行的關(guān)鍵操作包括獲取訓(xùn)練圖像指定訓(xùn)練時間參數(shù)訓(xùn)練樣板下表總結(jié)了相關(guān)操作以及用于執(zhí)行這些操作的控件。表 2. Train Params 選項卡功能功能說明Train Region and Origab (Train Region and Origin 選項卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Pattern顯示已訓(xùn)練樣板的圖像，由 TrainImage 內(nèi)以青色邊框突出顯示的 Tra

11、inRegion 指定?？稍O(shè)置訓(xùn)練區(qū)域，方法是使用 Train Region and & Origin 選項卡或在 Current.TrainImage 中重新調(diào)整其顯示大小。選項卡底部的消息文本指示是否已訓(xùn)練 CNLSearch 工具。Loattern從 ViPro 固有文件加載已訓(xùn)練樣板。Save Pattern將當(dāng)前已訓(xùn)練的樣板保存到擴(kuò)展名為 VPP 的 ViPro 固有文件中。Algorithm選擇要訓(xùn)練哪種 CNLSearch 算法。您只能使用已訓(xùn)練過某個樣板的算法來搜索此樣板。這對應(yīng)于 Algorithms屬性。Ignore Polarity如果為真，與已訓(xùn)練樣板呈負(fù)相關(guān)的樣板將獲

12、得正分。如果為假，則負(fù)相關(guān)的樣板將得。這對應(yīng)于IgnorePolarity 屬性。Advanced Training Enabled如果為真，則啟用 advanced training。高級訓(xùn)練可以用于修正重復(fù)樣板圖像，例如搜索結(jié)果位置確。高級訓(xùn)練僅應(yīng)用于線性搜索算法。這對應(yīng)于 AdvancedTrainingEnabled 屬性。Partial Match Limits訓(xùn)練時部分匹配限制用于指定在運(yùn)行時有多少已訓(xùn)練樣板可以處于搜索圖像的外部。訓(xùn)練時部分匹配限制僅用于啟用了高級訓(xùn)練的訓(xùn)練期間。這對應(yīng)于 PartialMatchLimitUp、PartialMatchLimitDown、 Par

13、tialMatchLimitLeft 和 PartialMatchLimitRight 屬性。Train button根據(jù)在 TrainImage TrainRegion 中指定的方式來訓(xùn)練所需樣板。調(diào)用 Train 功能。如果工具已經(jīng)有已訓(xùn)練樣板，將取消訓(xùn)練然后重新訓(xùn)練。樣板訓(xùn)練成功后，控件底部的文本將顯示“Trained”。Train 按鈕僅在 Current.TrainImage 中有圖像時才可用。Grab Train Image button將 TrainImage 緩沖區(qū)設(shè)置為 InputImage 緩沖區(qū)的參考。此按鈕僅在 Current.InputImage 中有圖像時才可用。您

14、的應(yīng)用程序必須將圖像到編輯控件的 Current.InputImage 緩沖區(qū)。使用 Tool Group Edit Control 創(chuàng)建從 AcqFifo 工具輸出圖像到 CNLSearch 工具輸入圖像的，然后運(yùn)行 AcqFifo 工具或工具組，即可完成此操作。Edge Thresholds如果您在要訓(xùn)練的樣板中包含 Nonlinear CNLPAS 算法，可以指定圖像邊緣像素的低閾值和高閾值。邊緣強(qiáng)度（跨邊緣的灰階差異）低于低閾值的邊緣像素會從已訓(xùn)練樣板中排除，邊緣強(qiáng)度高于高閾值的邊緣則會包含在樣板中；而邊緣強(qiáng)度介于兩個閾值之間的邊緣則會在與其他高于高閾值的邊緣存在 8 處連接時包含在樣

15、板中。相當(dāng)于 EdgeThresholdLow 和 EdgeThresholdHigh 屬性。CNLSearch Edit ControlPage 4 of 7使用 Train Region and Origin 選項卡定義 TrainRegion，此操作可定義成為已訓(xùn)練樣板的 TrainImage 緩沖區(qū)的區(qū)域。您還可以圖形方式定義 Current.TrainImage 緩沖區(qū)中的訓(xùn)練區(qū)域。首先以圖形方式指定訓(xùn)練區(qū)域，然后使用此選項卡微調(diào)訓(xùn)練區(qū)域參數(shù)，這樣可能更容易。CNLSearch 編輯控件會更新訓(xùn)練區(qū)域值，以便此選項卡上的值與 Current.TrainImage 緩沖區(qū)中的訓(xùn)練區(qū)域形

16、狀始終匹配?？梢远葦?shù)（默認(rèn)）或弧度指定此選項卡上的某些參數(shù)，如 Ro它們轉(zhuǎn)換成度數(shù)。ion 和 Skew。底層工具始終使用弧度值，但編輯控件會在適當(dāng)時會將表 3. Train Region 功能功能說明表 4. 訓(xùn)練原點(diǎn)功能功能說明Run Params Tab (Run Params 選項卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Origin X Origin Y用于定義訓(xùn)練區(qū)域原點(diǎn)位置的值。以圖形方式修改原點(diǎn)時，這些值將改變。相當(dāng)于 OriginX 和 OriginY 屬性。Center Origin將訓(xùn)練區(qū)域的原點(diǎn)置

17、于訓(xùn)練區(qū)域的中心。TrainRegionMode定義工具如何解釋您所指定的訓(xùn)練區(qū)域。Pixel Aligned Bounding Box 使用您所指定區(qū)域中的像素以及包圍此區(qū)域的像素配對限定框中的像素來訓(xùn)練樣板。這表示包含位于已定義區(qū)域之外但位于限定矩形之內(nèi)的圖像部分。Pixel Aligned Bounding Box Adjust Mask 將已定義區(qū)域包圍在矩形內(nèi)，但會遮蓋區(qū)域以外、矩形以內(nèi)的圖像部分，結(jié)果是只有您指定區(qū)域內(nèi)的像素包含在已訓(xùn)練樣板中。仿射變換只能在區(qū)域形狀為 CogRectangleAffine 時使用。此模式通過對區(qū)域的像素進(jìn)行仿射變換來創(chuàng)建新圖像。一般來說，此模式在您

18、知道運(yùn)行時圖像相對于訓(xùn)練圖像進(jìn)行了旋轉(zhuǎn)或其他仿射變換時十分有用，但如果可能，應(yīng)從與運(yùn)行時圖像類似的圖像進(jìn)行訓(xùn)練，而非試圖對預(yù)期的旋轉(zhuǎn)或仿射變換進(jìn)行補(bǔ)償。TrainRegion選擇輸入?yún)^(qū)域的形狀。選擇“None=Use entire image”表示此工具使用整個輸入圖像。CNLSearch 工具支持以下輸入?yún)^(qū)域形狀：CogCircleCogEllipseCogPolygonCogRectangleCogRectangleAffine所顯示的區(qū)域定義參數(shù)集取決于所使用的區(qū)域形狀。有關(guān)使用多邊形作為輸入?yún)^(qū)域的信息，請參閱 “Using Polygon Input Regions”。Selected

19、 Space Name解釋訓(xùn)練區(qū)域的坐標(biāo)空間。相當(dāng)于 SelectedSpaceName 屬性。有關(guān)信息，請參閱“Coordinate Space Names”。Select Mode當(dāng) Region Sh為 CogRectangle 或 CogRectangleAffine 時可用。選擇用于定義矩形的參數(shù)集。如果選擇 cogRectangleAffine，請注意，旋轉(zhuǎn)角度和傾斜角度可以度數(shù)或弧度指定，但底層工具始終使用弧度來作為度量。Fit In Image使訓(xùn)練區(qū)域在 Current.TrainImage 內(nèi)居中。相當(dāng)于 FitToImage 屬性。CNLSearch Edit Contr

20、olPage 5 of 7使用 Run Params 選項卡指定如何執(zhí)行樣板搜索。這些參數(shù)包括要使用的運(yùn)行算法、閾值和限制。表 5. Run Params 選項卡功能功能說明Search Region Tab (Search Region 選項卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Algorithm應(yīng)用于執(zhí)行 CNLSearch 檢測的算法。您可以為已訓(xùn)練圖像中具有線性亮度變化的搜索圖像指定 Linear Search or Linear CNLPAS 算法，或者為具有非線性亮度變化的搜索圖像指定 Nonlinear

21、 CNLPAS 算法。性模式算法中，Linear Search 算法更為激進(jìn)，速度較快，但可能遺漏某些樣板實(shí)例，Linear CNLPAS 算法則較為保守，速度可能較慢，但不太可能遺漏任何樣板實(shí)例。此設(shè)置相當(dāng)于 Algorithm 屬性。請注意，對于指定用于搜索的算法，必須已經(jīng)進(jìn)行過樣板訓(xùn)練。Accuracy指定搜索的 accuracy 級別。請注意，對于指定用于搜索的精確度級別，必須已經(jīng)進(jìn)行過樣板訓(xùn)練。um Results指定要查找的結(jié)果數(shù)。相當(dāng)于 MaxResults 屬性。Accept threshold指定結(jié)果分?jǐn)?shù)的 acceptance threshold。指定一個值，使得樣板的任何

22、實(shí)際實(shí)例所得到的分?jǐn)?shù)都不會低于此閾值。相當(dāng)于 AcceptThreshold 屬性。Confu threshold指定結(jié)果分?jǐn)?shù)的 confuthreshold。指定非有效樣板所能得到的最高分?jǐn)?shù)。此值向工具表明您所期望的搜索圖像的程度如何；指定的值越大，工具將越仔細(xì)。相當(dāng)于 ConfuThreshold 屬性。XY Overlap兩個樣板實(shí)例之間允許的最大 overlap 百分比（0.0 到 1.0）。如果兩個樣板實(shí)例的區(qū)域超過指定的百分比，則分?jǐn)?shù)較低的樣板實(shí)例將被丟棄。相當(dāng)于 XYOverlap 屬性。Reduce Partial Match Score如果選中，CNLSearch 將減小有部

23、分位于搜索圖像外部的樣板實(shí)例所得到的分?jǐn)?shù)。分?jǐn)?shù)按照樣板處于圖像內(nèi)部的百分比進(jìn)行。相當(dāng)于 PartialMatchReducore 屬性。Search Po Enabled啟用點(diǎn)搜索（僅 Linear Search 算法支持點(diǎn)搜索），此時 CNLSearch 會嘗試僅查找使用 SearchPo X 和SearchPo Y 控件指定的某個點(diǎn)處或該點(diǎn)附近的單個樣板實(shí)例。相當(dāng)于 SearchPo Enabled 屬性。Use Run Params Partial Match Limits如果選中，CNLSearch 將使用您在 Run Params 選項卡中指定的部分匹配限制來限制允許已訓(xùn)練樣板的多大

24、部分處于搜索圖像外部。如果未選中此復(fù)選框，則將使用 Train Params 選項卡中指定的部分匹配限制。選中此選項按鈕相當(dāng)于將 PartialMatchLimitsUsePattern 屬性設(shè)置為假。Edge Thresholds Use Pattern僅針對非線性 CNLPAS 算法。如果選中，CNLSearch 將使用您在 Train Params 選項卡中指定的邊緣閾值來創(chuàng)建運(yùn)行時圖像邊緣。如果未選中，將使用您在此選項卡中指定的 EdgeThresholdLow 和 EdgeThresholdHigh 閾值。相當(dāng)于 EdgeThresholdsUsePattern 屬性。CNLSear

25、ch Edit ControlPage 6 of 7使用 Search Region 選項卡定義 SearchRegion，即限制樣板搜索的 InputImage 緩沖區(qū)區(qū)域。搜索區(qū)域以青色邊框顯示在 Current.InputImage 中，您可以圖形形式定義此緩沖區(qū)中的搜索區(qū)域。首先以圖形方式指定搜索區(qū)域，然后使用此選項卡微調(diào)搜索區(qū)域參數(shù)，這樣可能會更容易。重新調(diào)整 InputImage 中搜索區(qū)域的大小時，此選項卡上的值會變化；同樣地，更改參數(shù)值會導(dǎo)致搜索區(qū)域改變其大小和形狀。表 6. Search Region 選項卡功能功能說明Graphics Tab (Graphics 選項卡)使

26、用 Graphics 選項卡選擇 LastRun.InputImage、Current.InputImage 以及 Current.TrainImage 顯示緩沖區(qū)中顯示的結(jié)果圖形。mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Region Mode定義區(qū)域的限定框。相當(dāng)于 SearchRegionMode 屬性。Pixel Aligned Bounding Box 將已定義區(qū)域包圍在矩形內(nèi)。這表示包含位于已定義區(qū)域之外但位于限定矩形之內(nèi)的圖像部分。仿射變換只能在區(qū)域形狀為 CogRectangleAffine 時使用。此模式通

27、過對區(qū)域的像素進(jìn)行仿射變換來創(chuàng)建新圖像。您將使用此方法來修正已訓(xùn)練樣板和運(yùn)行時圖像之間的旋轉(zhuǎn)或其他仿射變換。Region Sh搜索區(qū)域的形狀，相當(dāng)于 SearchRegion。選擇“None=Use entire image”表示整個 Current.InputImage 成為搜索區(qū)域。區(qū)域定義的參數(shù)集取決于所選的 Region Sh。Selected Space Name解釋搜索區(qū)域的坐標(biāo)空間。相當(dāng)于 SelectedSpaceName 屬性。有關(guān)信息，請參閱“Coordinate Space Names”。Select Mode當(dāng) Region Sh 為 CogRectangle 或 Co

28、gRectangleAffine 時可用。選擇用于定義矩形的參數(shù)集。如果選擇 cogRectangleAffine，請注意，旋轉(zhuǎn)角度和傾斜角度可以度數(shù)或弧度指定，但底層工具始終使用弧度來作為度量。Fit In Image使搜索區(qū)域在 Current.InputImage 內(nèi)居中。相當(dāng)于 FitToImage 方法。CNLSearch Edit ControlPage 7 of 7表 7. Graphics 選項卡功能功能說明Results Tab (Results 選項卡)Results 選項卡顯示最近的樣板搜索結(jié)果。這對應(yīng)于 LSearchResult 界面。使用結(jié)果網(wǎng)格下面的滑塊控件顯示完

29、整的結(jié)果集。表 8. Results 選項卡功能功能說明 2013 Cognex Corporation 保留所利mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Results Grid顯示每個結(jié)果的以下信息。此結(jié)果的 Score。范圍為 0.0 至 1.0，值越大表示匹配得越好。LocationX 和 LocationY 指定了樣板原點(diǎn)在輸入圖像中的位置。此位置位于輸入圖像的所選空間內(nèi)。AreaCoverageScore 是樣板實(shí)例位于搜索圖像內(nèi)的部分（范圍從 0.0 到 1.0）。此分?jǐn)?shù)僅適用于使用 Linear Search 算法執(zhí)行的搜索（其他算法無法查找部分位于搜索圖像外部的樣板）。AreaScore 是匹配的