Description

The base class for McPoints, McLines or McRegions objects holding image features

Object Model





Remarks

The McFeatures class is the base class common to McPoints, McLines and McRegions. Most of the methods and properties for each of these classes actually comes from the McFeatures base class

Events are also fired on both a dispinterface, _DMcFeaturesEvents, and a custom COM interface which should be used by clients where possible (VB always uses the dispinterface).

For every event, the ChangeMade event is always fired and then one of the other, more descriptive events is fired. Clients will usually either monitor just the ChangeMade event or just one or two of the others. If all you are interested in is “has the object changed” then just monitor the ChangeMade event; if the mcfcmAppearanceOnly bit is set in the ChangeFlags argument, then the change affects only the display of the feature(s), not their contents.

All McFeatures expose the McHasObject interface. If the McHasObject.FirePropertyChangeNotifies property is False, then events will not be fired. If you are doing extensive work on an McFeatures that involves many changes, you should set the McHasObject.FirePropertyChangeNotifies to False and then restore it to its original state before doing your final change on the McFeatures object. This will result in only one event being fired for the changes.

Members

Methods
AccessMaskedImageData

Create an McRegionAccess that bounds this McFeatures and is masked by it if this is an McRegions.

CleanUpBordersAndNoise

Removes small features and/or those that touch selected borders of the Image or the borders of a specified McRegions instance.

Clip

Clips a set of features to a given rectangle.

ClipToImage

Clips a set of features to the bounds of an image.

CopyFrom

CopyFrom a source McFeatures into this one, replacing all existing features with those from the source McFeatures.

CreateFeatureMask

Creates either an McImage or an McBitMask mask of foreground pixels for selected features.

DistanceToFeaturePoint

Finds the distance to a point along a feature line or boundary.

Duplicate

Returns a duplicate of the McFeatures instance.

FeatureFromPoint

Finds the index of the feature under a given point

FeaturePointAtDistanceFromStart

Finds the point on a feature line or boundary that is a given distance from the starting point on that feature.

GetBounds

Returns the entire features' pixel bounds

GetFeatureBoundingBox

Returns the bounds of all or selected features

GetFeaturePoints

Get a list of coordinate points that describe a feature.

GetFeaturePointsEx

Get a list of coordinate points that describe some aspect of a feature.

GetFeatures

Copies selected features into a new McFeatures interface.

GetLineSegments

For a given y-position, get the list of horizontal line segments that lie within the features bounds.

GetOrderedPosition

Identifies the relative postion of features.

Intersect

Intersect a second McFeatures with this one.

MaskOff

Mask off features with those from a second, masking, McFeatures.

Merge

Merge a second McFeatures with this one.

Move

Move all features a given pixel displacement in the x and y directions

PointClosestToPoint

Finds the feature point that is closest to a given point

RemoveFeature

One or more features are removed.

Reset

Clears an McFeatures interface to its initialized “reset” state (as it was after it was first created).

SelectorFromID

Get a selector for one or more Identifier values

SetFeaturePoints

Set the coordinate points that describe a feature.

SetFromMask

Sets all features from a source McBitMask.


Properties
AutoDisplayRead-write property

Enables automatic display of features.

AutoDisplayOverlayRead-only property

The McGraphOverlay upon which automatic display of features is done.

BoundingRectRead-only property

The bounds of all or selected features

ChangeCounterRead-only property

A running counter of changes made to the McFeatures

CountRead-only property

Count of the current number of features

DisplayedObjectsRead-only property

An McDisplayedObjects collection of McGraphObj instances.

DisplayOverlaysRead-only property

An McDisplayOverlays collection of McGraphOverlay instances

FeatureStatusFlagsRead-write property

Detailed status and other per-feature flags

IdentifierRead-only property

The feature Identifier property

IsEmptyRead-only property

Returns whether the region is “empty” or not

IsResetRead-only property

Returns whether the region is “reset” or not

OptionFlagsRead-write property

Flags reflecting and controlling optional behavior

SelectedRead-write property

A BOOLEAN property of each Feature setting and reflecting the Selected status.

SetFromMaskMethodRead-write property

Default method used to convert a bit mask into features.

SignatureRead-only property

A signature of one or all features.

SourceDataRead-write property

Per feature source data

SourceFlagsRead-write property

Per feature source flags

SpatialCalibrationRead-write property

A SpatialCalibration associated with this McFeatures

TypeRead-only property

The feature Type property