gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldgen_region_contour_xld (算子)
名称
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldgen_region_contour_xld — 从 XLD 轮廓创建区域。
签名
Herror gen_region_contour_xld(const Hobject Contour, Hobject* Region, const char* Mode)
Herror T_gen_region_contour_xld(const Hobject Contour, Hobject* Region, const Htuple Mode)
def gen_region_contour_xld(contour: HObject, mode: str) -> HObject
描述
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld creates a region RegionRegionRegionRegionregionregion from a
subpixel XLD contour ContourContourContourContourcontourcontour. The contour is sampled
according to the Bresenham algorithm and influenced by the parameter
'neighborhood'"neighborhood""neighborhood""neighborhood""neighborhood""neighborhood" of the operator set_systemset_systemSetSystemSetSystemSetSystemset_system。Open contours
are closed before converting them to regions. Finally, the parameter
ModeModeModeModemodemode defines whether the region is filled up ('filled'"filled""filled""filled""filled""filled")
or returned by its contour ('margin'"margin""margin""margin""margin""margin").
Please note that the coordinates of the contour points are rounded
to their nearest integer pixel coordinates during the conversion.
This may lead to unexpected results when passing the contour
obtained by the operator gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld to
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld：When setting ModeModeModeModemodemode of
gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld to 'border'"border""border""border""border""border", the input region
of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld and the output region of
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld differ. For example, let us assume
that the input region of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld consists of
the single pixel (1,1). Then, the resulting contour that is
obtained when calling gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld with
ModeModeModeModemodemode set to 'border'"border""border""border""border""border" consists of the five points
(0.5,0.5), (0.5,1.5), (1.5,1.5), (1.5,0.5), and (0.5,0.5).
Consequently, when passing this contour again to
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld, the resulting region consists of the
points (1,1), (1,2), (2,2), and (2,1).
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
ContourContourContourContourcontourcontour (输入对象) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject
Input contour(s).
RegionRegionRegionRegionregionregion (输出对象) region(-array) → objectHRegionHObjectHRegionHobject *
Created region(s).
ModeModeModeModemodemode (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Fill mode of the region(s).
默认值：
'filled'
"filled"
"filled"
"filled"
"filled"
"filled"
建议值：
'filled'"filled""filled""filled""filled""filled", 'margin'"margin""margin""margin""margin""margin"
可能的前趋
gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld,
gen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldGenContourPolygonRoundedXldGenContourPolygonRoundedXldgen_contour_polygon_rounded_xld
替代
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygongen_region_polygon,
gen_region_polygon_xldgen_region_polygon_xldGenRegionPolygonXldGenRegionPolygonXldGenRegionPolygonXldgen_region_polygon_xld
另见
set_systemset_systemSetSystemSetSystemSetSystemset_system
模块
基础