LOADLENS

Loads a new lens file, replacing any lens file currently in memory.

Syntax:

LOADLENS filename, appendflag, session

Discussion:

LOADLENS will load a lens file. If the filename contains the complete path, such as C:\MYDIR\MYLENS.ZMX, then the specified file will be loaded. If the path is left off, then the default folder for lenses will be used (see " Folders ").

If the appendflag is zero or absent, then LOADLENS loads the file.

If the appendflag is greater than zero, then the file is appended to the current lens starting at the surface specified by the value of the appendflag. The object and image surfaces of the specified file will be ignored.

If the appendflag is less than zero, then the file is appended to the current lens starting at the surface specified by the absolute value of the appendflag, and the object surface of the specified file will be included. The image surface will be ignored.

The appendflag should only be used when appending one sequential system to another. Appending non-sequential systems isn't currently supported.

If the session flag is non-zero, any associated session file will be loaded with the lens and all windows will be updated otherwise the lens session file is ignored.

Example:

LOADLENS "COOKE.ZMX"
 

Related Keywords:

SAVELENS

Next:

• LOADMERIT (keywords)