halcon算子随笔

想要学好机器视觉，要把算子、数学原理和项目融汇贯通才可。

Halcon算子形式 F(A:B:C:D)

A为输入对象

B为输出对象

C为输入参数

D为输出参数

---

数值类

1.替换数组数值

CamPose := replace(RefPose,2,RefPose[2] + Dist)

RefPose：需要替换某个数的一个数组，RefPose[2] = RefPose[2] + Dist,其他元素数值不变

2：被替换的一个数组的索引

RefPose[2] + Dist ：数组中索引号为2的元素加上Dist来替换

---

仿射变换类

1.创建一个相同2维变换的齐次变换矩阵

hom_mat2d_identity( : : : HomMat2DIdentity)

---

纹理缺陷检测：

（1）create_class_gmm(::NumDim,NumClasses,NumCenters,CovarType,Preprocessing,NumComponents,RandSeed:GMMHandle)

函数功能：创建一个用于分类的高斯混合模型

参数说明：

输入参数：

NumDim:

Number of dimensions of the feature space.特征空间的维度数

Default value: 3

Suggested values: 1, 2, 3, 4, 5, 8, 10, 15, 20, 30, 40, 50, 60, 70, 80, 90, 100

Restriction: NumDim >= 1

NumClasses：

Number of classes of the GMM.高斯混合类型的数量

Default value: 5

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Restriction: NumClasses >= 1

NumCenters：

Number of centers per class. 每种类的中心数

Default value: 1

Suggested values: 1, 2, 3, 4, 5, 8, 10, 15, 20, 30

Restriction: NumClasses >= 1

CovarType：

Type of the covariance matrices. 协方差矩阵的类型

Default value: 'spherical'

List of values: 'diag', 'full', 'spherical'

Preprocessing：

Type of preprocessing used to transform the feature vectors.用于转换特征向量的预处理类型

Default value: 'normalization'

List of values: 'canonical_variates', 'none', 'normalization', 'principal_components' 

NumComponents:

Preprocessing parameter: Number of transformed features (ignored for Preprocessing = 'none' and Preprocessing = 'normalization').

Default value: 10

Suggested values: 1, 2, 3, 4, 5, 8, 10, 15, 20, 30, 40, 50, 60, 70, 80, 90, 100

Restriction: NumComponents >= 1

zoom_image_factor（Image:ImageZoomed:ScaleWidth,ScaleHeight,Interpolation)

函数功能：  Zoom an image by a given factor。按给定的因素放大图像

输入参数：Image:输入图像

                 ScaleWidth:Scale factor for the width of the image.图像宽度的比例因子               

                    Default value: 0.5

                   Suggested values: 0.25, 0.5, 1.5, 2.0

                   Typical range of values: 0.001 ≤ ScaleWidth ≤ 10.0

                   Minimum increment: 0.001

                   Recommended increment: 0.1

ScaleHeight:图像高度的比例因子

 Scale factor for the height of the image.

Default value: 0.5

Suggested values: 0.25, 0.5, 1.5, 2.0

Typical range of values: 0.001 ≤ ScaleHeight ≤ 10.0

Minimum increment: 0.001

Recommended increment: 0.1

Interpolation:插值的类型

Default value: 'constant'

List of values: 'bilinear', 'constant', 'nearest_neighbor', 'weighted'

输出参数:ImageZoomed:缩放的图像

调用函数：disp_message（：：WindowHandle，string，CoordSystem，Row，Column，Color，Box：）

函数功能：此过程将写入一条文本信息

参数说明：

输入参数：WindowHandle

The window handle of the graphics window, where the message should be displayed.图像窗口的窗口句柄处显示信息

输入参数：String： A tuple of strings containing the text message to be displayed. Each value of the tuple will be displayed in a single line.包含要显示的文本消息的字符串元组。元组的每个值将显示在一行中。

CoordSystem:

If set to 'window', the text position is given with respect to the window coordinate system. If set to 'image', image coordinates are used (This may be useful in zoomed images).

