halcon算子翻译——gen_image_surface_second_order

名称

gen_image_surface_second_order - 使用二阶多项式创建灰色曲面。

用法

gen_image_surface_second_order( : ImageSurface : Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height : )

描述

算子gen_image_surface_second_order根据以下公式创建一个灰度值曲面：

　　图像的大小由Width和Height决定。 参数Row和Column定义创建的灰色曲面的参考点。 灰色值的类型为Type（有关像素类型的详细说明，请参阅gen_image_const）。 有效区域外的灰度值会被剪切。

并行

●　　多线程类型：可重入（与非独占算子并行运行）。
●　　多线程范围：全局（可以从任何线程调用）。
●　　不并行化处理。

参数

ImageSurface (output_object) 　　image → object (byte / uint2 / real)
　　新创建的图像矩阵。

Type (input_control) 　　 string → (string)
　　像素类型。
　　Default value: 'byte'
　　List of values: 'byte', 'real', 'uint2'

Alpha (input_control) 　　 number → (real)
　　垂直方向的二阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Beta (input_control) 　　 number → (real)
　　水平方向的二阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Gamma (input_control) 　　 number → (real)
　　混合二阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Delta (input_control) 　　 number → (real)
　　垂直方向的一阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Epsilon (input_control) 　　 number → (real)
　　水平方向上的一阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Zeta (input_control) 　　 number → (real)
　　零阶系数。
　　Default value: 1.0
　　Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Row (input_control) 　　 number → (real)
　　曲面参考点的行坐标。
　　Default value: 256.0
　　Suggested values: 0.0, 128.0, 256.0, 512.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Column (input_control) 　　 number → (real)
　　曲面参考点的列坐标。
　　Default value: 256.0
　　Suggested values: 0.0, 128.0, 256.0, 512.0
　　Minimum increment: 0.000001
　　Recommended increment: -0.005

Width (input_control) 　　 extent.x → (integer)
　　图像宽度。
　　Default value: 512
　　Suggested values: 128, 256, 512, 1024
　　Typical range of values: 1 ≤ Width ≤ 512 (lin)
　　Minimum increment: 1
　　Recommended increment: 10
　　Restriction: Width >= 1

Height (input_control)　　 extent.y → (integer)
　　图像高度。
　　Default value: 512
　　Typical range of values: 1 ≤ Height ≤ 512 (lin)
　　Minimum increment: 1
　　Recommended increment: 10
　　Restriction: Height >= 1

Example (HDevelop)

* Adjust an inhomogeneous illumination
* using gen_image_surface_second_order
read_image (Image, 'cap_illumination/cap_illumination_01')
get_image_size (Image, Width, Height)
gen_circle (Circle, 495, 630, 350.5)
difference (Image, Circle, RegionDifference)
fit_surface_second_order (RegionDifference, Image, 'regression', 5, 2, 
                          Alpha, Beta, Gamma, Delta, Epsilon, Zeta)
area_center (RegionDifference, Area, Row, Column)
gen_image_surface_second_order (ImageSurface, 'byte', Alpha, Beta, 
                                Gamma, Delta, Epsilon, Zeta, Row, Column, 
                                Width, Height)
sub_image (Image, ImageSurface, ImageSub, 1, 128)

结果

如果参数值正确，则gen_image_surface_second_order返回值2（H_MSG_TRUE）。 否则会引发异常。

Possible Predecessors

fit_surface_second_order

Possible Successors

sub_image

See also

gen_image_gray_ramp, gen_image_surface_first_order, gen_image_const

模块

Foundation

HDevelop例程

determine_tilt_slant_photometric_stereo.hdev 确定光度立体视觉体系的光源的方向