Description
Pastes a rectangular region of interest from an image to another.
-
Return Type
-
A McImage object.
The result McImage
-
Syntax
-
object.Paste (vSourceImg, [leftDest], [topDest], [leftSrc], [topSrc], [rightSrc], [bottomSrc], [vDestImg])
The Paste Method syntax has these parts: |
| object | An expression evaluating to an object of type McGeometry. | | vSourceImg | Required. A Variant value. Required source image or IMcRegionAccess instance. For a source image the VARIANT may hold the IMcImage instance, a string image name or numeric index for an Item in the Images collection. If given as an IMcRegionAccess instance, the source bounds arguments are ignored and the bounds of the supplied IMcRegionAccess are the source bounds.
| | leftDest | Optional. A Long value. X Optional coordinnate of destination ROI left upper corner. If negative or not given, the corresponding destination Aoi bound is used.
| | topDest | Optional. A Long value. Y coordinnate of destination ROI left upper corner. If negative or not given, the corresponding destination Aoi bound is used.
| | leftSrc | Optional. A Long value. Optional source ROI left upper corner x coordinnate If negative or not given, the corresponding SourceImg bound is used.
| | topSrc | Optional. A Long value. Optional source ROI left upper corner y coordinnate If negative or not given, the corresponding SourceImg bound is used.
| | rightSrc | Optional. A Long value. Optional source ROI left upper corner x coordinnate If negative or not given, the corresponding SourceImg bound is used.
| | bottomSrc | Optional. A Long value. Optional source ROI left upper corner x coordinnate If negative or not given, the corresponding SourceImg bound is used.
| | vDestImg | Optional. A Variant value. Optional destination image, operator applies to parent image when parameter is omitted.
| Remarks
When destination ROI coordinnates are negative or omitted, the entire source image is pasted onto destination image. The paste is masked by the destination image's Aoi.
Use the Blend method for a more general paste operation that can optionally mask by the source Aoi, and can also optionally replace the destination Aoi with the source image's Aoi.
|