BUILDRESOURCEFILENAME Function

Standard library routine that returns the full pathname for a specified resource file.

UNIX Users: The WAVE_RESPATH environment variable is a colon-separated list of directories, similar to the WAVE_PATH environment variable in PV-WAVE. If not found in a WAVE_RESPATH directory, the directory wavedir/xres/!Lang/vdatools is searched, where wavedir is the main PV-WAVE directory and !Lang represents the value of the !Lang system variable (!Lang default is 'american').

OpenVMS Users: The WAVE_RESPATH logical is a comma-separated list of directories and text libraries, similar to the WAVE_PATH logical in PV-WAVE. If not found in a WAVE_RESPATH directory, the directory wavedir:[XRES.!Lang.VDATOOLS] is searched, where wavedir is the main PV-WAVE directory and !Lang represents the value of the !Lang system variable (!Lang default is 'american').

Windows Users: The WAVE_RESPATH environment variable is a semicolon-separated list of directories, similar to the WAVE_PATH environment variable in PV-WAVE. If not found in a WAVE_RESPATH directory, the directory wavedir\xres\!Lang\vdatools is searched, where wavedir is the main PV-WAVE directory and !Lang represents the value of the !Lang system variable (!Lang default is 'american').

If Subdir alone is specified, the file is searched for in:

: (UNIX)wavedir/xres/subdir/vdatools

: (OpenVMS)wavedir:[XRES.SUBDIR.VDATOOLS]

: (Windows)wavedir\xres\subdir\vdatools

Where wavedir is the main PV-WAVE directory.

If only Appdir is specified, the application searches for resources in the following directory:

: (UNIX)wavedir/xres/!Lang/appdir

: (OpenVMS)wavedir:[XRES.!Lang.APPDIR]

: (Windows)wavedir\xres\!Lang\appdir

Where wavedir is the main PV-WAVE directory.

If both Subdir and Appdir are specified, the application searches for resources in the following directory:

: (UNIX)wavedir/xres/subdir/appdir

: (OpenVMS)wavedir:[XRES.SUBDIR.APPDIR]

: (Windows)wavedir\xres\subdir\appdir

Where wavedir is the main PV-WAVE directory.

If the file is not already in the resource database, the full pathname is returned.

Example

The following commands are taken from the code for a VDA Tool called WzMyVDA. The full pathname of the resource file for WzMyVDA is returned and is passed to the Resource keyword of WwInit.

...
resource_file = BUILDRESOURCEFILENAME('wzmyvda.ad')
top = WwInit('WzMyVDA', 'VDATools', layout, $

    'DestroyCB', Shell_name = 'WzMyVDA', $
    Layout_name = 'toolArea', $
    Title = unique_name, /Form, $
    ConfirmClose = 'ConfirmClose', $
    Resource = resource_file, $
    Userdata = unique_name)

...

BUILDRESOURCEFILENAME Function

Usage

Input Parameter

Returned Value

Keywords

Discussion

Example

See Also