MblobMerge

This function merges the results of two blob result buffers into a single result buffer.

The source results are merged as if they were taken from two vertically adjacent child buffers of one image. As such, the destination result buffer uses the coordinate system of the first result buffer, and positional results from the second result buffer are translated in the Y-direction to take into account this coordinate system change. Border blobs that would touch if they were in one image are grouped into one grouped blob, assigned a single label, and recalculated as if the grouped blobs were one blob. Only features that were calculated for all the individual blobs in the group are recalculated for the new grouped blob; calculations are made using the results of the individual blobs in the group. See the Merging results section of Chapter 6: Blob analysis for more detailed explanations.

Note that after merging the results, you can perform an MblobSelect() operation to further include or exclude blobs in your destination result buffer, but if you perform an MblobCalculate() operation after the merge, all the results in the destination result buffer will be discarded.

The source blob results must have been calculated by a context that:

Note that if you add a specified moment to the context (using MblobControl() with M_MOMENT_GENERAL and M_SAVE_RUNS is disabled, M_MERGE will not be able to perform the moment calculation.

Furthermore, if you specify a sorting key for result retrieval, the sorting order will not be respected after the merge.

If both source result buffers have the same camera calibration information (although their results might be from different child images), the destination result buffer will have the same camera calibration information. If either of the source result buffers is uncalibrated, or if they have different camera calibration information, the destination result buffer will be uncalibrated.