MregTransformCoordinate

Board	Supported
Host System	Yes
V4L2	Yes
Clarity UHD	Yes
Concord PoE	No
GenTL	Yes
GevIQ	Yes
GigE Vision	Yes
Indio	No
Iris GTX	Yes
Radient eV-CL	Yes
Rapixo CL	Yes
Rapixo CoF	Yes
Rapixo CXP	Yes
USB3 Vision	Yes

Convert a pair of coordinates between two of the following coordinate systems: the global pixel coordinate system, any registered image's pixel coordinate system, and the mosaic's coordinate system.

Syntax

void MregTransformCoordinate(
    AIL_ID       RegResultId,  //in
    AIL_INT      Source,       //in
    AIL_INT      Destination,  //in
    AIL_DOUBLE   X,            //in
    AIL_DOUBLE   Y,            //in
    AIL_DOUBLE * ResXPtr,      //out
    AIL_DOUBLE * ResYPtr,      //out
    AIL_INT64    ControlFlag   //in
)

Description

This function converts a pair of coordinates between two of the following coordinate systems: the global pixel coordinate system, any registered image's pixel coordinate system, and the mosaic's coordinate system.

Parameters

RegResultId (in, AIL_ID)

Specifies the registration result buffer that contains the information that will be used to transform the coordinates. The registration result buffer must have been previously allocated on the required system using MregAllocResult or restored from a file using MregRestore.

Source (in, AIL_INT)

Specifies the source coordinate system. This parameter must be set to one of the following values:

For the source coordinate system

Value	Description
M_MOSAIC	Specifies to use the coordinate system relative to which the mosaic will be composed. This coordinate system was specified using MregControl with M_MOSAIC_STATIC_INDEX.
M_REGISTRATION_GLOBAL	Specifies the global pixel coordinate system.
Value	Specifies the index of the registration result element associated with the image whose coordinate system to use.

Destination (in, AIL_INT)

Specifies the destination coordinate system. This parameter must be set to one of the following values:

For the destination coordinate system

Value	Description
M_MOSAIC	Specifies to use the coordinate system relative to which the mosaic will be composed. This coordinate system was specified using MregControl with M_MOSAIC_STATIC_INDEX.
M_REGISTRATION_GLOBAL	Specifies the global pixel coordinate system.
Value	Specifies the index of the registration result element associated with the image whose coordinate system to use.

X (in, AIL_DOUBLE)

Specifies the X-coordinate in the source coordinate system.

Y (in, AIL_DOUBLE)

Specifies the Y-coordinate in the source coordinate system.

ResXPtr *(out, AIL_DOUBLE)

Specifies the address in which to write the resulting X-coordinate. This coordinate is given in the coordinate system that is specified in the Destination parameter.

ResYPtr *(out, AIL_DOUBLE)

Specifies the address in which to write the resulting Y-coordinate. This coordinate is given in the coordinate system that is specified in the Destination parameter.

ControlFlag (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.