Description
Create a clone of the Aoi of this image.
-
Return Type
-
A McImage object.
A new McImage.
-
Syntax
-
object.Duplicate ([ImageCreationFlags])
The Duplicate Method syntax has these parts: |
| object | An expression evaluating to an object of type McImage. | | ImageCreationFlags | Optional. A mcImageCreateFlags enumeration, as described in settings. Flags to pass to the McImages.Add method. See mcImageCreateFlags for the list of supported flags. Any mcImportPropertiesFlags, OR'ed in are ignored; all properties are always copied (unless the import filter is changed by a BeforeImportProperties event handler).
|
Settings The settings for ImageCreationFlags are:
|
 | mcicfDefault | 0 | |
| mcicfContiguous | 1 |
If set, frames are allocated contiguously, and you cannot add to the FrameCount at a later time.
|
| mcicfNoInit | 2 |
Default is to initialize to 0 (black), this flag suppresses initialization.
|
| mcicfNoAddToCollection | 4 |
If set, the image is created, but not added to the collection (see Notes).
|
| mcicfNotVisible | 8 |
If set, the image is created, possibly added to collection (see above), but not made visible.
|
| mcipfNoImportProperties | 8388608 |
Suppress ImportProperties for functions creating an image from another.
|
Remarks
The CopyToNewImage method is a more generalized version of this method that allows you to specify a source rectangle other than the Aoi and also to supply a name for the new image.
If UseActiveFrameRange is True, then any ActiveFrameRange is honored to decide which frames should be copied. At least one frame must be selected for copying.
|
Duplicate Method (McImage)
