IMcRefFeaturesReferenceFeature Property

Property Value

Type: IMcFeatures

Depending on the measurement, the ReferenceFeature may be required to be an McPoints, McLines or McRegions instance. Some measurements may allow any of these. For measurements each parent feature is associated with the corresponding reference feature to the exent possible, with reference features being reused as necessary. Thus if there is only one reference feature, then all measurements will be to that. And if there are as many reference features as measured features, then each feature measurement will be to the reference feature with the same feature index. Other associations are legal but not very useful, so in most situations the ReferenceFeature will be populated with either a Count of one or will have a Count equal to the parent McFeatures.Count. Measurements will be recomputed as necessary if either the parent McFeatures or the reference McFeatures changes. Similarly, measurements that depend on image data will be recomputed as necessary if either the ancestor McImage of the parent McFeatures or of the reference McFeatures changes. These images do not need to be the same, though they usually will be. However, when the ancestor image of the ReferenceFeature is different than the ancestor McImage of this object, then changes to the reference feature's ancestor McImage.SpatialCalibration or McImage.IntensityCalibration properties are not automatically detected. In this case, you must assign to the McImage.SpatialCalibration or McImage.IntensityCalibration properties after making changes to them.

'Example 1. Use McRegions.Reference property
' and use it to get distance from the Aoi's to a ref point
Set ThisApplication.ActiveImage.Aoi.Reference.ReferenceFeature = ThisApplication.ActiveImage.PointFeatures
Debug.Print "Distance from Aoi centroids to ref point = " & _
McToText( ThisApplication.ActiveImage.Aoi.Reference.mRefDistance)
'Example 2. Use CreateOperator to create a named McRefFeatures operator
' and use it to get distance from the Aoi's to a ref point
CreateOperator "McRefFeatures", ThisApplication.ActiveImage.Aoi, "RefPoint"
Set ThisApplication.ActiveImage.Aoi.RefPoint.ReferenceFeature = ThisApplication.ActiveImage.PointFeatures
Debug.Print "Distance from Aoi centroids to ref point = " & _
McToText( ThisApplication.ActiveImage.Aoi.RefPoint.mRefDistance)