McLineProfiles Object
    
 
Description

Holds sampled line profiles for its ancestor McLines or McRegions

Object Model



Remarks

The McLineProfiles operator is exposed as McLines.Profiles and as McRegions.Profiles. It can also be created independently using McLineProfiles.Duplicate or McEngine.CreateOperator. The McLineProfiles.Duplicate method automatically creates a new object with the same parent, while you must supply the parent operator when using McEngine.CreateOperator. In any case, the instance must have an McLines or McRegions object as an ancestor, which must in turn have an McImage as an ancestor.

The operator is capable of sampling lumunance values under McLines features lines or McRegions features boundary polygons at either equal intervals or broken into equal numbers of samples (see McLineProfiles.SampleMode). Additionally it can expose these sampled lines along the ancestor McLines or McRegions features as another McLines (see McLineProfiles.SamplesAsMcLines).

Sampling involves getting four-nearest-neighbor interpolated luminance values, and depending on the sample length and the McLineProfiles.VirtualWidth property, averaging a set of those sub-samples to come up with a luminance value for each sample along the line profile. These profile values may be intensity calibrated or not (see McLineProfiles.CalibratedIntensity). Luminance may be taken from each color channel or an overall luminance intensity may be sampled.

McLineProfiles also expose a ProfileEdges property that is an McProfileEdges instance which can be used to find and mark points-of-interest along the profiles.

Members

Methods
CopyFrom

Sets sampling properties from a source McLineProfiles.

Duplicate

Creates a duplicated McLineProfiles.


Properties
CalibratedIntensityRead-write property

A read-write property specifying whether the ProfileValues are intensity calibrated or not.

CalibratedLengthRead-write property

A read-write property specifying whether the length properties and sample spacing are spatially calibrated or not.

CountOfProfilesRead-only property

A read-only property giving the count of line profiles available in the ProfileValues property.

FrameIndexRead-write property

A read-write property specifying which image frame the ProfileValues should be taken from.

InterpretationRead-write property

A read-write property specifying how the image data should be interpreted.

IsStaleRead-only property

A read-only property specifying whether the ProfileValues need to be recomputed.

LengthPerSampleRead-only property

A read-only property giving the length of the last sample section for each line profile.

LengthPerSampleDesiredRead-write property

A read-write property giving the length of each sample when the SampleMode is mclpsmFixedSampleLength.

NumberOfChannelsRead-only property

A read-only property giving the number of channels based on the Interpretation property for the ancestor image.

NumberOfSamplesRead-only property

A read-only property giving the number of sample sections each line profile is to be broken into.

NumberOfSamplesDesiredRead-write property

A read-write property giving the number of sample sections each line is to be broken into when the SampleMode is mclpsmFixedNumberOfSamples.

ProfileEdgesRead-only property

Instance of the McProfileEdges class for finding and managing “edges” on the sampled line profile.

ProfileValuesRead-only property

The sampled line intensity profiles from the ancestor McLines or McRegions features.

SampleModeRead-write property

A read-write property specifying whether lines are sampled at equal intervals or are broken into a given number of sections.

SamplesAsMcLinesRead-only property

A McLines holding lines with vertices that mark the sampled segments of the ancestor McLines or McRegions features.

VirtualWidthRead-write property

A read-write property specifying the width, in pixels, over which ProfileValues samples should be averaged.