IMcWarpApplyToImage Method
|
|
This function warps the source image Aoi to a set of tiepoints in a
new destination image.
Namespace:
MediaCy.IQL.Operations
Assembly:
MediaCy.IQL.Operations (in MediaCy.IQL.Operations.dll) Version: 10.0.6912.0
SyntaxFunction ApplyToImage (
<OptionalAttribute> vSourceImg As Object,
Optional Flags As mcImageCreateFlags = mcImageCreateFlags.mcicfDefault
) As McImage
Parameters
- vSourceImg (Optional)
- Type: SystemObject
Optional source image, operator applies to parent image
when parameter is omitted. - Flags (Optional)
- Type: MediaCy.IQL.EnginemcImageCreateFlags
Optional image creation flags for the new image. By default the
value is zero, which creates a visible image that is part of the Images
collection. See mcImageCreateFlags for the list of supported flags.
Return Value
Type:
McImageA new McImage
RemarksThe transformation is defined by the current value of the Clip, Method
and Interpolation properties. It can handle rotation, translation, scaling, and
skewing. If Method contains wmAffine, it is a first-order linear
transformation, where a straight line in the source image will remain straight
in the transformed image.
The transformation is calculated by putting in correspondence at least four
points of the source image (specified in SourcePoints) with the corresponding
points in the desired image (specified in DestPoints). If more than four points
are supplied, the number supplied for DestPoints must equal the number supplied
for SourcePoints; in this instance, a least-square interpolation will be used.
The first tiepoint in DestPoints must correspond to the first tiepoint in
SourcePoints, and all subsequent points must progress in the same direction.
Note that points in SourcePoints do not necessarily point to pixels in the
image. Similarly, the points in DestPoints do not necessarily point to pixels in
the transformed image.
See Also