Description

An object representing a set of points.

Object Model













Remarks

An instance of this class is exposed as McImage.PointFeatures. Instances can also be created independently using McEngine.CreateOperator or the McFeatures.Duplicate method.

McPoints, like McRegions and McLines, derives from McFeatures, which controls a collection of point “features”. A “point feature” is a point overlying an image. Each McPoints instance holds zero or more of these features. Individual features are accessed by index or by an ID (McFeatures.Identifier). Most McFeatures properties and methods allow multiple, selected features to be accessed at once.

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

maPtLocationXYRead-only property

The X,Y location of the point.

MeasuresRead-only property

Measures give access to all measurements.

mPtDensityRead-only property

The calibrated image luminance (density or intensity) at the point.

mPtLocationXRead-only property

The X location of the point.

mPtLocationYRead-only property

The Y location of the point.

OptionFlagsRead-write property

Flags reflecting and controlling optional behavior

ReferenceRead-only property

Holds a reference feature for measurements that require it.

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

ThresholdRead-only property

A local threshold operator.

TypeRead-only property

The feature Type property


Events
ChangeMade

Fired for every change made to an McFeatures

CoordinatesChanged

Fired when coordinates of one or more features are changed

FeatureAdded

Fired when one or more features are added

FeatureRemoved

Fired when one or more features are removed

PropertyChanged

Fired when a property assignment is made to an McFeatures

Restructured

Fired when features get new Indentifiers