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 : )

Herror convert_map_type(const Hobject Map, Hobject* MapConverted, const char* NewType, const Hlong ImageWidth)

Herror T_convert_map_type(const Hobject Map, Hobject* MapConverted, const Htuple NewType, const Htuple ImageWidth)

void ConvertMapType(const HObject& Map, HObject* MapConverted, const HTuple& NewType, const HTuple& ImageWidth)

HImage HImage::ConvertMapType(const HString& NewType, const HTuple& ImageWidth) const

HImage HImage::ConvertMapType(const HString& NewType, Hlong ImageWidth) const

HImage HImage::ConvertMapType(const char* NewType, Hlong ImageWidth) const

HImage HImage::ConvertMapType(const wchar_t* NewType, Hlong ImageWidth) const   (Windows only)

static void HOperatorSet.ConvertMapType(HObject map, out HObject mapConverted, HTuple newType, HTuple imageWidth)

HImage HImage.ConvertMapType(string newType, HTuple imageWidth)

HImage HImage.ConvertMapType(string newType, int 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

Parameters

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

Input map.

MapConvertedMapConvertedMapConvertedMapConvertedmapConverted (output_object)  (multichannel-)image objectHImageHImageHobject * (vector_field / int4 / int8 / uint2)

Converted map.

NewTypeNewTypeNewTypeNewTypenewType (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

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 HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

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