Halcon算子介紹參考模板

1、圖像、窗口基礎(chǔ)操作部分基礎(chǔ)操作dev_close_window()關(guān)閉當(dāng)前激活的窗口read_image( : Image : FileName : )讀取圖像，可以支持多種格式，比如TIFF，PNG，JPEG-XR，JPEG-2000等，還支持一次性讀取多個(gè)圖像。Image：輸出，讀取完后在halcon所存放的變量名FileName：圖片路徑，可以是多個(gè)路徑，可以是絕對(duì)路徑或者相對(duì)路徑，還可以省略擴(kuò)展名示例：* Reading an image: read_image(Image,'mreut')* Reading 3 images into an image array:

2、read_image(Images,'ic0','ic1','ic2')stop()停止程序（等待用戶繼續(xù)運(yùn)行）get_image_size(Image : : : Width, Height)獲取圖像的尺寸Image：要獲取尺寸的圖像Width：輸出，圖像的寬度Height：輸出，圖像的高度1 / 17dev_open_window( : : Row, Column, Width, Height, Background : WindowHandle)打開一個(gè)新的圖像窗口Row：圖像窗口左上角的起始行，默認(rèn)0。（好像沒什么用）Column:圖像窗

3、口左上角的起始列，默認(rèn)0.（好像沒什么用）Width：圖像窗口的寬度，默認(rèn)256Height：圖像窗口的高度，默認(rèn)256Background:新窗口的背景顏色，默認(rèn)黑色（black）WindowHandle：窗口的識(shí)別Iddev_display(Object : : : )將圖像顯示到當(dāng)前的圖像窗口上Object：要顯示的圖像對(duì)象dev_set_draw( : : DrawMode : )設(shè)置Region的顯示形式DrawMode：區(qū)域的顯示形式，默認(rèn)'fill'，可選'fill', 'margin'，fill表示顯示實(shí)心區(qū)域，margin表示只

4、顯示區(qū)域的外邊界dev_set_color( : : ColorName : )設(shè)置輸出顏色ColorName：顏色名稱，默認(rèn)white，可選值（格式）：'white', 'black', 'gray', 'red', 'green', 'blue', '#003075', '#e53019', '#ffb529'disp_message( : : WindowHandle, String, CoordSystem, Row, Column, Colo

5、r, Box : )輸出一段文字信息WindowHandle：要顯示文字的窗口handleString：要顯示的文字信息，會(huì)顯示在一個(gè)行里CoordSystem：使用的坐標(biāo)系，默認(rèn)window，可選'window', 'image'Row，Column：文字坐標(biāo)，默認(rèn)12Color：文字顏色，默認(rèn)'black'，可選'', 'black', 'blue', 'yellow', 'red', 'green', 'cyan', 'm

6、agenta', 'forest green', 'lime green', 'coral', 'slate blue'Box：是否包含在一個(gè)背景框內(nèi)，默認(rèn)'true'，可選'true', 'false'基礎(chǔ)語(yǔ)法If(condition) else endif條件判斷While(condition) endwhileWhile循環(huán)for Index := start to max by step endforfor循環(huán)圖像處理部分基礎(chǔ)操作圖像轉(zhuǎn)化convert_image_t

7、ype(Image : ImageConverted : NewType : )轉(zhuǎn)換圖像類型Image : 要轉(zhuǎn)化的圖像ImageConverted : 輸出，轉(zhuǎn)化后的圖像NewType :要轉(zhuǎn)化的圖像類型，詳見Halcon的圖像像素類型decompose3(MultiChannelImage : Image1, Image2, Image3 : : )把一個(gè)RGB圖像轉(zhuǎn)化為3個(gè)單通道的圖像MultiChannelImage：輸入的多通道圖像（應(yīng)該是3通道？）Image1, Image2, Image3:輸出，轉(zhuǎn)化后的單通道圖像，1是red，2是green，3是bluergb1_to_gray

