convert_map_typeconvert_map_typeConvertMapTypeConvertMapType (Operator)

Name

convert_map_typeconvert_map_typeConvertMapTypeConvertMapType — Convert image maps into other map types.

Signature

convert_map_type(Map : MapConverted : NewType, ImageWidth : )

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

MapMapMapMapmap (input_object) (multichannel-)image → object (vector_field / int4 / int8 / uint2)

Input map.

MapConvertedMapConvertedMapConvertedMapConvertedmapConverted (output_object) (multichannel-)image → object (vector_field / int4 / int8 / uint2)

Converted map.

NewTypeNewTypeNewTypeNewTypenewType (input_control) string → (string)

Type of MapConverted.

Default value: 'coord_map_sub_pix' "coord_map_sub_pix" "coord_map_sub_pix" "coord_map_sub_pix" "coord_map_sub_pix"

List of values: 'bilinear'"bilinear""bilinear""bilinear""bilinear", '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"

ImageWidthImageWidthImageWidthImageWidthimageWidth (input_control) integer → (integer / string)

Width of images to be mapped.

Default value: 'map_width' "map_width" "map_width" "map_width" "map_width"

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

Operators