API Calls for Fortran Programmers: fagl Routines

Fortran programmers can use the following API calls (faglxxx routines) to incorporate the Array Viewer in their applications:

These routines are typically used in the following sequence:

• Before an array can be displayed or saved to a file, call faglStartWatch with the array as an argument.
  
  
• If you want the array to be displayed in Array Viewer with a starting array index other than 1, call faglLBound with the array as an argument and another array specifying the lower bound values.
  
  
• If you want the Array Viewer to display a descriptive name on its title bar, call faglName with the array and descriptive name as arguments.
  
  
• To start the Array Viewer, call faglShow with the array as an argument. The Viewer is displayed until the user closes the application, or the faglClose call is invoked.
  
  
• If later in your program the array data has changed, and you want the viewer to display the modified data, call faglUpdate with the array as an argument.
  
  
• If you want to save the array as an Array Graphing Language (.AGL) file, call faglSaveAsFile with the array as an argument. (You do not need to have the Viewer active to use this call.)
  
  
• When you are finished viewing the array, call faglEndWatch with the array as an argument.

You can use faglGetShareName to get a string identifier that identifies the shared memory region associated with an array.

You can also use the fav routines to perform tasks usually done interactively by the user.

The USE AVDEF statement includes the AVDEF module file that defines the routine interfaces (see the file ...ArrayVisualizer\INCLUDE\AVDEF.F90).

Samples of these routines are provided online in folders in ...\ArrayVisualizer\Samples\Fortran\. For a description of the Array Visualizer Samples, view the file ...\ArrayVisualizer\Samples\Samples.htm in a Web browser. Most Samples include a project workspace file, which allows you to open and build the project in the visual devlopment environment.

Samples are installed on the hard disk when a Complete installation is performed. You can copy Samples folders from the Array Visualizer CD-ROM to your hard disk (remove the read-only file property).