Description

Create an image that duplicates the image data using the region access's area and casting.

Return Type

A Variant value.  

VARIANT* : variant returing McImage* interface pointer to new image

Syntax

object.CreateImage ([Flags])

The CreateImage Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McRegionAccess.
FlagsOptional. A mcImageCreateFlags enumeration, as described in settings.

long : Image creation flags

Settings

The settings for Flags are:

ConstantValueDescription
 mcicfDefault0
 mcicfContiguous1

If set, frames are allocated contiguously, and you cannot add to the FrameCount at a later time.

 mcicfNoInit2

Default is to initialize to 0 (black), this flag suppresses initialization.

 mcicfNoAddToCollection4

If set, the image is created, but not added to the collection (see Notes).

 mcicfNotVisible8

If set, the image is created, possibly added to collection (see above), but not made visible.

 mcipfNoImportProperties8388608

Suppress ImportProperties for functions creating an image from another.

Remarks

[TODO: Fill in longer description and remarks]