points_harris_binomial T_points_harris_binomial PointsHarrisBinomial PointsHarrisBinomial points_harris_binomial (算子)
名称
points_harris_binomial T_points_harris_binomial PointsHarrisBinomial PointsHarrisBinomial points_harris_binomial — 使用哈里斯(Harris)算子的二项式近似来检测感兴趣的点。
签名
void PointsHarrisBinomial (const HObject& Image , const HTuple& MaskSizeGrad , const HTuple& MaskSizeSmooth , const HTuple& Alpha , const HTuple& Threshold , const HTuple& Subpix , HTuple* Row , HTuple* Column )
void HImage ::PointsHarrisBinomial (Hlong MaskSizeGrad , Hlong MaskSizeSmooth , double Alpha , const HTuple& Threshold , const HString& Subpix , HTuple* Row , HTuple* Column ) const
void HImage ::PointsHarrisBinomial (Hlong MaskSizeGrad , Hlong MaskSizeSmooth , double Alpha , double Threshold , const HString& Subpix , HTuple* Row , HTuple* Column ) const
void HImage ::PointsHarrisBinomial (Hlong MaskSizeGrad , Hlong MaskSizeSmooth , double Alpha , double Threshold , const char* Subpix , HTuple* Row , HTuple* Column ) const
void HImage ::PointsHarrisBinomial (Hlong MaskSizeGrad , Hlong MaskSizeSmooth , double Alpha , double Threshold , const wchar_t* Subpix , HTuple* Row , HTuple* Column ) const
(
Windows only)
static void HOperatorSet .PointsHarrisBinomial (HObject image , HTuple maskSizeGrad , HTuple maskSizeSmooth , HTuple alpha , HTuple threshold , HTuple subpix , out HTuple row , out HTuple column )
void HImage .PointsHarrisBinomial (int maskSizeGrad , int maskSizeSmooth , double alpha , HTuple threshold , string subpix , out HTuple row , out HTuple column )
void HImage .PointsHarrisBinomial (int maskSizeGrad , int maskSizeSmooth , double alpha , double threshold , string subpix , out HTuple row , out HTuple column )
描述
points_harris points_harris PointsHarris PointsHarris PointsHarris points_harris extracts points of interest from an image
Image Image Image Image image image . The Harris operator is based upon the smoothed matrix
where
stands for a Binomial smoothing of size
MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth maskSizeSmooth mask_size_smooth and
and
are
the first derivatives of the image, computed with a Sobel
filter of size MaskSizeGrad MaskSizeGrad MaskSizeGrad MaskSizeGrad maskSizeGrad mask_size_grad . The resulting points are the
positive local extrema of
If necessary, they can be restricted to points with a minimum filter
response of Threshold Threshold Threshold Threshold threshold threshold . By default the coordinates of the points
are calculated with subpixel accuracy. This can be turned off by setting
the parameter Subpix Subpix Subpix Subpix subpix subpix to 'off'.
注意
请注意,若使用域缩减后的图像作为输入,滤波器算子可能会返回意外结果。请参阅 滤波器 一章
执行信息
多线程类型:可重入(与非独占算子并行运行)。
多线程作用域:全局(可从任何线程调用)。
在内部数据级别上自动并行化。
参数
Image Image Image Image image image (输入对象) (multichannel-)image → object HImage HObject HImage Hobject (byte / uint2)
输入图像。
MaskSizeGrad MaskSizeGrad MaskSizeGrad MaskSizeGrad maskSizeGrad mask_size_grad (输入控制) integer → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Amount of binomial smoothing used for the calculation
of the gradient.
默认值:
5
建议值:
3, 5, 7, 9, 11, 15, 21, 31
值范围:
1
≤
MaskSizeGrad
MaskSizeGrad
MaskSizeGrad
MaskSizeGrad
maskSizeGrad
mask_size_grad
建议增量:
2
MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth MaskSizeSmooth maskSizeSmooth mask_size_smooth (输入控制) integer → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Amount of smoothing used for the integration of the
gradients.
默认值:
15
建议值:
3, 5, 7, 9, 11, 15, 21, 31
值范围:
1
≤
MaskSizeSmooth
MaskSizeSmooth
MaskSizeSmooth
MaskSizeSmooth
maskSizeSmooth
mask_size_smooth
建议增量:
2
Alpha Alpha Alpha Alpha alpha alpha (输入控制) real → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Weight of the squared trace of the squared gradient
matrix.
默认值:
0.08
建议值:
0.02, 0.03, 0.04, 0.05, 0.06, 0.07, 0.08
值范围:
0.0
≤
Alpha
Alpha
Alpha
Alpha
alpha
alpha
最小增量:
0.001
建议增量:
0.01
Threshold Threshold Threshold Threshold threshold threshold (输入控制) number → HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Minimum filter response for the points.
默认值:
1000.0
值范围:
0.0
≤
Threshold
Threshold
Threshold
Threshold
threshold
threshold
Subpix Subpix Subpix Subpix subpix subpix (输入控制) string → HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Turn on or off subpixel refinement.
默认值:
'on'
"on"
"on"
"on"
"on"
"on"
值列表:
'off' "off" "off" "off" "off" "off" , 'on' "on" "on" "on" "on" "on"
Row Row Row Row row row (输出控制) point.y-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row coordinates of the detected points.
Column Column Column Column column column (输出控制) point.x-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column coordinates of the detected points.
结果
points_harris points_harris PointsHarris PointsHarris PointsHarris points_harris returns 2 (
H_MSG_TRUE )
if all parameters are correct
and no error occurs during the execution. 如果输入为空则可设置行为通过 set_system('no_object_result',<Result>) set_system("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) set_system("no_object_result",<Result>) 。如有必要,则抛出异常。
可能的后继
gen_cross_contour_xld gen_cross_contour_xld GenCrossContourXld GenCrossContourXld GenCrossContourXld gen_cross_contour_xld
替代
points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner ,
points_harris points_harris PointsHarris PointsHarris PointsHarris points_harris ,
points_lepetit points_lepetit PointsLepetit PointsLepetit PointsLepetit points_lepetit ,
points_sojka points_sojka PointsSojka PointsSojka PointsSojka points_sojka
参考文献
C. Harris, M. Stephens: “A combined corner and edge
detector”. Proceedings of the 4th Alvey Vision Conference,
pp. 147-151, 1988.
V. Gouet, N.Boujemaa: “Object-based queries using color points of
interest”. IEEE Workshop on Content-Based Access of Image and Video
Libraries, CVPR/CBAIVL 2001, Hawaii, USA, 2001.
模块
基础