convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeconvert_map_type (Operator)

Name

convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeconvert_map_type — Convert image maps into other map types.

Signature

convert_map_type(Map : MapConverted : NewType, ImageWidth : )

Description

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

NewTypeNewTypeNewTypeNewTypenewTypenew_type 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""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""bilinear" or 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor")
'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear": creates a map with linear coordinates and bilinear interpolation coefficients (see map_imagemap_imageMapImageMapImageMapImagemap_image). (input map must be 'coord_map_sub_pix'"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""nearest_neighbor": creates a nearest neighbor map with linear coordinates (see map_imagemap_imageMapImageMapImageMapImagemap_image). (input map must be 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix")

In ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width the width of the images to be mapped by MapConvertedMapConvertedMapConvertedMapConvertedmapConvertedmap_converted must be given. If this width is identical to the width of MapMapMapMapmapmap, you can pass the string 'map_width'"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

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

Input map.

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

Converted map.

NewTypeNewTypeNewTypeNewTypenewTypenew_type (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" "coord_map_sub_pix"

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

ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width (input_control) integer → (integer / string)

Width of images to be mapped.

Default value: 'map_width' "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_typeConvertMapTypeConvertMapTypeConvertMapTypeconvert_map_type returns TRUE if all parameter values are correct.

Possible Predecessors

gen_image_to_world_plane_mapgen_image_to_world_plane_mapGenImageToWorldPlaneMapGenImageToWorldPlaneMapGenImageToWorldPlaneMapgen_image_to_world_plane_map, gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map, gen_arbitrary_distortion_mapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMapGenArbitraryDistortionMapgen_arbitrary_distortion_map, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMapgen_grid_rectification_map, find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelFindLocalDeformableModelfind_local_deformable_model

Possible Successors

map_imagemap_imageMapImageMapImageMapImagemap_image

Module

Foundation

Operators