Halcon算子介紹

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

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

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

4、界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, Color, Box : )輸出一段

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

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

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

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

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

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

11、egions：輸出，選出的符合某些特征條件的區(qū)域數(shù)組Features：條件特征，詳見 區(qū)域特征說明Operation :對于符合特征的區(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,Window

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

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

14、egions : Sigma :)自動閾值分割bin_threshold(Image : Region :)用于提取背景為白色，且前后北京較為分明；自動選取sigma值進行告訴光滑處理，光滑直到只有一個最小值；例如提取白紙黑字，可以用此算子；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)用于分隔符號圖像的閾值處理。通常伴隨著如Diff_of_gauss, sub_image等這樣的算子使用；就像前后兩幀做差

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

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

18、: Width, Height :)使用矩形結(jié)構(gòu)元素對圖像做膨脹操作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：生成矩形與水平軸的角度，以弧度為單位Lengthl, Length2 :生成矩形的長寬的一半亞

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、域：'border', 'border_holes', 'center'select_shape_xld(XLD : SelectedXLD : Features, Operation,Min, Max :)選擇特定形狀特征要求的 XLD輪廓或多邊形XLD:輸入，要提取的 XLDSelectedXLD：輸出，提取得到的 XLDFeatures：提取XLD的特征依據(jù)，默認(rèn)為area',詳見特征依據(jù)說明Operation ：特征之間的邏輯關(guān)系，默認(rèn) 'and'Min , Max：特征值的要求范圍select_contours_

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

22、或輪廓數(shù)組)Area：輸出，亞像素輪廓的面積Row：輸出，輪廓的重心的 row坐標(biāo)Column:輸出，輪廓的重心的 column坐標(biāo)PointOrder:輸出，沿邊界點順序，正向或者反向轉(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)化類型說明分割segment_contours_xld（Contours : ContoursSplit : Mode,

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

24、操作（未完）fit_line_contour_xld(Contours : : Algorithm, MaxNumPoints,ClippingEndPoints, Iterations, ClippingFactor : RowBegin,ColB egin, RowEnd, ColEnd, Nr, Nc, Dist）根據(jù)已知輪廓擬合直線，獲得的是直線的參數(shù)Contours:輸入的輪廓Algorithm :擬合算法，默認(rèn) tukey ,可選'regression', 'huber', 'tukey', 'gauss', '

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

26、axNumPoints, MaxClosureDist, ClippingEndPoints, Iterations, ClippingFactor : Row, Column, Radius, StartPhi, EndPhi, PointOrder）根據(jù)已知輪廓來擬合圓，并獲得圓參數(shù)Contours:輸入的輪廓Algorithm :擬合算法，默認(rèn) algebraic,可選''algebraic', 'ahuber', 'atukey', 'geometric', 'geohuber', 'geo

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

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

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

30、:插值方法MeasureHandle :測量句柄附：Halcon的圖像像素類型Halcon中的像素類型有如下（首字母應(yīng)當(dāng)為小寫）:IntiInt2Uint2Int4Int8Byte:最常見的灰度圖像，8位，一個字節(jié)，0255RealDirectionCyclicComplex特征依據(jù)說明以下是一些可選的條件特征說明（代碼中首字母應(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)（頂部）Columni ：區(qū)域的起始 column坐標(biāo)（左側(cè)）

31、Row2：區(qū)域的最終row坐標(biāo)（底部）Column2 :區(qū)域的最終 column坐標(biāo)（右側(cè)）Circularity :區(qū)域的圓度Compactness：區(qū)域的緊密度Contlength :區(qū)域外輪廓的總長度 Convexity:區(qū)域的凸性 Rectangularity :區(qū)域的垂直度 Ra：等效橢圓的長軸半徑 Rb:等效橢圓的短軸半徑 Phi：等效橢圓的方向Anisometry :橢圓參數(shù),Ra/Rb長軸與短軸的比值 Bulkiness :橢圓參數(shù)，蓬松度 兀*Ra*Rb/A struct_factor :橢圓參數(shù),Anisometry*Bulkiness-1 outer_radius:最小外接圓半徑 inner_radius:最大內(nèi)接圓半徑 inner_width :最大內(nèi)接矩形寬度 inner_height :最大內(nèi)接矩形高度dist_mean :區(qū)域邊界到中心的平均距離 dist_