MregTransformCoordinateList

• See also
User Guide:
Registration elements and images for correlation-stitching Retrieving and analyzing results Steps to performing a correlation-stitching registration
Reference:
MregAllocResult MregControl MregRestore MregTransformCoordinate
Availability
Not available in MIL-Lite
Available in MIL


Available on Windows
Available on Linux


Not supported on:
Not supported on Matrox Indio (Update 53 or Update 68) (w)
Not supported on Matrox Concord PoE with ToE (Update 82) (z)
Fully supported on:
Fully supported on Host system (a)
Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)
Fully supported on Matrox Morphis (g)
Fully supported on Matrox Morphis QxT (h)
Fully supported on Matrox Orion HD (i)
Fully supported on Matrox Radient eCL (j)
Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)
Fully supported on Matrox Solios eA/XA (l)
Fully supported on Matrox Solios ecl/xcl/ev-cl (m)
Fully supported on Matrox USB3 Vision driver (Update 19) (o)
Fully supported on Matrox RadientPro-CL (Update 7) (p)
Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)
Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)
Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)
Fully supported on Matrox GenTL driver (Update 34) (v)
Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)
Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)


* Refer to the MIL system-specific information
   in the MIL Reference for the minimum update required.


For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note


Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP/GPm
Available on Matrox Supersight
Function map
Examples
None.
MregTransformCoordinate
MregTransformImage

Description

Parameters

RegResultId

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

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. (summarize) Specifies to use the coordinate system relative to which the mosaic will be composed. (more details...)
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

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. (summarize) Specifies to use the coordinate system relative to which the mosaic will be composed. (more details...)
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.

NumPoints

Specifies the number of points in the coordinate list.

When using a standard vector (std::vector) overload function in C++, you can pass M_DEFAULT to this parameter and MIL will automatically determine the size based on the number of items in the vector passed to the SrcCoordXArrayPtr or SrcCoordYArrayPtr parameter.

SrcCoordXArrayPtr

Accepts the address of one of the following:

• array of type MIL_DOUBLE [optionally, in C++: a reference to a constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
  Required array size:(NumPoints)

Specifies the address of the array of the X-coordinates in the source coordinate system.

SrcCoordYArrayPtr

Accepts the address of one of the following:

• array of type MIL_DOUBLE [optionally, in C++: a reference to a constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
  Required array size:(NumPoints)

Specifies the address of the array of the Y-coordinates in the source coordinate system.

DstCoordXArrayPtr

Accepts the address of one of the following:

• array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
  Required array size:(NumPoints)

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.

DstCoordYArrayPtr

Accepts the address of one of the following:

• array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
  Required array size:(NumPoints)

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

Reserved for future expansion and must be set to M_DEFAULT.