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

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)

def convert_map_type(map: HObject, new_type: str, image_width: Union[int, str]) -> HObject

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

Parameters

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

Input map.

MapConvertedMapConvertedMapConvertedMapConvertedmapConvertedmap_converted (output_object)  (multichannel-)image objectHImageHObjectHImageHobject * (vector_field / int4 / int8 / uint2)

Converted map.

NewTypeNewTypeNewTypeNewTypenewTypenew_type (input_control)  string HTuplestrHTupleHtuple (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" "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 HTupleUnion[int, str]HTupleHtuple (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" "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