8、(RGBImage : GrayImage : : )把一張RGB圖像轉(zhuǎn)化為灰度圖像RGBImage:輸入的RGB圖像GrayImage：輸出，得到的灰度圖像腐蝕膨脹gen_disc_se( : SE : Type, Width, Height, Smax : )創(chuàng)建一個(gè)橢圓形結(jié)構(gòu)元素，用于圖像的腐蝕膨脹SE：輸出，生成后的結(jié)構(gòu)元素，圖像類型Type：結(jié)構(gòu)元素的圖像像素類型，默認(rèn)是byte，可選：byte，uint2，real，詳見Halcon的圖像像素類型gray_erosion(Image, SE : ImageErosion : : )使用結(jié)構(gòu)元素對(duì)圖像做腐蝕操作（結(jié)構(gòu)元素可以是gen_

9、disc_se的輸出）Image：要做腐蝕操作的圖像SE：結(jié)構(gòu)元素ImageErosion：輸出，腐蝕后的圖像gray_dilation(Image, SE : ImageDilation : : )使用結(jié)構(gòu)元素對(duì)圖像做膨脹操作（結(jié)構(gòu)元素可以是gen_disc_se的輸出）Image：要做膨脹操作的圖像SE：結(jié)構(gòu)元素ImageDilation：輸出，膨脹后的圖像區(qū)域處理部分基礎(chǔ)操作threshold(Image : Region : MinGray, MaxGray : )將圖像根據(jù)灰度值二值化Image：需要進(jìn)行二值化的圖像Region：輸出，二值化后的結(jié)果區(qū)域MinGray：最小灰度值，默

10、認(rèn)128MaxGray：最大灰度值，默認(rèn)255，必須大于MinGrayconnection(Region : ConnectedRegions : : )計(jì)算出區(qū)域中連接的部分Region：要計(jì)算的區(qū)域ConnectedRegions：輸出，計(jì)算后的Region數(shù)組，相連的部分將被劃分為一個(gè)區(qū)域，會(huì)以不同顏色加以區(qū)分select_shape(Regions : SelectedRegions : Features, Operation, Min, Max : )從一個(gè)區(qū)域數(shù)組中選擇出符合某特征條件的區(qū)域Regions：輸入的區(qū)域數(shù)組SelectedRegions：輸出，選出的符合某些特征條件的

11、區(qū)域數(shù)組Features：條件特征，詳見區(qū)域特征說(shuō)明Operation：對(duì)于符合特征的區(qū)域的連接操作，可以是And 或者OrMin：特征的最小值Max：特征的最大值示例：read_image(Image,'monkey')threshold(Image,S1,160,255)connection(S1,S2)select_shape(S2,Eyes,'area','anisometry','and',500,1.0,50000,1.7)disp_region(Eyes,WindowHandle)difference(Region,

12、 Sub : RegionDifference : : )計(jì)算兩個(gè)區(qū)域的差Region：需要處理的區(qū)域Sub：被減去的區(qū)域RegionDifference：輸出，計(jì)算后的結(jié)果。示例：* provides the region X without the points in Ydifference(X,Y,RegionDifference)RegionSubRegionDifferenceunion1(Region : RegionUnion : : )聯(lián)合有連接性質(zhì)的區(qū)域Region：輸入的區(qū)域（比如connection過(guò)的區(qū)域數(shù)組）RegionUnion：輸出，合并后的區(qū)域union2(Re

13、gion1, Region2 : RegionUnion : : )把兩個(gè)區(qū)域合并成一個(gè)區(qū)域Region1：要合并的第一個(gè)區(qū)域Region2：要合并的第二個(gè)區(qū)域RegionUnion：輸出，合并后的區(qū)域complement(Region : RegionComplement : : )計(jì)算一個(gè)區(qū)域的補(bǔ)（一般指全圖像區(qū)域減去該區(qū)域）Region：要計(jì)算的區(qū)域RegionComplement：輸出，計(jì)算后的區(qū)域閾值分割threshold(Image : Region : MinGray, MaxGray : )詳見：thresholdauto_threshold(Image : Regions :

14、 Sigma : )自動(dòng)閾值分割bin_threshold(Image : Region : : )用于提取背景為白色，且前后北京較為分明；自動(dòng)選取sigma值進(jìn)行告訴光滑處理，光滑直到只有一個(gè)最小值；例如提取白紙黑字，可以用此算子；mage : 輸入的圖像Region：輸出，分割后的區(qū)域char_threshold(Image, HistoRegion : Characters : Sigma, Percent : Threshold)閾值分割提取字符Image：輸入的圖像HistoRegion : 要提取字符所在的區(qū)域Characters : 輸出，提取得到的字符區(qū)域Sigma：高斯光滑因