如果设置为“窗口”，则对窗口坐标系统给出文本位置。 如果设置为“图像”，则使用图像坐标(这可能在放大图像中是有用的)

Default Value: 'window'

值的列表: 'window', 'image'

Row:

The row coordinate of the desired text position. If set to -1, a default value of 12 is used.所需文本位置的行坐标。如果设置为-1，则使用默认值12。

Default Value: 12

建议值: [10,12,20,30]

Column:

The column coordinate of the desired text position. If set to -1, a default value of 12 is used.所需文本位置的列坐标。如果设置为-1，则使用默认值12。

Default Value: 12

建议值: [10,12,20]

Color:

Defines the color of the text as string. If set to [], or '' the currently set color is used. If a tuple of strings is passed, the colors are used cyclically for each new position or textline.定义文本为字符串的颜色。如果设置为[]，或“当前设置的颜色被使用”。如果传递了一组字符串，则为每个新位置或文本行循环使用颜色。

Default Value: 'black'

建议值: '', 'black', 'blue', 'yellow', 'red', 'green', 'cyan', 'magenta', 'forest green', 'lime green', 'coral', 'slate blue'

Box:

If set to 'true', the text is written within an orange box. If set to' false', no box is displayed. If set to a color string (e.g. 'white', '#FF00CC', etc.), the text is written in a box of that color. Optionally, a second value controls the appearance of a box shadow如果设置为“true”，则将文本写入一个橙色框中。如果设置为“false”，则不会显示任何框。如果设置为颜色字符串(例如:“白色”、“#FF00CC”等等)，文本是用这种颜色的框写的。可选地，第二个值控制框阴影的外观。

Default Value: 'true'

值的列表: 'true', 'false', 'white', 'red', 'forest green', 'black', 'blue'

调用函数：texture_laws（Image: ImageTexture:FilterTypes,Shift,FilterSize:)

函数功能：使用Laws纹理滤波器过滤图像

参数说明：

输入参数：Image：纹理变换将被用到的图像

                 FilterType： Desired filter期望设计出的滤波器

Default value: 'el'

Suggested values: 'll', 'le', 'ls', 'lw', 'lr', 'lu', 'lo', 'el', 'ee', 'es', 'ew', 'er', 'eu', 'eo', 'sl', 'se', 'ss', 'sw', 'sr', 'su', 'so', 'wl', 'we', 'ws', 'ww', 'wr','wu', 'wo', 'rl', 're', 'rs', 'rw', 'rr', 'ru', 'ro', 'ul', 'ue', 'us', 'uw', 'ur', ' uu', 'uo', 'ol', 'oe', 'os', 'ow', 'or', 'ou', 'oo'

                               Shift:  Shift to reduce the gray value dynamics.       转换减少灰度值的动态     

                             FilterSize：Size of the filter kernel.过滤内核的大小

 输出参数： ImageTexture：纹理图像

调用函数：compose（Image1，Image2,Image3，Image4，Image5，MultiChannelImage:）

函数功能：将五个图像转换为五通道图像

参数说明：

输入参数： Image1，Image2,Image3，Image4，Image5

输出参数:MultiChannelImage

调用参数：smooth_image(Image: ImageSmooth : Filter,Alpha:)

函数功能：使用各种滤波器平滑图像

参数说明：

输入参数：Image:将被平滑的图像

                 Filter：滤波器

Default value: 'deriche2'

List of values: 'deriche1', 'deriche2', 'gauss', 'shen'

                 Alpha：Filterparameter: small values cause strong smoothing (vice versa by using bei 'gauss').

                                             滤波器参数：小值导致强烈的平滑

输出参数：ImageSmooth：平滑后的图像

调用函数：add_sample_image_class_gmm（Image, ClassRegions : : GMMHandle,Randomize:)

函数功能：  Add training samples from an image to the training data of a Gaussian Mixture Model.

                   从图像中添加训练样本到高斯混合模型的训练数据。

