IMcRegionAccessPutLine Method
|
|
Writes an entire row of pixels into an image.
Namespace:
MediaCy.IQL.Engine
Assembly:
MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
SyntaxFunction PutLine (
vLine As Object,
y As Integer
) As Integer
Parameters
- vLine
- Type: SystemObject
VARIANT : A VARIANT containing a SAFEARRAY containing
the new pixel values. See GetLine for details. - y
- Type: SystemInt32
long : The 0-based line number. Line 0 is the top line of the
McRegionAccess.
Return Value
Type:
Int32
RemarksThe y coordinate is relative to the McRegionAccess ROI, not
the image. The pixel values returned are in the requested color model, which
may differ from the image's native color model. If different, the pixel values
will be converted back into the native color model and the image will be modified.
This function supports region masking (see RegionMask). When a
mask is set, PutLine will only set the values of pixels that lie
inside the mask. If the FastAccess flag is on however, masking may
not take place because the client will be directly access the image.
Hence clients should turn FastAccess off when using region masking.
See FastAccess for details.
This is the preferred method for writing to an image.
See Also