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 indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) | |
|
ipSrcMap1 |
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 |
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 |
Destination map 1 (Must not be the same as ipSrcMap1 or ipSrcMap2! An appropriate destination image will be created if required.) | |
|
ipDestMap2 |
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 |
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) |
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4026 or later | PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |