Starts a VDA Tool used for importing data into PV‑WAVE.

vari — (optional) The names of variables into which data is read, up to 100.

Directory — A string containing the name of the directory to read data from.

Filename — A string containing the name of the file to read.

NoBlock — If specified, the event loop (WwLoop) that is started by the VDA Tool will use the given value. By default a value of 1 (non-blocking loop) will be used. However, it may be necessary in certain circumstances to force a non-blocking loop by specifying NoBlock = 2. (See WwLoop in the PV‑WAVE Application Developer’s Guide for more information.)

Parent — The widget ID of the parent widget.

Pattern — A string containing the filter pattern for files. For example, '*.dat' will cause files with a .dat extension to be listed in the import tool.

Position — Specifies, in pixels, the x and y (horizontal and vertical) coordinates for the starting location of the upper-left corner of the VDA Tool window.

Restore — A data structure previously saved in the Tools Manager with the TmSaveTools function. This keyword is reserved for internal use; it is not to be used at the command line (see Discussion).

Template — A string containing the name of a VDA Tool template file.

Type — A string containing the type of file to be read. Valid file types include the following. The names are not case sensitive. The smallest number of unique characters will be recognized. For example: Type='8 BIT'.

The Parent keyword is used to connect WzImport to another application, such as the Navigator.

The Restore keyword is used specifically by the TM_RESTORE method. For information on the TM_RESTORE method, refer to the source code for WzImport in:

Where <wavedir> is the main PV‑WAVE directory.

A template is a VDA Tool without any data associated with it. The template contains all of the modifications to VDA Tool default settings that were set when the template file was saved. Template files are saved with the Save Template As command from the File menu on the VDA Tool.

var1 = INTARR(100)

var2 = BYTARR(512, 512)

var3 = FLTARR(100, 100)

WzImport, var1, var2, var3

WzPreview, WzVariable