Click or drag to resize

IMcRegionAccessLineSegmentIntensities Method

Gets optionally calibrated intensities for a segment of one line

Namespace:  MediaCy.IQL.Engine
Assembly:  MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Function LineSegmentIntensities ( 
	LineY As Integer,
	<OutAttribute> ByRef IntensitiesArray As Object,
	Optional lLeft As Integer = -1,
	Optional lRight As Integer = -1,
	Optional CalibrateIntensities As Boolean = true
) As Integer

Parameters

LineY
Type: SystemInt32
The line, relative to Top from which intensities are to be computed.
IntensitiesArray
Type: SystemObject
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.
lLeft (Optional)
Type: SystemInt32
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.
lRight (Optional)
Type: SystemInt32
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).
CalibrateIntensities (Optional)
Type: SystemBoolean
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.

Return Value

Type: Int32
The number of pixel intensities placed in the output IntensitiesArray.
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.
See Also