expand_grayexpand_grayExpandGrayExpandGrayexpand_gray (算子)
名称
expand_grayexpand_grayExpandGrayExpandGrayexpand_gray — 填充区域之间的间隙（取决于灰度值或颜色）或分割重叠区域。
签名
Herror expand_gray(const Hobject Regions, const Hobject Image, const Hobject ForbiddenArea, Hobject* RegionExpand, const char* Iterations, const char* Mode, const Hlong Threshold)
Herror T_expand_gray(const Hobject Regions, const Hobject Image, const Hobject ForbiddenArea, Hobject* RegionExpand, const Htuple Iterations, const Htuple Mode, const Htuple Threshold)
void ExpandGray(const HObject& Regions, const HObject& Image, const HObject& ForbiddenArea, HObject* RegionExpand, const HTuple& Iterations, const HTuple& Mode, const HTuple& Threshold)
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const HTuple& Iterations, const HString& Mode, const HTuple& Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const HString& Iterations, const HString& Mode, Hlong Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const char* Iterations, const char* Mode, Hlong Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const wchar_t* Iterations, const wchar_t* Mode, Hlong Threshold) const
(
Windows only)
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const HTuple& Iterations, const HString& Mode, const HTuple& Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const HString& Iterations, const HString& Mode, Hlong Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const char* Iterations, const char* Mode, Hlong Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const wchar_t* Iterations, const wchar_t* Mode, Hlong Threshold) const
(
Windows only)
static void HOperatorSet.ExpandGray(HObject regions, HObject image, HObject forbiddenArea, out HObject regionExpand, HTuple iterations, HTuple mode, HTuple threshold)
HRegion HImage.ExpandGray(HRegion regions, HRegion forbiddenArea, HTuple iterations, string mode, HTuple threshold)
HRegion HImage.ExpandGray(HRegion regions, HRegion forbiddenArea, string iterations, string mode, int threshold)
HRegion HRegion.ExpandGray(HImage image, HRegion forbiddenArea, HTuple iterations, string mode, HTuple threshold)
HRegion HRegion.ExpandGray(HImage image, HRegion forbiddenArea, string iterations, string mode, int threshold)
描述
expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray closes gaps between the input regions,
which resulted from the suppression of small regions in a
segmentation operator, (mode 'image'"image""image""image""image""image"), for example, or
separates overlapping regions 'region'"region""region""region""region""region").
Both uses result
from the expansion of regions. The operator works by adding a one
pixel wide “strip” to a region, in which the gray values or color
are different from the gray values or color of neighboring pixels on
the region's border by at most ThresholdThresholdThresholdThresholdthresholdthreshold (in each
channel). For images of type 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic" (e.g., direction
images), also points with a gray value difference of at least 255 -
ThresholdThresholdThresholdThresholdthresholdthreshold are added to the output region.
The expansion takes place only in regions, which are designated as
not “forbidden” (parameter ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area). The number
of iterations is determined by the parameter IterationsIterationsIterationsIterationsiterationsiterations.
By passing 'maximal'"maximal""maximal""maximal""maximal""maximal", expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray iterates
until convergence, i.e., until no more changes occur. By passing 0
for this parameter, all non-overlapping regions are returned. The
two modes of operation ('image'"image""image""image""image""image" and 'region'"region""region""region""region""region")
are different in the following ways:
- 'image'
The input regions are expanded iteratively until they
touch another region or the image border, or the expansion
stops because of too high gray value differences. Because
expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray processes all regions
simultaneously, gaps between regions are distributed
evenly to all regions with a similar gray value.
Overlapping regions are split by distributing the area of
overlap evenly to both regions.
- 'region'
No expansion of the input regions is performed. Instead,
only overlapping regions are split by distributing the
area of overlap evenly to regions having a matching gray
value or color.
注意
Because regions are only expanded into areas having a matching gray
value or color, usually gaps will remain between the output regions,
i.e., the segmentation is not complete.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
RegionsRegionsRegionsRegionsregionsregions (输入对象) region(-array) → objectHRegionHObjectHRegionHobject
Regions for which the gaps are to be closed, or which
are to be separated.
ImageImageImageImageimageimage (输入对象) (multichannel-)image → objectHImageHObjectHImageHobject (byte / cyclic)
Image (possibly multi-channel) for gray value or color
comparison.
ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area (输入对象) region → objectHRegionHObjectHRegionHobject
Regions in which no expansion takes place.
RegionExpandRegionExpandRegionExpandRegionExpandregionExpandregion_expand (输出对象) region(-array) → objectHRegionHObjectHRegionHobject *
Expanded or separated regions.
IterationsIterationsIterationsIterationsiterationsiterations (输入控制) string → HTupleUnion[int, str]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Number of iterations.
默认值：
'maximal'
"maximal"
"maximal"
"maximal"
"maximal"
"maximal"
建议值：
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 'maximal'"maximal""maximal""maximal""maximal""maximal"
值范围：
1
≤
Iterations
Iterations
Iterations
Iterations
iterations
iterations
≤
500 (lin)
最小增量：
1
建议增量：
1
ModeModeModeModemodemode (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Expansion mode.
默认值：
'image'
"image"
"image"
"image"
"image"
"image"
值列表：
'image'"image""image""image""image""image", 'region'"region""region""region""region""region"
ThresholdThresholdThresholdThresholdthresholdthreshold (输入控制) integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximum difference between the gray value or color at
the region's border and a candidate for expansion.
默认值：
32
建议值：
5, 10, 15, 20, 25, 30, 40, 50
值范围：
1
≤
Threshold
Threshold
Threshold
Threshold
threshold
threshold
≤
255 (lin)
最小增量：
1
建议增量：
5
示例 (C++ (HALCON 5.0-10.0))
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
示例（C）
read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
regiongrowing(Image,&RawSegments,3,3,6.0,100);
set_colored(WindowHandle,12);
disp_region(RawSegments,WindowHandle);
expand_gray(RawSegments,Image,EMPTY_REGION,&Segments,"maximal","image",24);
disp_region(Segments,WindowHandle)
示例 (C++ (HALCON 5.0-10.0))
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
示例 (C++ (HALCON 5.0-10.0))
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
示例 (C++ (HALCON 5.0-10.0))
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
结果
expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray 始终返回值 2 ( H_MSG_TRUE )。当输入为空（未指定区域）时则可设置行为通过 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>)，当输入区域为空时则设置行为通过 set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)，以及当结果区域为空时则设置行为通过 set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)set_system("store_empty_region",<"true"/"false">)。如有必要，则抛出异常。
可能的前趋
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring,
class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNormclass_ndim_norm
可能的后继
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape
另见
expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref,
expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region
模块
基础