CImage:Display
The Display method displays the CImage in a new CImageView. The CImageView window is created by this method. There is a parallel method in the CImageView class.
CImageView = CImage:Display()
On success, this method returns a reference to the new CImageView.
On failure, this method returns nil.
This method creates a new CImageView window and displays in it a copy of the CImage. The image in the CImage object is not the same image as in the CImageView, although they initially have identical properties; rather the CImage and the displayed image point to two different objects in memory.
After this methods returns a reference to the new CImageView, CImageView class methods can be used to manipulate the displayed image.
The following script fragment displays a CImage in a CImageView window:
V = CImageView:new() |
-- not needed if using CImage:Display() |
I = CImage:new() |
-- create a new CImage |
I:Open(sPath) |
-- load the image from a file named sPath |
V = I:Display() |
-- displays the image and returns the new CImageView |