McalAssociate

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

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

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

When associating a calibration context with an image, its child buffers, if any, will also be associated with the same calibration context. However, any previous 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 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 calibration information if the source images have the same calibration information. For more information, see the Calibration propagation section of Chapter 25: Calibrating your camera setup.

If you associate a calibration context with an image buffer containing an ROI, all graphic elements in the 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 graphics list, as well as any generated raster information, will not be calibrated. See MbufSetRegion() for more information.