McalAssociate

See also

User Guide:

After fixturing Annotating the displayed image non-destructively Camera calibration propagation Performing arithmetic operations on depth maps Propagating camera calibration information after performing a geometric operation Steps to performing a camera calibration

Reference:

MbufInquire MbufSetRegion MgraControl

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

Function Map

- SrcCalibrationOrMilId

Table:

For specifying the camera calibration context to associate with

- TargetImageOrDigitizerId

- ControlFlag

Table:

For specifying the function's control flag

Compilation information

Synopsis

Associate/disassociate a camera calibration context with/from an image or digitizer.

Syntax

void McalAssociate(

MIL_ID SrcCalibrationOrMilId,	//in
MIL_ID TargetImageOrDigitizerId,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function associates a camera calibration context with an image or digitizer. This function can also be used to disassociate a camera calibration context from an image or digitizer. Note that you do not have to first disassociate a camera calibration context from an image or digitizer to associate it with a different camera calibration context.

When you grab an image with a calibrated digitizer, the camera calibration context currently associated with the digitizer gets associated with the grabbed image.

When you associate a camera calibration context with an image using McalAssociate() or by grabbing with a calibrated digitizer, the image receives a copy of the camera calibration context's current coordinate systems and a reference to the camera calibration context for all other settings. When you associate a camera calibration context with a digitizer, the digitizer only receives a reference to the camera calibration context.

When associating a camera calibration context with an image, its child buffers, if any, will also be associated with the same camera calibration context. However, any previous camera calibration information of the child buffers will be overwritten by the new context associated with the parent.

If you copy or process the calibrated image, the operation will typically copy the image's camera calibration settings to the destination image. If multiple source images are used for the operation, the destination image will only receive a copy of the camera calibration information if the source images have the same camera calibration information. Most functions propagate the calibration settings, while others clear this information. For more information, see the Camera calibration propagation section of Chapter 26: Calibrating your camera setup.

If you associate a camera calibration context with an image buffer containing an ROI, all graphic elements in the 2D graphics list that were created in world units (using MgraControl() with M_INPUT_UNITS set to M_WORLD) will be associated with the same callibration information as the image; all other graphic elements in the 2D graphics list, as well as any generated raster information, will not be calibrated. See MbufSetRegion() for more information.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

SrcCalibrationOrMilId

Specifies the camera calibration context to associate. This parameter can be set to one of the following. If an image buffer, digitizer or result buffer is passed to this parameter, the camera calibration context associated with that object is used; camera calibration settings saved with the image, digitizer or result are also copied.

For specifying the camera calibration context to associate with
Value	Description
M_NULL	Specifies to remove the association between the camera calibration context and the image or digitizer.
Calibration context identifier	Specifies the camera calibration context to associate with the target image or digitizer.
Image buffer identifier	Specifies the image whose camera calibration information and reference to a camera calibration context will be associated with the target image or digitizer.
Processing or analysis module result buffer identifier	Specifies the processing or analysis module result whose camera calibration information and reference to a camera calibration context will be associated with the target image or digitizer.

TargetImageOrDigitizerId

Specifies the identifier of the image or digitizer with which to associate the camera calibration context.

ControlFlag

Specifies the function's control flag. This parameter must be set to the following value:

For specifying the function's control flag
Value	Description
M_DEFAULT	Sets the function's control to the default.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milcal.lib.
DLL	Requires mil.dll; milcal.dll.