IMcPointsMerge Method

Sub Merge ( 
	varMcFeaturesSrc As Object
)

Merge is a "union" operation. If a McFeatures source is supplied, the resulting features are those from the original state, plus features from a merging McFeatures source. The source McFeatures is not affected. If no source McFeatures is supplied, then for McRegions that have the mcofKeepRegionsAsUnion OptionFlags off, overlapping features are merged together by combining their scan lists (honoring the mcofDefaultXorOnMerge OptionFlags bit as described below). The merged features will be recreated as polygons, while features that do not overlap are left in their original state. If a McFeatures source is supplied, this method behaves differently depending on whether as source the McFeatures type and state. For McPoints, McLines and McRegions with the mcofKeepRegionsAsUnion OptionFlags off, features from the merged McPoints, McLines or McRegions are appended (in this case, the source McFeatures must be of the same type as this one). In this mode, source feature Identifier property values are preserved (if the mcofKeepDuplicatesOnMerge OptionFlags bit is off , and the newly merged features will all have index values starting with the old Count property value. Also, in this mode the source McFeatures must be of the same type (McPoints, McLines or McRegions) as this one. If the mcofKeepDuplicatesOnMerge OptionFlags bit is off (the default case), then features that are identical to source features are removed before the merge. If the mcofKeepDuplicatesOnMerge OptionFlags bit set, then the Merge method will not eliminate features that are duplicated from the source McFeatures. That is, setting this option bit changes the Merge method into an "Append" method. When the mcofKeepDuplicatesOnMerge OptionFlags bit is on, new Identifier values are assigned to the appended features. For McRegions with the mcofKeepRegionsAsUnion OptionFlags on, any McFeatures type may be used as a source. Each pixel from the merging McFeatures, treated as a scan list, is OR'ed or XOR'ed with the McRegions pixels, depending on the state of the mcofDefaultXorOnMerge OptionFlags bit. Thus, pixels that are foreground in either will be preserved as foreground in the result (if OR'ing). If the merging McFeatures.OptionFlags mcofInvertFeatureMask bit is set, then the merging scan list is inverted before being merged. New Identifiers are assigned to the resulting connected regions. The mcofKeepDuplicatesOnMerge OptionFlags bit is ignored if the mcofKeepRegionsAsUnion bit is set, since in this case all region features are maintained as a single bitmap so duplicate features are intrinsically impossible. If the Count properties of merging and this McFeatures totals more than one, then the mcofOneFeatureOnly bit in the OptionFlags property is forced off.