convert_map_typeconvert_map_typeConvertMapTypeConvertMapType (Operator)

Name

convert_map_typeconvert_map_typeConvertMapTypeConvertMapType — Convert image maps into other map types.

Signature

Description

convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeConvertMapType converts the input MapMapMapMapmap into a different map type. The main usage of convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeConvertMapType is to convert a nearest neighbor or bilinear map (e.g., obtained by gen_image_to_world_plane_mapgen_image_to_world_plane_mapGenImageToWorldPlaneMapGenImageToWorldPlaneMapGenImageToWorldPlaneMap) to a coordinate map, as this is the only type supported on compute devices.

NewTypeNewTypeNewTypeNewTypenewType specifies the type of conversion. The following values are supported:

'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix"

creates a map that consists of a vector_field image which contains the absolute subpixel precise row and column coordinates of each pixel's mapping. (input map must be 'bilinear'"bilinear""bilinear""bilinear""bilinear" or 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor")

'bilinear'"bilinear""bilinear""bilinear""bilinear"

creates a map with linear coordinates and bilinear interpolation coefficients (see map_imagemap_imageMapImageMapImageMapImage). (input map must be 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix")

'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"

creates a nearest neighbor map with linear coordinates (see map_imagemap_imageMapImageMapImageMapImage). (input map must be 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix")

In ImageWidthImageWidthImageWidthImageWidthimageWidth the width of the images to be mapped by MapConvertedMapConvertedMapConvertedMapConvertedmapConverted must be given. If this width is identical to the width of MapMapMapMapmap, you can pass the string 'map_width'"map_width""map_width""map_width""map_width".

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (HDevelop)

gen_radial_distortion_map (MapFixed, CamParOriginal, CamParVirtualFixed, \
                           'bilinear')
convert_map_type(MapFixed, MapConverted, 'coord_map_sub_pix', 'map_width')
query_available_compute_devices (DeviceIdentifier)
open_compute_device (DeviceIdentifier[0], DeviceHandle)
activate_compute_device (DeviceHandle)
map_image (GrayImage, MapConverted, ImageRectifiedFixed)

Result

convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeConvertMapType returns 2 (H_MSG_TRUE) if all parameter values are correct.

Possible Predecessors

gen_image_to_world_plane_mapgen_image_to_world_plane_mapGenImageToWorldPlaneMapGenImageToWorldPlaneMapGenImageToWorldPlaneMap, gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMap, gen_arbitrary_distortion_mapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMapGenArbitraryDistortionMap, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMap, find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelFindLocalDeformableModel

Possible Successors

map_imagemap_imageMapImageMapImageMapImage

Module

Foundation