参数说明：

             输入参数：Image：训练图像

                              ClassRegions： Regions of the classes to be trained需训练的课程区域。

                                              GMMHandle：GMM handle.GMM句柄

                                              Randomize：Standard deviation of the Gaussian noise added to the training data.在训练数据中加入高斯噪声的标准差。

调用函数： classify_image_class_gmm（Image： ClassRegions： GMMHandle，RejectionThreshold ）

函数功能：用高斯混合模型对图像进行分类

 参数说明：

                输入参数：Image：输入图像

                              GMMHandle：GMM句柄

                               RejectionThreshold：

Threshold for the rejection of the classification.拒绝分类的阈值

Default value: 0.5

Suggested values: 0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Restriction: RejectionThreshold >= 0.0 && RejectionThreshold <= 1.0

          输出参数：ClassRegions： Segmented classes.分割类

调用函数：opening_circle(Region : RegionOpening : Radius : )

    函数功能： Open a region with a circular structuring element.用圆形结构元素打开一个区域

    参数说明:

                  输入参数：Region：被打开的区域

                                   Radius：圆形结构元素的半径

Default value: 3.5

Suggested values: 1.5, 2.5, 3.5, 4.5, 5.5, 7.5, 9.5, 12.5, 15.5, 19.5, 25.5, 33.5, 45.5, 60.5, 110.5

Typical range of values: 0.5 ≤ Radius ≤ 511.5 (lin)

Minimum increment: 1.0

Recommended increment: 1.0

                输出参数：RegionOpening：打开的区域

    函数描述： opening_circle is defined as an erosion followed by a Minkowsi addition with a circular structuring element (see example). opening serves to eliminate small regions (smaller than the circular structuring element) and to smooth the boundaries of a region.opening_circle被定义为一种侵蚀，其次是Minkowsi添加了一个循环结构元素(参见示例)。开口的作用是消除小区域(比圆形结构单元小)，并使区域的边界平滑。

调用参数：closing_circle（Region： RegionClosing： Radius：）

函数功能： Close a region with a circular structuring element.用圆形结构元素关闭一个区域。

参数说明：

              输入参数：Region：被关闭的区域

                               Radius：圆形结构元素的半径

Default value: 3.5

Suggested values: 1.5, 2.5, 3.5, 4.5, 5.5, 7.5, 9.5, 12.5, 15.5, 19.5, 25.5, 33.5, 45.5, 60.5, 110.5

Typical range of values: 0.5 ≤ Radius ≤ 511.5 (lin)

Minimum increment: 1.0

Recommended increment: 1.0

             输出参数：RegionClosing：关闭的区域

函数描述: closing_circle behaves analogously to closing, i.e., the regions' boundaries are smoothed and holes within a region which are smaller than the circular structuring element of radius Radius are closed. The closing_circleoperation is defined as a dilation followed by a Minkowski subtraction, both with the same circular structuring element.

closing_circle的行为类似于关闭，即。该区域的边界是平滑的，区域内的孔洞小于半径半径的圆形结构单元。closing_circle操作被定义为一个扩展，后面跟着一个闵可夫斯基减法，两者都具有相同的循环结构元素。

---

画一个椭圆形或圆形的XLD轮廓

gen_ellipse_contour_xld (：TrackballContour： Cy, Cx, 0, TrackballRadiusPixel, TrackballRadiusPixel, 0, 6.28318, 'positive', 1.5：)

TrackballContour：输出的椭圆轮廓，圆是特殊的椭圆。

Cy：椭圆中心的行坐标

Cx：椭圆中心的列坐标

 0：与主轴之间的角度 

TrackballRadiusPixel：半长轴的长度

TrackballRadiusPixel：半短轴的长度

0：椭圆的外接圆的第一个点的起始点

6.28318：就是2*3.1415926，椭圆的外接圆的第一个点的起始点

 'positive',顺时针还是逆时针的意思，这里看着更像逆时针呀

1.5：相邻轮廓点之间的最大距离