gen_grid_regiongen_grid_regionGenGridRegionGenGridRegiongen_grid_region (算子名称)
名称
gen_grid_regiongen_grid_regionGenGridRegionGenGridRegiongen_grid_region — Create a region from lines or pixels.
参数签名
Herror gen_grid_region(Hobject* RegionGrid, const Hlong RowSteps, const Hlong ColumnSteps, const char* Type, const Hlong Width, const Hlong Height)
Herror T_gen_grid_region(Hobject* RegionGrid, const Htuple RowSteps, const Htuple ColumnSteps, const Htuple Type, const Htuple Width, const Htuple Height)
void GenGridRegion(HObject* RegionGrid, const HTuple& RowSteps, const HTuple& ColumnSteps, const HTuple& Type, const HTuple& Width, const HTuple& Height)
void HRegion::GenGridRegion(const HTuple& RowSteps, const HTuple& ColumnSteps, const HString& Type, Hlong Width, Hlong Height)
void HRegion::GenGridRegion(Hlong RowSteps, Hlong ColumnSteps, const HString& Type, Hlong Width, Hlong Height)
void HRegion::GenGridRegion(Hlong RowSteps, Hlong ColumnSteps, const char* Type, Hlong Width, Hlong Height)
void HRegion::GenGridRegion(Hlong RowSteps, Hlong ColumnSteps, const wchar_t* Type, Hlong Width, Hlong Height)
(
Windows only)
static void HOperatorSet.GenGridRegion(out HObject regionGrid, HTuple rowSteps, HTuple columnSteps, HTuple type, HTuple width, HTuple height)
void HRegion.GenGridRegion(HTuple rowSteps, HTuple columnSteps, string type, int width, int height)
void HRegion.GenGridRegion(int rowSteps, int columnSteps, string type, int width, int height)
描述
The operator gen_grid_regiongen_grid_regionGenGridRegionGenGridRegionGenGridRegiongen_grid_region creates a grid constructed
of lines (TypeTypeTypeTypetypetype = 'lines') or pixels
(TypeTypeTypeTypetypetype = 'points').
In case of 'lines' continuous lines are returned, in case of
'points' only the intersections of the lines.
Starting from the pixel (0,0) to the pixel
(HeightHeightHeightHeightheightheight-1,WidthWidthWidthWidthwidthwidth-1) the grid is
built up at stepping width RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps in row
direction and ColumnStepsColumnStepsColumnStepsColumnStepscolumnStepscolumn_steps in column direction.
The step widths have to be greater than 1.
Exceptions are in 'lines' mode RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps, where
RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps or ColumnStepsColumnStepsColumnStepsColumnStepscolumnStepscolumn_steps can be set equal to 0.
In such a case, only columns, rows respectively, are created.
注意
If a very small pattern is chosen
(RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps < 4 or ColumnStepsColumnStepsColumnStepsColumnStepscolumnStepscolumn_steps
< 4) the created region requires much storage.
In the 'points' mode RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps and
ColumnStepsColumnStepsColumnStepsColumnStepscolumnStepscolumn_steps must not be set to zero.
运行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
参数表
RegionGridRegionGridRegionGridRegionGridregionGridregion_grid (output_object) region → objectHRegionHObjectHRegionHobject *
Created lines/pixel region.
RowStepsRowStepsRowStepsRowStepsrowStepsrow_steps (input_control) extent.y → HTupleUnion[float, int]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Step width in line direction or zero.
Default:
10
Suggested values:
0, 2, 3, 4, 5, 7, 10, 15, 20, 30, 50, 100
Value range:
RowSteps
RowSteps
RowSteps
RowSteps
rowSteps
row_steps
(lin)
Minimum increment:
1
Recommended increment:
10
Restriction:
RowSteps > 1 || RowSteps == 0
ColumnStepsColumnStepsColumnStepsColumnStepscolumnStepscolumn_steps (input_control) extent.x → HTupleUnion[float, int]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Step width in column direction or zero.
Default:
10
Suggested values:
0, 2, 3, 4, 5, 7, 10, 15, 20, 30, 50, 100
Value range:
ColumnSteps
ColumnSteps
ColumnSteps
ColumnSteps
columnSteps
column_steps
(lin)
Minimum increment:
1
Recommended increment:
10
Restriction:
ColumnSteps > 1 || ColumnSteps == 0
TypeTypeTypeTypetypetype (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Type of created pattern.
Default:
'lines'
"lines"
"lines"
"lines"
"lines"
"lines"
List of values:
'lines'"lines""lines""lines""lines""lines", 'points'"points""points""points""points""points"
WidthWidthWidthWidthwidthwidth (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximum width of pattern.
Default:
512
Suggested values:
128, 256, 512, 1024
Value range:
1
≤
Width
Width
Width
Width
width
width
(lin)
Minimum increment:
1
Recommended increment:
10
HeightHeightHeightHeightheightheight (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximum height of pattern.
Default:
512
Suggested values:
128, 256, 512, 1024
Value range:
1
≤
Height
Height
Height
Height
height
height
(lin)
Minimum increment:
1
Recommended increment:
10
例程 (HDevelop)
read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)
例程 (C)
read_image(&Image,"fabrik");
gen_grid_region(&Raster,10,10,"lines",512,512);
reduce_domain(Image,Raster,&Mask);
sobel_amp(Mask,GridSobel,"sum_abs",3);
T_disp_image(GridSobel,WindowHandle);
例程 (HDevelop)
read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)
例程 (HDevelop)
read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)
例程 (HDevelop)
read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)
Complexity
The necessary storage (in bytes) for the region is:
O((ImageWidth / ColumnSteps) * (ImageHeight / RowSteps))
结果
If the parameter values are correct the operator gen_grid_regiongen_grid_regionGenGridRegionGenGridRegionGenGridRegiongen_grid_region
returns the value 2 (
H_MSG_TRUE)
.
Otherwise an exception is raised.
The clipping according to the current image format is set via the operator
set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)set_system("clip_region",<"true"/"false">).
可能的后置算子
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region
可替代算子
gen_region_linegen_region_lineGenRegionLineGenRegionLineGenRegionLinegen_region_line,
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygongen_region_polygon,
gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPointsgen_region_points,
gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRunsgen_region_runs
参考其它
gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegionGenCheckerRegiongen_checker_region,
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain
模块
Foundation