Description

Gets optionally calibrated intensities for a segment of one line

Return Type

A Long value.  

[out,retval]

Syntax

object.LineSegmentIntensities (LineY, IntensitiesArray, [lLeft], [lRight], [CalibrateIntensities])

The LineSegmentIntensities Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McRegionAccess.
LineYRequired. A Long value.

The line, relative to Top from which intensities are to be computed.

IntensitiesArrayRequired. A Variant value.

An output array that is filled with Double intensity values, one for each pixel in the specified line segment. Any existing Double array is not resized if it is large enough to hold the results.

lLeftOptional. A Long value.

If given, the left-most X pixel (relative to the Left property) to be accessed. If not given, then 0, the left-most pixel referenced by this McRegionAccess is the starting pixel.

lRightOptional. A Long value.

If given, the right-most X pixel (relative to the Left property) to be accessed. If not given, the right-most pixel referenced by this McRegionAccess is the ending pixel (this X coordinate is Right-Left).

CalibrateIntensitiesOptional. A Boolean value.

If given and False, then the returned intensity is not calibrated. If True (the default), then if the AccessedImage.IntensityCalibration is set (Not Nothing), the segment intensity values are calibrated using the McIntensityCalib.CalibrateValues method.

Remarks

This method allows you to get calibrated intensity values from a segment of a line as type Double without having to be concerned about the Type of the McRegionAccess or whether or not the AccessedImage has its IntensityCalibration property set.

If ChannelToProcess property is the default mcwcAllChannels, then a luminance is computed for the pixel before interpolation and intensity calibration. The luminance computed will be the same as the pixel value that would result from a cast to a monochrome image type. If the ChannelToProcess property is 0 to Type.NumberOfChannels-1, then only the value of that channel is used.