FGLIMAGEPATH

Defines the search paths to find images for the front-end.

Usage

The FGLIMAGEPATH environment variable defines a list of directories to find images for the front-end.

When the front-end needs to display an image which is specified with a simple file name (not an URL), the front end first looks for local image files on the user workstation. If the image file is not found locally, the front-end sends an image request to the runtime system, which provides the image from the server file system.

You define the search path for images located on the application server with the FGLIMAGEPATH environment variable.

By default, the image directory is the current directory where the program was started.

FGLIMAGEPATH must contain a list of paths, separated by the operating system specific path separator. The path separator is ":" on UNIX™ platforms and ";" on Windows™ platforms.

The runtime system searches for image files in the locations described here. The search depends on the name of the image file, the list of directories defined in FGLIMAGEPATH, and the expected file extensions provided by the front-end:

The search for the image file would be as follows:

  1. dir1/file
  2. dir1/file.gif
  3. dir1/file.png
  4. dir2/file
  5. dir2/file.gif
  6. dir2/file.png

When FGLIMAGEPATH is defined, the current working directory is not searched. If you want to look for image files in the current working directory and in other directories, add "." to the FGLIMAGEPATH path list.

For security reasons, if FGLIMAGEPATH is defined, static image files must be located below one of the directories listed in this environment variable. For example, you cannot use an image file "/home/scott/myicons/smiley" when FGLIMAGEPATH contains "/home/myke:/app/icons". However, this security restriction does only apply to static images: When an filename is displayed by program to an image field with DISPLAY TO / BY NAME or a field used by a dialog with UNBUFFERED mode, the runtime system considers that the file can be transferred to the front-end without risk.

Image files for static images must be located in a directory of FGLIMAGEPATH.

FGLIMAGEPATH="/user/myimages:/user/myicones"
export FGLIMAGEPATH