RegionsOperatorsmRgnArea Method

Parameters

regions

Type: MediaCy.IQL.FeaturesMcRegions

Return Value

Type: McMeasure

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type McRegions. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

This is a pixel-based measurement. So for regions created by the McThreshold.Execute method or McFeatures.SetFromMask method (features of Type mcftScanList), holes in the blob are significant (hole area is subtracted from the area of the equivalent blob with no holes). Use mRgnPolygonialArea for the area of the boundary polygon; that measurement is not affected by Holes. The measurement is computed as the count of pixels under and interior to the region boundary, excluding any holes, scaled by the pixel area of any current ancestor McImage.SpatialCalibration. An unscaled version is available as mRgnAreaUncalib. Note that this measurement effectively treats pixels as "tiles" with a given area. Thus unless the OptionFlags mcofOutlinePixelTiles bit is set, the measurement on any blob without holes will almost always be larger than the area reported by the mRgnPolygonialArea, since that is computed from from the boundary outline drawn on the pixel centers of the blob boundary pixels. See mRgnPolygonialArea for more discussion of these differences.