Click or drag to resize

IMcRegionAccessPixelIntensities Method

Gets interpolated and optionally calibrated intensities at zero or more given coordiantes

Namespace:  MediaCy.IQL.Engine
Assembly:  MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Function PixelIntensities ( 
	ByRef CoordinatesArray As Object,
	<OutAttribute> ByRef IntensitiesArray As Object,
	Optional CalibrateIntensities As Boolean = true
) As Integer

Parameters

CoordinatesArray
Type: SystemObject
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
Type: SystemObject
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)
Type: SystemBoolean
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.

Return Value

Type: Int32
The number of pixel intensities placed in the output IntensitiesArray.
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 an un-weighted cast to a monochrome image type (see mcRegionAccessMode.mcramUseWeightedMonoCast). If the ChannelToProcess property is 0 to Type.NumberOfChannels-1, then only the value of that channel is used.
See Also