Description
Gets interpolated and optionally calibrated intensities at zero or more given coordiantes
-
Return Type
-
A Long value.
[out,retval]
-
Syntax
-
object.PixelIntensities (CoordinatesArray, IntensitiesArray, [CalibrateIntensities])
The PixelIntensities Method syntax has these parts: |
| object | An expression evaluating to an object of type McRegionAccess. | | CoordinatesArray | Required. A Variant value. An input array of zero or more X,Y coordinate pairs, each given relative to the Left,Top of this McRegionAccess instance. The X,Y pair may be supplied as a scalar LONGPOINT, SINGLEPOINT or DOUBLEPOINT. Or it may be supplied as an array of LONGPOINT, SINGLEPOINT or DOUBLEPOINT. Or it can just be a one or two dimensional array of pairs of numeric X,Y values. If a coordinate is supplied out of the McRegionAccess bounds, then zero is assumed as the luminance for that point.
| | IntensitiesArray | Required. A Variant value. An output array that is filled with Double intensity values, one for each CoordinatesArray X,Y pair supplied. Any existing Double array is not resized if it is large enough to hold the results.
| | CalibrateIntensities | Optional. A Boolean value. If given as False, then the returned intensity is not calibrated. If True (the default), then if the AccessedImage.IntensityCalibration is set (not Nothing), the interpolated luminance is calibrated using the McIntensityCalib.CalibrateValues method.
|
Remarks
This method allows you to get calibrated pixel intensity values 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.
The intensity computed for a coordinate that falls between pixel centers is based on linearly interpolated luminances from the 4 surrounding pixels.
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.
|
PixelIntensities Method
