gen_image_warp_map T_gen_image_warp_map GenImageWarpMap GenImageWarpMap gen_image_warp_map (Operator)
gen_image_warp_map T_gen_image_warp_map GenImageWarpMap GenImageWarpMap gen_image_warp_map
— Generate an image map based on non-regular correspondence points.
Signature
gen_image_warp_map ( : Map : Row1 , Column1 , Row2 , Column2 , ImageWidth , ImageHeight , MapWidth , MapHeight , Method , MapType , GenParamName , GenParamValue : )
Herror T_gen_image_warp_map (Hobject* Map , const Htuple Row1 , const Htuple Column1 , const Htuple Row2 , const Htuple Column2 , const Htuple ImageWidth , const Htuple ImageHeight , const Htuple MapWidth , const Htuple MapHeight , const Htuple Method , const Htuple MapType , const Htuple GenParamName , const Htuple GenParamValue )
void GenImageWarpMap (HObject* Map , const HTuple& Row1 , const HTuple& Column1 , const HTuple& Row2 , const HTuple& Column2 , const HTuple& ImageWidth , const HTuple& ImageHeight , const HTuple& MapWidth , const HTuple& MapHeight , const HTuple& Method , const HTuple& MapType , const HTuple& GenParamName , const HTuple& GenParamValue )
static void HOperatorSet .GenImageWarpMap (out HObject map , HTuple row1 , HTuple column1 , HTuple row2 , HTuple column2 , HTuple imageWidth , HTuple imageHeight , HTuple mapWidth , HTuple mapHeight , HTuple method , HTuple mapType , HTuple genParamName , HTuple genParamValue )
def gen_image_warp_map (row_1 : Sequence[float], column_1 : Sequence[float], row_2 : Sequence[float], column_2 : Sequence[float], image_width : int, image_height : int, map_width : int, map_height : int, method : str, map_type : str, gen_param_name : MaybeSequence[str], gen_param_value : MaybeSequence[Union[int, float, str]]) -> HObject
Description
gen_image_warp_map gen_image_warp_map GenImageWarpMap GenImageWarpMap gen_image_warp_map
generates an image Map Map Map map map
based
on the non-regular correspondence points (Row1 Row1 Row1 row1 row_1
, Column1 Column1 Column1 column1 column_1
)
and (Row2 Row2 Row2 row2 row_2
, Column2 Column2 Column2 column2 column_2
).
Given the correspondence points (Row1 Row1 Row1 row1 row_1
, Column1 Column1 Column1 column1 column_1
)
and (Row2 Row2 Row2 row2 row_2
, Column2 Column2 Column2 column2 column_2
), the generated Map Map Map map map
maps
points from (Row2 Row2 Row2 row2 row_2
, Column2 Column2 Column2 column2 column_2
) to (Row1 Row1 Row1 row1 row_1
,
Column1 Column1 Column1 column1 column_1
) while generating a smooth mapping for all other
coordinates.
Specify the size of the input image for the mapping with ImageWidth ImageWidth ImageWidth imageWidth image_width
and ImageHeight ImageHeight ImageHeight imageHeight image_height
. Only pixels within this area will be accessed when
applying the generated map.
The size of the generated Map Map Map map map
can be set with MapWidth MapWidth MapWidth mapWidth map_width
and
MapHeight MapHeight MapHeight mapHeight map_height
. In combination with how (Row1 Row1 Row1 row1 row_1
, Column1 Column1 Column1 column1 column_1
)
are selected the map can be configured to transform only a specific part
of the input image.
With Method Method Method method method
the algorithm to generate the map can be selected. Currently,
only 'thin_plate_spline' "thin_plate_spline" "thin_plate_spline" "thin_plate_spline" "thin_plate_spline" is available. This method interpolates on
a global scale, which means that all points are regarded for the
interpolation, no matter how far away they are. The influence of far points
is correlated to
where
defines the distance of two points.
With MapType MapType MapType mapType map_type
the type of the output map can be selected. Currently,
only 'coord_map_sub_pix' "coord_map_sub_pix" "coord_map_sub_pix" "coord_map_sub_pix" "coord_map_sub_pix" is available (convert_map_type convert_map_type ConvertMapType ConvertMapType convert_map_type
describes the types).
Further method specific parameters are passed with GenParamName GenParamName GenParamName genParamName gen_param_name
and
GenParamValue GenParamValue GenParamValue genParamValue gen_param_value
. The currently supported method does not accept
additional parameters.
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on internal data level.
Parameters
Map Map Map map map
(output_object) singlechannelimage →
object HImage HObject HObject Hobject * (vector_field)
Generated image map.
Row1 Row1 Row1 row1 row_1
(input_control) point.y-array →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row coordinate of original correspondence points.
Column1 Column1 Column1 column1 column_1
(input_control) point.x-array →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column coordinate of original correspondence points.
Restriction:
number(Row1) == number(Column1)
Row2 Row2 Row2 row2 row_2
(input_control) point.y-array →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row coordinate of target correspondence points.
Restriction:
number(Row2) == number(Row1)
Column2 Column2 Column2 column2 column_2
(input_control) point.x-array →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column coordinate of target correspondence points.
Restriction:
number(Column2) == number(Column1)
ImageWidth ImageWidth ImageWidth imageWidth image_width
(input_control) extent.x →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Width of the image to map.
Restriction:
ImageWidth > 0
ImageHeight ImageHeight ImageHeight imageHeight image_height
(input_control) extent.y →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Height of the image to map.
Restriction:
ImageHeight > 0
MapWidth MapWidth MapWidth mapWidth map_width
(input_control) extent.x →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Width of the generated map.
Restriction:
MapWidth > 0
MapHeight MapHeight MapHeight mapHeight map_height
(input_control) extent.y →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Height of the generated map.
Restriction:
MapHeight > 0
Method Method Method method method
(input_control) string →
HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Method used to create the map.
Default:
'thin_plate_spline'
"thin_plate_spline"
"thin_plate_spline"
"thin_plate_spline"
"thin_plate_spline"
MapType MapType MapType mapType map_type
(input_control) string →
HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Type of the generated map.
Default:
'coord_map_sub_pix'
"coord_map_sub_pix"
"coord_map_sub_pix"
"coord_map_sub_pix"
"coord_map_sub_pix"
GenParamName GenParamName GenParamName genParamName gen_param_name
(input_control) attribute.name(-array) →
HTuple MaybeSequence[str] HTuple Htuple (string) (string ) (HString ) (char* )
Names of additional parameters.
Default:
[]
GenParamValue GenParamValue GenParamValue genParamValue gen_param_value
(input_control) attribute.name(-array) →
HTuple MaybeSequence[Union[int, float, str]] HTuple Htuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Values of additional parameters.
Default:
[]
Possible Successors
map_image map_image MapImage MapImage map_image
Alternatives
gen_arbitrary_distortion_map gen_arbitrary_distortion_map GenArbitraryDistortionMap GenArbitraryDistortionMap gen_arbitrary_distortion_map
,
gen_grid_rectification_map gen_grid_rectification_map GenGridRectificationMap GenGridRectificationMap gen_grid_rectification_map
Module
Foundation