15、子Percent : 灰度直方圖中的灰度值差的百分比Threshold：得到的用于閾值處理的閾值示例：read_image (Image, 'letters')char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)connection (Seg, Connected)dual_threshold(Image : RegionCrossings : MinSize, MinGray, Threshold : )應(yīng)用于分隔符號(hào)圖像的閾值處理。通常伴隨著如Diff_of_gauss，sub_image等這樣的算子使用；就像前后兩

16、幀做差得到圖像（差幀法），像素值有正值有負(fù)值。Image : 輸入的圖像RegionCrossings : 輸出，獲得的區(qū)域MinSize:輸出的區(qū)域的最小面積MinGray:區(qū)域的最小灰度絕對(duì)值Threshold:分割值腐蝕膨脹erosion_circle(Region : RegionErosion : Radius : )使用圓心結(jié)構(gòu)元素對(duì)圖像做腐蝕操作Region：要做腐蝕操作的區(qū)域（也可以是區(qū)域數(shù)組）RegionDilation：輸出，腐蝕后的區(qū)域（或區(qū)域數(shù)組）Radius：腐蝕操作的圓形結(jié)構(gòu)的半徑dilation_circle(Region : RegionDilation : R

17、adius : )使用圓形結(jié)構(gòu)對(duì)區(qū)域做膨脹操作Region：要做膨脹操作的區(qū)域（也可以是區(qū)域數(shù)組）RegionDilation：輸出，膨脹后的區(qū)域（或區(qū)域數(shù)組）Radius：膨脹操作的圓形結(jié)構(gòu)的半徑erosion_rectangle1(Region : RegionErosion : Width, Height : )使用矩形結(jié)構(gòu)元素對(duì)圖像做腐蝕操作Region：要做腐蝕操作的區(qū)域（也可以是區(qū)域數(shù)組）RegionDilation：輸出，腐蝕后的區(qū)域（或區(qū)域數(shù)組）Width，Height：腐蝕操作的矩形結(jié)構(gòu)的寬和高dilation_rectangle1(Region : RegionDilati

18、on : Width, Height : )使用矩形結(jié)構(gòu)元素對(duì)圖像做膨脹操作Region：要做腐蝕操作的區(qū)域（也可以是區(qū)域數(shù)組）RegionDilation：輸出，膨脹后的區(qū)域（或區(qū)域數(shù)組）Width，Height：膨脹操作的矩形結(jié)構(gòu)的寬和高生成區(qū)域gen_rectangle2( : Rectangle : Row, Column, Phi, Length1, Length2 : )生成與坐標(biāo)成任意角度的矩形Rectangle : 輸出，生成后的矩形Row，Column：用于生成的矩形的中心坐標(biāo)Phi：生成矩形與水平軸的角度，以弧度為單位Length1, Length2 :生成矩形的長(zhǎng)寬的一半

19、亞像素輪廓（XLD）部分基礎(chǔ)操作threshold_sub_pix(Image : Border : Threshold : )提取圖像的XLDImage：要提取xld的圖像（單通道，如果為多通道只提取第一通道）Border：輸出，得到的XLDThreshold：提取XLD的閾值，灰度值以閾值為分界提取XLDgen_contour_region_xld(Regions : Contours : Mode : )從區(qū)域（區(qū)域數(shù)組）生成亞像素輪廓Regions：要生成亞像素輪廓的區(qū)域（或區(qū)域數(shù)組）Contours：輸出，生成后的亞像素輪廓Mode：生成方式，默認(rèn)border，可輸入范圍區(qū)域：

