new_image


The new_image function is a non-class version of the CImage:new method which creates and returns a new CImage object. After creating a new image, you must use the Create, Open, or Copy method from the CImage class or attach it from the CImageView class. Note that the object can also be created using the CImage:new method.

Syntax

CImage = new_image()

bullet.gif    Creates a new CImage.

CImage = new_image( CImage_old )

bullet.gif    This is a copy constructor. It creates a new CImage initialized to the properties of CImage_old.

Example

The following script creates a CImage object and loads an image into it. Then it creates a new CImage that is a duplicate of the first one. This makes 2 images loaded into memory:

A = new_image()

-- create a new CImage object

A:Open( sPath )

-- load an image from a file

B = new_image( A )

-- create a new CImage with a copy of A

Printf("A name: %s\n", A:Path(60))

-- print the name of image A

Printf("B name: %s\n", B:Path(60))

-- print the name of image B. Same as A

A:delete()

-- delete when done

B:delete()

-- delete when done

Related Topics

CImage class, Copy, Ceate, new, delete, Math Operators


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.