Create a region from an XLD contour.
gen_region_contour_xld creates a region Region from a subpixel XLD contour Contour. The contour is sampled according to the Bresenham algorithm and influenced by the parameter neighborhood of the operator set_system. Open contours are closed before converting them to regions. Finally, the parameter Mode defines whether the region is filled up (filled) or returned by its contour (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_xld to gen_region_contour_xld: When setting Mode of gen_contour_region_xld to border, the input region of gen_contour_region_xld and the output region of gen_region_contour_xld differ. For example, let us assume that the input region of gen_contour_region_xld consists of the single pixel (1,1). Then, the resulting contour that is obtained when calling gen_contour_region_xld with Mode set to 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_xld, the resulting region consists of the points (1,1), (1,2), (2,2), and (2,1).
|
Contour (input_object) |
xld_cont -> object |
| Input contour. | |
|
Region (output_object) |
region -> object |
| Created region. | |
|
Mode (input_control) |
string -> string |
| Fill mode of the region. | |
| Default value: 'filled' | |
| Suggested values: 'filled', 'margin' | |
gen_region_contour_xld is reentrant and processed without parallelization.
gen_contour_polygon_xld, gen_contour_polygon_rounded_xld
gen_region_polygon, gen_region_polygon_xld
Foundation