CImage:new

CImage:new

The new method constructs a new instance of a CImage object. You must call new before using any class methods or properties. 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 new_image.

Syntax

CImage = CImage:new()

Creates a new CImage.

CImage = CImage:new( CImage_old )

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

CImage = CImage:new( tbl )

tbl is a lua array (simple 1-dimensional lua table) -- see Tables and Arrays - Overview.

All methods return a new CImage object on success.

On failure, nil is returned.

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 = CImage:new()	-- create a new CImage object
A:Open( sPath )	-- load an image from a file
B = CImage:new( 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

The following script creates a 1-dimensional CImage object from a lua array initialized to 1 million Gaussian deviates (noise). Then the mean and standard deviation of the image are calculated and printed:

tbl = gaussdev(1000000)	-- create an array of 1 millian Gaussian deviates
I = CImage:new( tbl )	-- create a new CImage with a copy of A
m,s = meansdev( I )	-- calculate the mean and standard deviation
Printf("m=%lg, s=%lg\n", m, s)	-- print the results

Syntax

Example

Related Topics