• Why can't I open a .agi file?

Did you forget to add the file descriptions to the IFL_DATABASE? The two types in /usr/local/lib/Agile/ifl_database must be known as well as the types normally in /usr/lib/ifl/ifl_database.

• Why don't I see the diagram when I open a description file?

You probably are opening it by using the Image File selection from the Main Window's Operators menu. When you open a description file in this way, it is treated like a normal image. Use either the drop pocket or the File menu's Import selection to open it.

• Why is everything dreadfully slow?

Images tend to come with a page size of one scanline. That means to view even a small portion of the image requires reading each scanline. For a typical large TIFF file with about 7500 pixels per scan line, that means a window that is 768 pixels wide will have to process about 10 times more pixels than it needs to.

Using page sizes that are closer to square helps performance considerably. A page size of 256 to 1024 pixels on each side seems to be a much better choice.

Keep your window size small when dealing with time consuming operators, particularly those that greatly reduce the size of an image. Set your .Xdefaults resources for:

       ImageEditor*ilviewer.initMaxViewWidth: 768
       ImageEditor*ilviewer.initMaxViewHeight: 768

to something smaller if the initial open takes too long.

• Are the ways to tune things for better performance?

The primary control is the IL_CACHE_FRACTION (or IL_CACHE_SIZE) environment variables, which control the amount of available memory available to ImageVision. It normally defaults to 30%.