loadIm

laodIm ([ integer Input, string File ] )

Use this function to open an existing image file.

Parameters

Image

An optional integer between 1 and 116 specifying the number of the frame in which the image will open. Values in the range of 100-116 correspond to hidden frames. If this parameter is omitted, the Open Image dialog box will appear letting the user browse through the folder list and select the desired file.

File

An optional string specifying the path and name of the file from which the image will be loaded. If the path is not specified, the default directory will be used. The format of the image file is defined by a file extension. See the remarks below for a list of valid file extensions. If this parameter is omitted, the Open Image dialog box will appear allowing the user browse through the folder list and select the desired file.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

ERR_NOTFOUND

The flag set if the file was not found.

ERR_BADFORMAT

The flag set if the file format was not recognized

Example

loadIm()

Remarks

The following file extensions are supported:

"avi" Microsoft Video format "bmp", "dib" Windows bitmap format "fit" NASA Flexible Image Transport "gif" Graphic Interchange format "iwd" ImageWarp document "jpg" Joint Photographic Expert Group format "pcx" Zsoft PaintBrush format "tif" Tagged Image File format "tga" Truevision Targa format

For more information on the Open Image dialog and image file formats refer to ImageWarp User's Guide.