ConvertMaps

Converts between different map types, usually from floating to fixed point to speed up RemapImage. Supported pairs are (map1 = ET_REAL, 2 channels; map2 = 0), (map1 = ET_REAL, 1 channel; map2 = ET_REAL, 1 channel), (map1 = ET_INT, 2 channels; map2 = ET_UINT, 1 channel), (map1 = ET_INT, 2 channels; map2 = 0).

Syntax

Definition:

HRESULT ConvertMaps(
    HRESULT          hrPrev,
    ITcVnImage*      ipSrcMap1,
    ITcVnImage*      ipSrcMap2,
    ITcVnImage*&     ipDestMap1,
    ITcVnImage*&     ipDestMap2,
    ETcVnElementType eDestMap1Type,
    USHORT           nDestMap1Channels
)

Parameters

Name

Type

Description

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

ipSrcMap1

ITcVnImage*

Source map 1 (ET_REAL with 2 channels (containing mapX, mapY) or ET_REAL with 1 channel (containing mapX) or ET_INT with 2 channels (containing rounded mapX, mapY))

ipSrcMap2

ITcVnImage*

Source map 2 (ET_REAL with 1 channel (containing mapY) or ET_UINT with 1 channel (containing interpolation table coefficients if ipSrcMap1 is ET_INT with 2 channels), otherwise set to 0 if not required.

ipDestMap1

ITcVnImage*&

Destination map 1 (Must not be the same as ipSrcMap1 or ipSrcMap2! An appropriate destination image will be created if required.)

ipDestMap2

ITcVnImage*&

Destination map 2 (Must not be the same as ipSrcMap1 or ipSrcMap2! Set to 0 if not required, i.e. if ipDestMap1 is ET_REAL with 2 channels. Otherwise an appropriate destination image will be created if required.)

eDestMap1Type

ETcVnElementType

Requested type of the resulting ipDestMap1 (ET_REAL or ET_INT). The type of ipDestMap2 is automatically determined, i.e. ET_REAL or ET_UINT or none.

nDestMap1Channels

USHORT

Requested number of channels of the resulting ipDestMap1 (1 or 2, must be 2 if eDestMap1Type is ET_INT)

 Return value

HRESULT

Required License

TC3 Vision Base