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

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

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

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

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

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

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

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

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

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

11、區域數組Features：條件特征，詳見區域特征說明Operation：對于符合特征的區域的連接操作，可以是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 : : )計算兩個區域的差Region：需要處理的區域Sub：被減去的區域RegionDifference：輸出，計算后的結果。示例：* provides the region X without the points in Ydifference(X,Y,RegionDifference)RegionSubRegionDifferenceunion1(Region : RegionUnion : : )聯合有連接性質的區域Region：輸入的區域（比如connection過的區域數組）RegionUnion：輸出，合并后的區域union2(Re

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

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

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

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

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

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

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

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

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

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

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

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

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

27、點的最大數目（-1為所有點），默認-1MaxClosureDist:小于這個值被認為是輪廓封閉的，區分擬合圓和圓弧ClippingEndPoints：輪廓開始點和結束點參加與擬合點的個數（起始和結尾上忽略的點數？），默認0Iterations：迭代次數ClippingFactor：離群值的剪切因子，值越小忽略的離群值越多Row, Column：圓心坐標Radius：圓半徑StartPhi, EndPhi：圓弧開始角度，結束角度PointOrder：邊界點的次序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)擬合矩形測量基礎操作gen_measure_rectangle2( : : Row, Column, Phi, Length1, Length2, Width, Height, Interpolation : MeasureHandle)創建一個任意方向的矩形測量句柄（區域）Row, Column：矩形中心點坐標Phi：矩形主軸方向與水平軸夾角Length1：矩形寬度一半Length2:矩形高度一半Width, Height:處理圖像的寬，高Interpolation:插值方法MeasureHandle：測量句柄附:Halcon的圖像像素類型Halcon中的像素

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