20、9;border', 'border_holes', 'center'select_shape_xld(XLD : SelectedXLD : Features, Operation, Min, Max : )選擇特定形狀特征要求的XLD輪廓或多邊形XLD：輸入，要提取的XLDSelectedXLD：輸出，提取得到的XLDFeatures：提取XLD的特征依據(jù)，默認(rèn)為area，詳見特征依據(jù)說(shuō)明Operation：特征之間的邏輯關(guān)系，默認(rèn)andMin，Max：特征值的要求范圍select_contours_xld(Contours : SelectedCo

21、ntours : Feature, Min1, Max1, Min2, Max2 : )選擇多種特征要求的XLD輪廓（如長(zhǎng)度開閉等，不支持多邊形）Contours：要提取的XLD輪廓SelectedContours：輸出，提取得到的XLD輪廓Feature：提取的特征依據(jù)，詳見特征依據(jù)說(shuō)明Min1， Max，Min2，Max2：特征值的要求范圍area_center_xld(XLD : : : Area, Row, Column, PointOrder)獲取封閉的亞像素輪廓（或輪廓數(shù)組）的面積和重心坐標(biāo)XLD：輸入的亞像素輪廓（或輪廓數(shù)組）Area：輸出，亞像素輪廓的面積Row：輸出，輪廓的重

22、心的row坐標(biāo)Column:輸出，輪廓的重心的column坐標(biāo)PointOrder: 輸出，沿邊界點(diǎn)順序，正向或者反向轉(zhuǎn)換操作shape_trans_xld(XLD : XLDTrans : Type : )將目標(biāo)輪廓（或輪廓數(shù)組）轉(zhuǎn)化成其他形狀XLD：要轉(zhuǎn)化的XLD（或XLD數(shù)組）XLDTrans：輸出，轉(zhuǎn)化后的XLD（或數(shù)組）Type：轉(zhuǎn)化的類型，默認(rèn)'convex'，詳見XLD輪廓的轉(zhuǎn)化類型說(shuō)明分割segment_contours_xld(Contours : ContoursSplit : Mode, SmoothCont, MaxLineDist1, MaxLineD

23、ist2 : )把原XLD分割成：“直線”，“直線和圓”，“直線和橢圓”Contours：需要被分割的輪廓（或數(shù)組）ContoursSplit：輸出，分割后的輪廓數(shù)組Mode：分割模式，默認(rèn)lines_circles，可選'lines', 'lines_circles', 'lines_ellipses'SmoothCont：用于平滑輪廓的點(diǎn)數(shù)量MaxLineDist1：輪廓到近似線的最大距離（第一次迭代）MaxLineDist2：輪廓到近似線的最大距離（第二次迭代）擬合操作（未完）fit_line_contour_xld(Contours :

24、: Algorithm, MaxNumPoints, ClippingEndPoints, Iterations, ClippingFactor : RowBegin, ColBegin, RowEnd, ColEnd, Nr, Nc, Dist)根據(jù)已知輪廓擬合直線，獲得的是直線的參數(shù)Contours：輸入的輪廓Algorithm：擬合算法，默認(rèn)tukey，可選'regression', 'huber', 'tukey', 'gauss', 'drop'，詳見輪廓擬合算法說(shuō)明輪廓擬合算法說(shuō)明MaxNumPoint

25、s：用于計(jì)算的輪廓點(diǎn)的最大數(shù)目（-1為所有點(diǎn)），默認(rèn)-1ClippingEndPoints：起始和結(jié)尾上忽略的點(diǎn)數(shù)，默認(rèn)0Iterations：迭代最大次數(shù)（不用于回歸？）ClippingFactor：離群值的剪切因子，值越小忽略的離群值越多RowBegin，ColBegin：擬合后得到的直線開始點(diǎn)坐標(biāo)RowEnd，ColEnd：擬合后得到的直線結(jié)束點(diǎn)坐標(biāo)Nr，Nc：直線的法向量Dist:原點(diǎn)到直線的距離fit_circle_contour_xld(Contours : : Algorithm, MaxNumPoints, MaxClosureDist, ClippingEndPoints,

26、Iterations, ClippingFactor : Row, Column, Radius, StartPhi, EndPhi, PointOrder)根據(jù)已知輪廓來(lái)擬合圓，并獲得圓參數(shù)Contours：輸入的輪廓Algorithm：擬合算法，默認(rèn)algebraic，可選' 'algebraic', 'ahuber', 'atukey', 'geometric', 'geohuber', 'geotukey'，詳見輪廓擬合算法說(shuō)明輪廓擬合算法說(shuō)明MaxNumPoints：用于計(jì)算的輪廓

