- The CiImage object stores image data in
computer memory.
If image data memory is allocated the CiImage object is an opened image, whose IsValid property evaluates to true.
Otherwise, the CiImage object is considered a closed image. - The CreateImage method creates a CiImage object without allocating memory, resulting in a closed image.
- The Open, OpenFromClipboard, OpenFromBitmap, Create, CreateBpp, and Copy methods allocate and initialize the memory of an existing CiImage object, resulting in an opened image.
- The Duplicate, ExtractObject methods create a CiImage object and allocate memory for it, resulting in an opened image.
- The Close method frees the memory of a CiImage object, resulting in a closed image.
- Computer performance may degrade significantly if too many images are opened at any point in time, due to excessive memory consumption. ClearImage limits the number of simultaneously open images to 256.
NOTE: The application should minimize the number of opened images. Unused images should be closed (Close method) or the CiImage objects should be deleted.