27、點(diǎn)的最大數(shù)目（-1為所有點(diǎn)），默認(rèn)-1MaxClosureDist:小于這個(gè)值被認(rèn)為是輪廓封閉的，區(qū)分?jǐn)M合圓和圓弧ClippingEndPoints：輪廓開始點(diǎn)和結(jié)束點(diǎn)參加與擬合點(diǎn)的個(gè)數(shù)（起始和結(jié)尾上忽略的點(diǎn)數(shù)？），默認(rèn)0Iterations：迭代次數(shù)ClippingFactor：離群值的剪切因子，值越小忽略的離群值越多Row, Column：圓心坐標(biāo)Radius：圓半徑StartPhi, EndPhi：圓弧開始角度，結(jié)束角度PointOrder：邊界點(diǎn)的次序fit_ellipse_contour_xld(Contours : : Algorithm, MaxNumPoints, MaxClo

28、sureDist, ClippingEndPoints, VossTabSize, Iterations, ClippingFactor : Row, Column, Phi, Radius1, Radius2, StartPhi, EndPhi, PointOrder)擬合橢圓fit_rectangle2_contour_xld(Contours : : Algorithm, MaxNumPoints, MaxClosureDist, ClippingEndPoints, Iterations, ClippingFactor : Row, Column, Phi, Length1, Leng

29、th2, PointOrder)擬合矩形測(cè)量基礎(chǔ)操作gen_measure_rectangle2( : : Row, Column, Phi, Length1, Length2, Width, Height, Interpolation : MeasureHandle)創(chuàng)建一個(gè)任意方向的矩形測(cè)量句柄（區(qū)域）Row, Column：矩形中心點(diǎn)坐標(biāo)Phi：矩形主軸方向與水平軸夾角Length1：矩形寬度一半Length2:矩形高度一半Width, Height:處理圖像的寬，高Interpolation:插值方法MeasureHandle：測(cè)量句柄附:Halcon的圖像像素類型Halcon中的像素

30、類型有如下(首字母應(yīng)當(dāng)為小寫)：Int1Int2Uint2Int4Int8Byte:最常見的灰度圖像，8位，一個(gè)字節(jié)，0255RealDirectionCyclicComplex特征依據(jù)說(shuō)明以下是一些可選的條件特征說(shuō)明（代碼中首字母應(yīng)該為小寫）：Area：區(qū)域大小，應(yīng)該是以像素為單位Row：區(qū)域中心的row坐標(biāo)Column：區(qū)域中心的column坐標(biāo)Width：區(qū)域的寬度Height：區(qū)域的高度Row1：區(qū)域的起始row坐標(biāo)（頂部）Column1：區(qū)域的起始column坐標(biāo)（左側(cè)）Row2：區(qū)域的最終row坐標(biāo)（底部）Column2：區(qū)域的最終column坐標(biāo)(右側(cè))Circularity：區(qū)域的圓度Compactness：區(qū)域的緊密度Contlength：區(qū)域外輪廓的總長(zhǎng)度Convexity：區(qū)域的凸性Rectangularity：區(qū)域的垂直度Ra：等效橢圓的長(zhǎng)軸半徑Rb：等效橢圓的短軸半徑Phi：等效橢圓的方向Anisometry：橢圓參數(shù)，Ra/Rb長(zhǎng)軸與短軸的比值Bulkiness：橢圓參數(shù)，蓬松度*Ra*Rb/Astruct_factor：橢圓參數(shù)，Anisometry*Bulkiness-1outer_radius：最小外接圓半徑inner_radius：最大內(nèi)接圓半徑inner_width：最大內(nèi)接矩形寬度inner_height：最大內(nèi)接矩形高度