Functional Summary of Routines

This chapter lists the following groups of related routines:

Array Creation Routines

Array Manipulation Routines

Coordinate Conversion Routines

General Graphics Routines

Gridding Routines

Mapping Routines

Plotting Routines

View Setup Routines

Window Routines

VDA Tools Routines

BUILDRESOURCEFILENAME Function

Concurrent Processing Routines

LOADRESOURCES Procedure

LOADSTRINGS Procedure

WAVE Widget Utilities (Wg)

---

NOTE: For more detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

VDA Tools Manager Routines (Tm)

VDA Tools Manager Graphical Element Routines (Tm)

VDA Utilities Routines (Wo)

WAVE Widgets Routines (Ww)

Widget Toolbox Routines (Wt)

Color Table Manipulation Routines

Image Display Routines

Image IO Routines

Image Processing Routines

Data Connection Routines

HDF Routines

Input and Output Routines

Hypertext Markup Language (HTML) Routines

OPENURL Procedure

Virtual Reality Modeling Language (VRML) Routines

General Mathematical Functions

Special Mathematical Functions

Transcendental Mathematical Functions

Data Conversion Routines

Data Extraction Routines

Date/Time Functions

File Manipulation Routines

Help and Information Routines

Operating System Access Routines

Programming Routines

Session Routines

String Processing Routines

Table Manipulation Functions

Polygon Generation Routines

Polygon Manipulation Routines

Polygon Rendering Routines

Ray Tracing Routines

Volume Manipulation Routines

Volume Rendering Routines

ASARR(key₁, value₁, ... key_n , value_n)

ASARR(keys_arr, values_list)

Creates an associative array containing specified variables and expressions.

BINDGEN (dim₁ [, dim₂, ... , dim_n] )

Returns a byte array with the specified dimensions, setting the contents of the result to increasing numbers starting at 0.

BYTARR (dim₁ [, dim₂, ... , dim_n] )

Returns a byte vector or array.

CINDGEN (dim₁ [, dim₂ , ... , dim_n] )

Returns a complex single-precision floating-point array.

COMPLEXARR (dim₁ [, dim₂, ... , dim_n] )

Returns a complex single-precision floating-point vector or array.

DBLARR (dim₁, ... , dim_n)

Returns a double-precision floating-point vector or array.

DCINDGEN(dim1 [, dim2 , ... , dimn])

Returns a double-precision floating-point complex array.

DCOMPLEXARR (dim₁ [, dim₂, ... , dim_n] )

Returns a double-precision floating-point complex vector or array.

DIAG( a )

Makes a diagonal array or extracts the diagonal of an array.

DINDGEN (dim₁, ..., dim_n)

Returns a double-precision floating-point array with the specified dimensions.

FINDGEN (dim₁, ..., dim_n)

Returns a single-precision floating-point array with the specified dimensions.

FLTARR (dim₁, ..., dim_n)

Returns a single-precision floating-point vector or array.

INDGEN (dim₁, ... , dim_n)

Returns an integer array with the specified dimensions.

INTARR (dim₁, ... , dim_n)

Returns an integer vector or array.

LINDGEN (dim₁, ... , dim_n)

Returns a longword integer array with the specified dimensions.

LIST(expr₁ , ... expr_n)

Creates a list array.

LONARR (dim₁, ... , dim_n)

Returns a longword integer vector or array.

MAKE_ARRAY ([dim₁,... , dim_n] )

Returns an array of specified type, dimensions, and initialization. It provides the ability to create an array dynamically whose characteristics are not known until run time.

REPLICATE (value, dim₁, ..., dim_n)

Forms an array with the given dimensions, filled with the specified scalar value.

SINDGEN (dim₁, ... , dim_n)

Returns a string array with the specified dimensions.

STRARR (dim₁, ... , dim_n)

Returns a string array.

ASKEYS(asarr)

Obtains the key names for a given associative array.

AVG (array [, dim] )

Standard Library function that returns the average value of an array. Optionally, it can return the average value of one dimension of an array.

BILINEAR (array, x, y)

Standard Library function that creates an array containing values calculated using a bilinear interpolation to solve for requested points interior to an input grid specified by the input array.

CORRELATE (x, y)

Standard Library function that calculates a simple correlation coefficient for two arrays.

DETERM (array)

Standard Library function that calculates the determinant of a square, two-dimensional input variable.

HISTOGRAM (array)

Returns the density function of an array.

INDEX_CONV( a, i )

Converts one-dimensional indices to n-dimensional indices, or n-dimensional indices to 1D indices.

ISASKEY(asarr, key)

Matches a key name in a given associative array.

MAX (array [, max_subscript] )

Returns the value of the largest element in an input array.

MEDIAN (array [, width] )

Finds the median value of an array, or applies a one- or two- dimensional median filter of a specified width to an array.

MIN (array [, min_subscript] )

Returns the value of the smallest element in array.

PADIT( a, [b] )

Pads an array with variable thickness.

REBIN (array, dim₁, ..., dim_n)

Returns a vector or array resized to the given dimensions.

REFORM (array, dim₁, ... , dim_n)

Reformats an array without changing its values numerically.

REVERSE (array, dimension)

Standard Library function that reverses a vector or array for a given dimension.

ROTATE (array, direction)

Returns a rotated and/or transposed copy of the input array.

SHIFT (array, shift₁, ... , shift_n)

Shifts the elements of a vector or array along any dimension by any number of elements.

SIGMA (array [, npar, dim] )

Standard Library function that calculates the standard deviation value of an array.

SMOOTH (array, width)

Smooths an array with a boxcar average of a specified width.

SORT (array)

Sorts the contents of an array.

STDEV (array [, mean] )

Standard Library function that computes the standard deviation and (optionally) the mean of the input array.

TENSOR_* Functions

Compute the generalized tensor product of two arrays.

TOTAL (array)

Sums the elements of an input array.

TRANSPOSE (array)

Transposes the input array.

UNIQN( a )

Finds the unique n-tuples from a set of n-tuples.

WHERE (array_expr [, count ] )

Returns a longword vector containing the one-dimensional subscripts of the nonzero elements of the input array.

WHEREIN( a, b [,c] )

Find the indices into an array where the values occur in a second array; keywords yield intersection, union, and complement.

C_EDIT [, colors_out]

Standard Library procedure that lets you interactively create a new color table based on the HLS or HSV color system.

COLOR_EDIT [, colors_out]

Standard Library procedure that lets you interactively create color tables based on the HLS or HSV color system.

COLOR_PALETTE

Standard Library procedure that displays the current color table colors and their associated color table indices.

HLS, ltlo, lthi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that generates and loads color tables into an image display device based on the HLS color system. The resulting color table is loaded into the display system.

HSV, vlo, vhi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that generates and loads color tables into an image display device based on the HSV color system. The final color table is loaded into the display device.

LOADCT [, table_number]

Standard Library procedure that loads a predefined color table.

MODIFYCT, table, name, red, green, blue

Standard Library procedure that lets you replace one of the PV-WAVE color tables (defined in the colors.tbl file) with a new color table.

PALETTE [, colors_out]

Standard Library procedure that lets you interactively create a new color table based on the RGB color system.

PSEUDO, ltlo, lthi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that creates a pseudo color table based on the Hue, Lightness, Saturation (HLS) color system.

STRETCH, low, high

Standard Library procedure that linearly expands the range of the color table currently loaded to cover an arbitrary range of pixel values.

TVLCT, v1, v2, v3 [, start]

Loads the display color translation tables from the specified variables.

WgCbarTool [, parent [, shell [, windowid [, movedCallback], [, range]]]]

Creates a simple color bar that can be used to view and interactively shift a color table.

WgCeditTool [, parent [, shell ]]

Creates a full-featured set of menus and widgets enclosed in a window; this window allows you to edit the values in PV-WAVE color tables in many different ways.

WgCtTool [, parent [, shell ]]

Creates a simple widget that can be used interactively to modify a PV-WAVE color table.

ADD_EXEC_ON_SELECT, lun, command

Adds a single new item to the EXEC_ON_SELECT list.

DROP_EXEC_ON_SELECT, lun

Drops a single item from the EXEC_ON_SELECT list.

EXEC_ON_SELECT, luns, commands

Registers callback procedures on input for a vector of logical unit numbers (LUNs).

SELECT_READ_LUN, luns

Waits for input on any list of logical unit numbers.

Coordinate Conversion Routines

CONVERT_COORD (points) OR (x [, y, z])

Converts coordinates from one coordinate system to another.

CONV_FROM_RECT (vec1, vec2, vec3)

Converts rectangular coordinates (points) to polar, cylindrical, or spherical coordinates.

CONV_TO_RECT (vec1, vec2, vec3)

Converts polar, cylindrical, or spherical coordinates to rectangular coordinates (points).

POLY_DEV (points, winx, winy)

Returns a list of 3D points converted from normal coordinates to device coordinates.

POLY_NORM (points)

Returns a list of 3D points converted from data coordinates to normal coordinates.

POLY_TRANS (points, trans)

Returns a list of 3D points transformed by a 4-by-4 transformation matrix.

DC_ERROR_MSG (status)

Returns the text string associated with the negative status code generated by a "DC" data import/export function that does not complete successfully.

DC_OPTIONS (msg_level)

Sets the error message reporting level for all "DC" import/export functions.

DC_READ_8_BIT (filename, imgarr)

Reads an 8-bit image file.

DC_READ_24_BIT (filename, imgarr)

Reads a 24-bit image file.

DC_READ_CONTAINER (filename, var_name)

Reads a single variable from an HP VEE Container file.

DC_READ_DIB(filename, imgarr)

Reads data from a Device Independent Bitmap (DIB) format file into a variable.

DC_READ_FIXED (filename, var_list)

Reads fixed-formatted ASCII data using a PV-WAVE format that you specify.

DC_READ_FREE (filename, var_list)

Reads freely-formatted ASCII files.

DC_READ_TIFF (filename, imgarr)

Reads a Tag Image File Format (TIFF) file.

DC_SCAN_CONTAINER (filename, num_variables, start_records, end_records)

Scans an HP VEE Container file to determine the number and location of defined variables.

DC_WRITE_8_BIT (filename, imgarr)

Writes 8-bit image data to a file.

DC_WRITE_24_BIT (filename, imgarr)

Writes 24-bit image data to a file.

DC_WRITE_DIB(filename, imgarr)

Writes image data from a variable to a Device Independent Bitmap (DIB) format file.

DC_WRITE_FIXED (filename, var_list, format)

Writes the contents of one or more PV-WAVE variables (in ASCII fixed format) to a file using a format that you specify.

DC_WRITE_FREE (filename, var_list)

Writes the contents of one or more PV-WAVE variables to a file in ASCII free format.

DC_WRITE_TIFF (filename, imgarr)

Writes image data to a file using the Tag Image File Format (TIFF) format.

BYTE (expr)

Converts an expression to byte data type.

BYTSCL (array)

Scales and converts an array to byte data type.

COMPLEX (real [, imaginary] )

Converts an expression to complex data type.

DCOMPLEX (expr, offset, dim1 [, dim2, ... , dimn ] )

Converts an expression to double-precision complex data type.

DOUBLE (expr)

Converts an expression to double-precision floating-point data type.

FIX (expr)

Converts an expression to integer data type.

FLOAT (expr)

Converts an expression to single-precision floating-point data type.

LONG (expr)

Converts an expression to longword integer data type.

NINT (x)

Converts input to the nearest integer.

STRING (expr₁, ... , expr_n)

Converts the input parameters to characters and returns a string expression.

BYTE (expr, offset [, dim1, ... , dimn] )

Extracts data from an expression and places it in a byte scalar or array.

COMPLEX (expr, offset, dim1 [, dim2, ... , dimn ] )

Extracts data from an expression and places it in a complex scalar or array.

DCOMPLEX (expr, offset, dim1 [, dim2, ... , dimn ] )

Extracts data from an expression and places it in a complex scalar or array.

DOUBLE (expr, offset, dim1 [, ..., dimn ] )

Extracts data from an expression and places it in a double- precision floating-point scalar or array.

FIX (expr, offset, dim1 [, ..., dimn ] )

Extracts data from an expression and places it in a integer scalar or array.

FLOAT (expr, offset, dim1 [, ..., dimn ] )

Extracts data from an expression and places it in a single- precision floating-point scalar or array.

LONG (expr, offset, dim1 [, ... , dimn ] )

Extracts data from an expression and places it in a longword integer scalar or array.

CREATE_HOLIDAYS, dt_list

Creates the system variable !Holiday_List.

CREATE_WEEKENDS, day_names

Creates the system variable !Weekend_List.

DAY_NAME (dt_var)

Returns a string array containing the name of the day of the week for each day in a Date/Time variable.

DAY_OF_WEEK (dt_var)

Returns an array of integers containing the day of the week for each date in a Date/Time variable.

DAY_OF_YEAR (dt_var)

Returns an array of integers containing the day of the year for each date in a Date/Time variable.

DT_ADD (dt_value)

Increment the values in a Date/Time variable by a specified amount.

DT_COMPRESS (dt_array)

Removes holidays and weekends from the Julian day portion of Date/Time variables.

DT_DURATION (dt_value_1, dt_value_2)

Determines the elapsed time between two Date/Time variables.

DT_PRINT, dt_var

Prints the values of PV-WAVE Date/Time variables in a readable manner.

DT_SUBTRACT (dt_value)

Decrements the values in a Date/Time variable by a specified amount.

DT_TO_SEC (dt_value)

Converts PV-WAVE Date/Time variables to double-precision variables containing the number of seconds elapsed from a base date.

DT_TO_STR, dt_var, [, dates] [, times]

Converts PV-WAVE Date/Time variables into string data.

DT_TO_VAR, dt_value

Converts a PV-WAVE Date/Time variable to regular numerical data.

DTGEN (dt_start, dimension)

Returns an array of PV-WAVE Date/Time variables beginning from a specified date and incremented by a specified amount.

JUL_TO_DT (julian_day)

Converts a Julian day number to a PV-WAVE Date/Time variable.

LOAD_HOLIDAYS

Passes the value of the !Holiday_List system variable to the Date/Time routines.

LOAD_WEEKENDS

Passes the value of the !Weekend_List system variable to the Date/Time routines.

MONTH_NAME (dt_var)

Returns a string or array of strings containing the names of the months contained in a Date/Time variable.

SEC_TO_DT (num_of_seconds)

Converts any number of seconds into PV-WAVE Date/Time variables.

STR_TO_DT (date_strings [, time_strings] )

Converts date and time string data to PV-WAVE Date/Time variables.

TODAY ()

Returns a Date/Time variable containing the current system date and time.

VAR_TO_DT (yyyy, mm, dd, hh, mn, ss)

Converts scalars or arrays of scalars representing dates and times into PV-WAVE Date/Time variables.

CLOSE [, unit₁, ... , unit_n]

Closes the specified file units.

EOF (unit)

Tests the specified file unit for the end-of-file condition.

FINDFILE (file_specification)

Returns a string array containing the names of all files matching a specified file description.

FLUSH, unit₁, ..., unit_n

Causes all buffered output on the specified file units to be written.

FREE_LUN, unit₁, ..., unit_n

Deallocates file units previously allocated with GET_LUN.

FSTAT (unit)

Returns an expression containing status information about a specified file unit.

GET_LUN, unit

Allocates a file unit from a pool of free units.

OPENR, unit, filename [, record_length]

OPENR (OPEN Read) opens an existing file for input only.

OPENU, unit, filename [, record_length]

OPENU (OPEN Update) opens an existing file for input and output.

OPENURL, url

Opens a file on the internet to be accessed using PV-WAVE. 1

OPENW, unit, filename [, record_length]

OPENW (OPEN Write) opens a new file for input and output.

POINT_LUN, unit, position

Allows the current position of the specified file to be set to any arbitrary point in the file.

CURSOR, x, y [, wait]

Reads the position of the interactive graphics cursor from the current graphics device.

DEVICE

Provides device-dependent control over the

current graphics device (as specified by the SET_PLOT procedure).

EMPTY

Causes all buffered output for the current graphics device to be written.

ERASE [, background_color]

Erases the display surface of the currently active window.

IMAGE_CONT, array

Standard Library procedure that overlays a contour plot onto an image display of the same array.

MOVIE, images [, rate]

Standard Library procedure that shows a cyclic sequence of images stored in a three-dimensional array.

PLOTS, x [, y [, z]]

Plots vectors or points on the current graphics device in either two or three dimensions.

PROFILE (image)

Standard Library function that extracts a profile from an image.

PROFILES, image

Standard Library procedure that lets you interactively draw row or column profiles of the image displayed in the current window. The profiles are displayed in a new window, which is deleted when you exit the procedure.

RDPIX, image [, x0, y0]

Standard Library procedure that displays the X, Y, and pixel values at the location of the cursor in the image displayed in the currently active window.

SCALE3D

Standard Library procedure that scales a three-dimensional unit cube into the viewing area.

SET_PLOT, device

Specifies the device type used by PV-WAVE graphics procedures.

SHOW3, array

Standard Library procedure that displays a two-dimensional array as a combination contour, surface, and image plot. The resulting display shows a surface with an image underneath and a contour overhead.

T3D

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformations and stores the result in the system variable !P.T.

THREED, array [, space]

Standard Library procedure that plots a two-dimensional array as a pseudo three-dimensional plot on the currently selected graphics device.

TVCRS [, on_off]

Manipulates the cursor within a displayed image, allowing it to be enabled and disabled, as well as positioned.

XYOUTS, x, y, string

Draws text on the currently selected graphics device starting at the designated data coordinate.

ZOOM

Expands and displays part of an image (or graphic plot) from the current window in a second window.

General Mathematical Functions

ABS (x)

Returns the absolute value of x.

AVG (array [, dim] )

Standard Library function that returns the average value of an array. Optionally, it can return the average value of one dimension of an array.

BILINEAR (array, x, y)

Standard Library function that creates an array containing values calculated using a bilinear interpolation to solve for requested points interior to an input grid specified by the input array.

CHECK_MATH ( [print_flag, message_inhibit] )

Returns and clears the accumulated math error status.

CONJ (x)

Returns the complex conjugate of the input variable.

CONVOL (array, kernel [, scale_factor] )

Convolves an array with a kernel (or another array).

CORRELATE (x, y)

Standard Library function that calculates a simple correlation coefficient for two arrays.

CROSSP (v₁, v₂)

Standard Library function that returns the cross product of two three-element vectors.

CURVEFIT (x, y, wt, parms, [sigma] )

Standard Library function that performs a nonlinear least-squares fit to a function of an arbitrary number of parameters.

DERIV ( [x,] y)

Standard Library function that calculates the first derivative of a function in x and y.

DETERM (array)

Standard Library function that calculates the determinant of a square, two-dimensional input variable.

FFT (array, direction)

Returns the Fast Fourier Transform for the input variable.

FINITE (x)

Returns a value indicating if the input variable is finite or not.

GAUSSFIT (x, y [, coefficients] )

Standard Library function that fits a Gaussian curve through a data set.

HILBERT (x [, d] )

Standard Library function that constructs a Hilbert transformation matrix.

IMAGINARY (complex_expr)

Returns the imaginary part of a complex number.

INVERT (array [, status] )

Returns an inverted copy of a square array.

ISHFT (p₁, p₂)

Performs the bit shift operation on bytes, integers, and longwords.

LUBKSB, a, index, b

Solves the set of n linear equations Ax =b. (LUBKSB must be used with the procedure LUDCMP to do this.)

LUDCMP, a, index, d

Replaces an n-by-n matrix, a, with the LU decomposition of a row-wise permutation of itself.

MPROVE, a, alud, index, b, x

Iteratively improves the solution vector, x, of a linear set of equations, Ax =b. (You must call the LUDCMP procedure before calling MPROVE.)

POLY (x, coefficients)

Standard Library function that evaluates a polynomial function of a variable.

POLY_AREA (x, y)

Standard Library function that returns the area of an n-sided polygon, given the vertices of the polygon.

POLY_FIT (x, y, deg [, yft, ybd, sig, mat] )

Standard Library function that fits an n-degree polynomial curve through a set of data points using the least-squares method.

POLYFITW (x, y, wt, deg [, yft, ybd, sig, mat] )

Standard Library function that fits an n-degree polynomial curve through a set of data points using the least-squares method.

RANDOMN (seed [, dim₁, ... , dim_n] )

Returns one or more normally distributed floating-point pseudo-random numbers with a mean of zero and a standard deviation of 1.

RANDOMU (seed [, dim₁, ... , dim_n] )

Returns one or more uniformly distributed floating-point pseudo-random numbers over the range 0 Y 1.0.

REGRESS (x, y, wt [, yf, a0, sig, ft, r, rm, c] )

Standard Library function that fits a curve to data using the multiple linear regression method.

SIGMA (array [, npar, dim] )

Standard Library function that calculates the standard deviation value of an array. (Optionally, it can also calculate the standard deviation over one dimension of an array as a function of the other dimensions.)

SOBEL (image)

Performs a Sobel edge enhancement of an image.

SPLINE (x, y, t [, tension] )

Standard Library function that performs a cubic spline interpolation.

STDEV (array [, mean] )

Standard Library function that computes the standard deviation and (optionally) the mean of the input array.

SUM (array, dim)

Sums an array of n dimensions over one of its dimensions.

SURFACE_FIT (array, degree)

Standard Library function that determines the polynomial fit to a surface.

SVBKSB, u, w, v, b, x

Uses "back substitution" to solve the set of simultaneous linear equations Ax = b, given the u, w, and v arrays created by the SVD procedure from the matrix a.

SVD, a, W [, u [, v]]

Performs a singular value decomposition on a matrix.

SVDFIT (x, y, m)

Standard Library function that uses the singular value decomposition method of least-squares curve fitting to fit a polynomial function to data.

TOTAL (array)

Sums the elements of an input array.

TQLI, d, e, z

Uses the QL algorithm with implicit shifts to determine the eigenvalues and eigenvectors of a real, symmetric, tridiagonal matrix.

TRED2, a [, d [, e]]

Reduces a real, symmetric matrix to tridiagonal form, using Householder's method.

TRIDAG, a, b, c, r, u

Solves tridiagonal systems of linear equations.

ZROOTS, a, roots [, polish]

Finds the roots of the m-degree complex polynomial, using Laguerre's method.

Gridding Routines

FAST_GRID2 (points, grid_x)

Returns a gridded, 1D array containing Y values, given random X,Y coordinates (this function works best with dense data points).

FAST_GRID3 (points, grid_x, grid_y)

Returns a gridded, 2D array containing Z values, given random X, Y, Z coordinates (this function works best with dense data points).

FAST_GRID4 (points, grid_x, grid_y, grid_z)

Returns a gridded, 3D array containing intensity values, given random 4D coordinates (this function works best with dense data points).

GRID_2D (points, grid_x)

Returns a gridded, 1D array containing Y values, given random X,Y coordinates (this function works best with sparse data points).

GRID_3D (points, grid_x, grid_y)

Returns a gridded, 2D array containing Z values, given random X, Y, Z coordinates (this function works best with sparse data points).

GRID_4D (points, grid_x, grid_y, grid_z)

Returns a gridded, 3D array containing intensity values, given random 4D coordinates (this function works best with sparse data points).

GRID_SPHERE (points, grid_x, grid_y)

Returns a gridded, 2D array containing radii, given random longitude, latitude, and radius values.

GETNCERR ( [errstr,] )

Retrieves the current value of the "ncerr" variable as discussed in the error section of the NetCDF User's Guide.

GETNCOPTS ( )

Retrieves the current value of the ncopts variable as discussed in the error section of the NetCDF User's Guide.

HDFGET24 (filename, image)

Obtains an HDF Raster 24 image.

HDFGETANN (filename, tag, ref)

Obtains HDF object (e.g., an SDS, Raster 8 image, etc.) annotations, either a label or a description.

HDFGETFILEANN (filename)

Obtains an HDF file annotation, either label or description.

HDFGETNT (type)

Obtains the HDF number type (i.e., data type) and descriptive number type string for the current HDF Scientific Data Set.

HDFGETR8 (filename, image, palette)

Obtains an HDF Raster 8 image and associated palette.

HDFGETRANGE (maxvalue, minvalue)

Gets the maximum and minimum range for the current HDF Scientific Data Set.

HDFGETSDS (filename, data)

Gets an HDF Scientific Data Set.

HDFLCT, palette

Loads an HDF palette as a PV-WAVE color table.

HDFPUT24 (filename, image)

Puts an HDF Raster 24 image into an HDF file.

HDFPUTFILEANN (filename)

Inserts HDF file labels and file descriptions (annotations) into a file.

HDFPUTR8 (filename, image)

Writes an 8 bit image to an HDF file.

HDFPUTSDS (filename, data)

Writes a Scientific Data Set to an HDF file.

HDFSCAN, filename

Scans an HDF file and prints a simple list of file contents by HDF object type.

HDFSETNT (data)

Computes and sets the HDF number type (i.e., data type) and descriptive number type string for the specified data array.

HDF_STARTUP

A batch file used to initialize the HDF interface. See PV-WAVE Reference Appendix A, "The PV-WAVE HDF Interface" for more information.

HDF_TEST

Runs the PV-WAVE HDF test suite.

SETNCOPTS, new_ncopts

Sets the value of the ncopts variable and defines the level of error reporting for the netCDF functions as discussed in the error section of the NetCDF User's Guide.

DOC_LIBRARY [, name]

Standard Library procedure that extracts header documentation for user-written PV-WAVE procedures and functions.

HELP

Starts the online help system.

INFO, expr₁, ... , expr_n

Displays information on many aspects of the current PV-WAVE session.

Hypertext Markup Language (HTML) Routines

HTML_BLOCK, text

Writes out a specifically formatted "block" of HTML text.

HTML_CLOSE

Closes an HTML file, after end-tagging major elements.

HTML_HEADING, text

Creates a heading, with a level specification.

HTML_HIGHLIGHT([str₁, str₂, ... , str_n], [tag₁, tag₂, ... , tag_n])

Allows for all the basic textual highlighting elements in HTML.

HTML_IMAGE(url)

Returns a string or an array of strings containing a reference or references to image URL(s)

HTML_LINK(url, text)

Sets up links to Uniform Resource Locations (URLs).

HTML_LIST, [list_item_{1, ...,} list_item_n]

Generates HTML code for all types of lists.

HTML_OPEN

Opens the output HTML file, writes out the basic HTML information and sets an HTML output file information variable, hinfo.

HTML_PARAGRAPH, text

Defines an HTML paragraph.

HTML_RULE

Inserts a horizontal-line separator.

HTML_SAFE(str)

Escapes special characters so that the HTML displays them as intended, rather than using them for format tagging. The escapes codes are for: , , &, and ".

HTML_TABLE, table_text

Writes out an HTML table.

C_EDIT [, colors_out]

Standard Library procedure that lets you interactively create a new color table based on the HLS or HSV color system.

COLOR_CONVERT, i₀, i₁, i₂, o₀, o₁, o₂, keyword

Converts colors to and from the RGB color system and either the HLS or HSV systems.

COLOR_EDIT [, colors_out]

Standard Library procedure that lets you interactively create color tables based on the HLS or HSV color system.

COLOR_PALETTE

Standard Library procedure that displays the current color table colors and their associated color table indices.

HIST_EQUAL_CT [, image]

Standard Library procedure that uses an input image parameter, or the region of the display you mark, to obtain a pixel distribution histogram. The cumulative integral is taken and scaled, and the result is applied to the current color table.

HLS, ltlo, lthi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that generates and loads color tables into an image display device based on the HLS color system. The resulting color table is loaded into the display system.

HSV, vlo, vhi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that generates and loads color tables into an image display device based on the HSV color system. The final color table is loaded into the display device.

LOADCT [, table_number]

Standard Library procedure that loads a predefined PV-WAVE color table.

LOADCT_CUSTOM [, table_number]

Loads a predefined custom color table.

MODIFYCT, table, name, red, green, blue

Standard Library procedure that lets you replace one of the PV-WAVE color tables (defined in the colors.tbl file) with a new color table.

PALETTE [, colors_out]

Standard Library procedure that lets you interactively create a new color table based on the RGB color system.

PSEUDO, ltlo, lthi, stlo, sthi, hue, lp [, rgb]

Standard Library procedure that creates a pseudo color table based on the Hue, Lightness, Saturation (HLS) color system.

STRETCH, low, high

Standard Library procedure that linearly expands the range of the color table currently loaded to cover an arbitrary range of pixel values.

TV, image [, position]

Displays images without scaling the intensity.

TVCRS [, on_off]

Manipulates the cursor within a displayed image, allowing it to be enabled and disabled, as well as positioned.

TVLCT, v₁, v₂, v₃ [, start]

Loads the display color translation tables from the specified variables.

TVRD (x₀, y₀, n_x, n_y [, channel ])

Returns the contents of the specified rectangular portion of a displayed image.

TVSCL, image [, x, y [, channel ]]

TVSCL, image [, position]

Scales the intensity values of an input image into the range of the image display, usually from 0 to 255, and outputs the data to the image display at the specified location.

TVSIZE, image [, x, y [, channel ]]

TVSIZE, image [, position]

D isplays images at the current or specified size and device resolution.

IMAGE_CHECK(image)

Determines that the input variable is an associative array in image format. The function also checks to make sure that all fields in the image associative array are present. 6

IMAGE_COLOR_QUANT( image [, n_colors] )

Quantizes a 24-bit image to 8-bit pseudo color.

IMAGE_CREATE(pixel_array)

Creates an associative array in image format. See the Discussion section for detailed information on the image format.

IMAGE_DISPLAY, image

Displays an image.

IMAGE_QUERY_FILE, filename

Return the type of a specified image file.

IMAGE_READ(filename)

Reads image files and returns an associative array in image format.

IMAGE_WRITE(filename, image)

Writes PV-WAVE graphics to a specified file type.

READ_XBM, file, image

Reads the contents of an X-bitmap (XBM) file into a PV-WAVE variable.

WRITE_XBM, file, image

Writes an image to an X-bitmap (XBM) file.

CONGRID (image, col, row)

Standard Library function that shrinks or expands an image or array.

CONVOL (array, kernel [, scale_factor] )

Convolves an array with a kernel (or another array).

DEFROI (sizex, sizey [, xverts, yverts] )

Standard Library function that defines an irregular region of interest within an image by using the image display system and the mouse.

DIGITAL_FILTER (flow, fhigh, gibbs, nterm)

Standard Library function that constructs finite impulse response digital filters for signal processing.

DILATE (image, structure [, x0, y0] )

Implements the morphologic dilation operator for shape processing.

DIST (n)

Standard Library function that generates a square array in which each element equals the euclidean distance from the nearest corner.

ERODE (image, structure [, x0, y0] )

Implements the morphologic erosion operator for shape processing.

FFT (array, direction)

Returns the Fast Fourier Transform for the input variable.

HANNING (col [, row] )

Standard Library function that implements a window function for Fast Fourier Transform signal or image filtering.

HIST_EQUAL (image)

Standard Library function that returns a histogram-equalized image or vector.

HISTOGRAM (array)

Returns the density function of an array.

IMAGE_CONT, array

Standard Library procedure that overlays a contour plot onto an image display of the same array.

LEEFILT (image [, n, sigma] )

Standard Library function that performs image smoothing by applying the Lee Filter algorithm.

MEDIAN (array [, width] )

Finds the median value of an array, or applies a one- or two- dimensional median filter of a specified width to an array.

MOVIE, images [, rate]

Standard Library procedure that shows a cyclic sequence of images stored in a three-dimensional array.

POLY_2D (array, coeff_x, coeff_y [, interp [, dim_x ,..., dim_y]])

Performs polynomial warping of images.

POLYFILLV (x, y, sx, sy [, run_length] )

Returns a vector containing the subscripts of the array elements contained inside a specified polygon.

POLYWARP, xd, yd, xin, yin, deg, xm, ym

Standard Library procedure that calculates the coefficients needed for a polynomial image warping transformation.

PROFILE (image)

Standard Library function that extracts a profile from an image.

PROFILES, image

Standard Library procedure that lets you interactively draw row or column profiles of the image displayed in the current window. The profiles are displayed in a new window, which is deleted when you exit the procedure.

RDPIX, image [, x0, y0]

Standard Library procedure that displays the X, Y, and pixel values at the location of the cursor in the image displayed in the currently active window.

REBIN (array, dim₁, ..., dim_n)

Returns a vector or array resized to the given dimensions.

REFORM (array, dim₁, ... , dim_n)

Reformats an array without changing its values numerically.

ROBERTS (image)

Performs a Roberts edge enhancement of an image.

ROT (image, ang [, mag, xctr, yctr] )

Standard Library function that rotates and magnifies (or demagnifies) a two-dimensional array.

ROT_INT (image, ang [, mag, xctr, yctr] )

Standard Library function that rotates and magnifies (or demagnifies) an image on the display screen.

ROTATE (array, direction)

Returns a rotated and/or transposed copy of the input array.

SHIFT (array, shift₁, ... , shift_n)

Shifts the elements of a vector or array along any dimension by any number of elements.

SHOW3, array

Standard Library procedure that displays a two-dimensional array as a combination contour, surface, and image plot. The resulting display shows a surface with an image underneath and a contour overhead.

SMOOTH (array, width)

Smooths an array with a boxcar average of a specified width.

SOBEL (image)

Performs a Sobel edge enhancement of an image.

TRANSPOSE (array)

Transposes the input array.

ZOOM

Standard Library procedure that expands and displays part of an image (or graphic plot) from the current window in a second window.

ASSOC (unit, array_structure [, offset])

Associates an array structure with a file, allowing random access input and output.

BYTEORDER, variable₁, ... , variable_n

Converts integers between host and network byte ordering. Can also be used to swap the order of bytes within both short and long integers.

GET_KBRD (wait)

Returns the next character available from standard input (PV-WAVE file unit 0).

LN03 [, filename]

Standard Library procedure that opens or closes an output file for LN03 graphics output. The file can then be printed on an LN03 printer.

PRINT, expr₁, ... , expr_n

PRINT performs output to the standard output stream (PV-WAVE file unit -1).

PRINTF, unit, expr₁, ... , expr_n

PRINTF requires the output file unit to be specified.

READ, var₁, ..., var_n

Read input from the standard input stream into PV-WAVE variables.

READF, unit, var₁, ... , var_n

Read input from a file into PV-WAVE variables.

READU, unit, var₁, ... , var_n

READU reads binary (unformatted) input from a specified file. (No processing of any kind is done to the data.)

REWIND, unit

(OpenVMS Only) Rewinds the tape on the designated PV-WAVE tape unit.

SKIPF, unit, files

(OpenVMS Only) Skips files on the designated magnetic tape unit.

SKIPF, unit, records, r

(OpenVMS Only) Skips records on the designated magnetic tape unit.

TAPRD, array, unit [, byte_reverse]

(OpenVMS Only) Reads the next record on the selected tape unit into the specified array.

TAPWRT, array, unit [, byte_reverse]

(OpenVMS Only) Writes data from the input array to the selected tape unit.

WPRINT [, window_index]

(Microsoft Windows Only) Prints the contents of a specified window.

WREAD_DIB ( [window_index] )

(Microsoft Windows Only) Loads a Device Independent Bitmap (DIB) from a file into a graphics window.

WREAD_META ( [window_index] )

(Microsoft Windows Only) Loads a Windows metafile (WMF) into a graphics window.

WRITEU, unit, expr₁, ... , expr_n

Writes binary (unformatted) data from an expression into a file.

WWRITE_DIB ( [window_index] )

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Device Independent Bitmap (DIB).

WWRITE_META ( [window_index] )

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Windows metafile (WMF).

MAP

Plots a map.

MAP_CONTOUR, z [, x, y]

Draws a contour plot from longitude/latitude data stored in a 2D array.

MAP_PLOTS, x, y

Plots vectors or points (specified as longitude/latitude data) on the current map projection.

MAP_POLYFILL, x, y

Fills the interior of a region of the display enclosed by an arbitrary 2D polygon.

MAP_REVERSE, x, y, lon, lat

Converts output from routines like CURSOR and WtPointer from device, normal, or data coordinates to longitude and latitude coordinates.

MAP_VELOVECT, u, v, [, x, y]

Draws a two-dimensional velocity field plot on a map, with each directed arrow indicating the magnitude and direction of the field.

MAP_XYOUTS, x, y, string

Draws text on the currently selected graphics device starting at the designated map coordinate.

USGS_NAMES ( [name] )

Queries a database containing names, FIPS codes, and longitude/latitude values for cities and towns in the United States.

Plots a map.

CALL_UNIX (p₁ [, p₂, ... , p₃₀])

(UNIX Only) Lets a PV-WAVE procedure communicate with an external routine written in C.

CD [, directory]

Changes the current working directory.

DELETE_SYMBOL, name

(OpenVMS Only) Deletes a DCL (Digital Command Language) interpreter symbol from the current process.

DEL_FILE, filename

Deletes a specified file on your system.

DELLOG, logname

(OpenVMS Only) Deletes a logical name.

ENVIRONMENT ( )

(UNIX Only) Returns a string array containing all the UNIX environment strings for the PV-WAVE process.

GETENV (name)

Returns the specified equivalence string from the environment of the PV-WAVE process.

GET_SYMBOL (name)

(OpenVMS Only) Returns the value of an OpenVMS DCL interpreter symbol as a scalar string.

LINKNLOAD (object, symbol [, param₁, ..., param_n])

Provides simplified access to external routines in shareable images.

POPD

Standard Library procedure that pops a directory from the top of a last-in, first-out directory stack.

PRINTD

Standard Library procedure that lists the directories located in the directory stack, and the current working directory.

PUSHD [, directory]

Standard Library procedure that pushes a directory onto the top of a last-in, first-out directory stack.

SETENV, environment_expr

(UNIX Only) Adds or changes an environment string in the process environment.

SETLOG, logname, value

(OpenVMS Only) Defines a logical name.

SET_SYMBOL, name, value

(OpenVMS Only) Defines a DCL interpreter symbol for the current process.

SPAWN [, command [, result]]

(UNIX/OpenVMS) Spawns a child process to execute a given command.

SPAWN [, command [, result]]

(Windows) Spawns a child process to execute a given command.

SYSTIME (param)

Returns the current system time as either a string or as the number of seconds elapsed since January 1, 1970.

TRNLOG (logname, value)

(OpenVMS Only) Searches the OpenVMS name tables for a specified logical name and returns the equivalence string (s) in a PV-WAVE variable.

WEOF, unit

(OpenVMS Only) Writes an end-of-file mark on the designated unit at the current position.

Plotting Routines

AXIS [[[, x], y], z]

Draws an axis of the specified type and scale at a given position.

BAR, x [,y]

Plots a 2D bar graph that can include stacked and grouped bars, as well as various color and fill pattern options.

BAR2D, x [,y]

Creates a two-dimensional bar plot.

BAR3D, z

Creates a three-dimensional bar plot.

CONTOUR, z [, x, y]

Draws a contour plot from data stored in a rectangular array.

CONTOUR2, z [, x, y]

Draws a contour plot from data stored in a rectangular array.

CONTOURFILL, filename, z [, x, y]

Standard Library procedure that fills both open and closed contours with specified colors or patterns.

CURSOR, x, y [, wait]

Reads the position of the interactive graphics cursor from the current graphics device.

ERRPLOT [, points], low, high

Standard Library procedure that overplots error bars over a previously-drawn plot.

GRID (xtmp, ytmp, ztmp)

Standard Library function that generates a uniform grid from irregularly-spaced data.

IMAGE_CONT, array

Standard Library procedure that overlays a contour plot onto an image display of the same array.

OPLOT, x [, y]

Plots vector data over a previously drawn plot.

OPLOTERR, x, y, error [, psym]

Standard Library procedure that overplots symmetrical error bars on any plot already output to the display device.

PIE, data [, labels]

Displays data as a pie chart.

PIE_CHART, data, [xcenter, ycenter, radius]

Creates a pie chart with colors, text labels, exploded slices and/or shadows.

PLOT, x [, y]

PLOT produces a simple XY plot.

PLOT_HISTOGRAM, variable

Plots a histogram.

PLOT_IO, x [, y]

PLOT_IO produces an XY plot with logarithmic scaling on the Y axis.

PLOT_OI, x [, y]

PLOT_OI produces an XY plot with logarithmic scaling on the X axis.

PLOT_OO, x [, y]

PLOT_OO produces an XY plot with logarithmic scaling on both the X and Y axes.

PLOTERR, [x,] y, error

Standard Library procedure that plots data points with accompanying symmetrical error bars.

PLOT_FIELD, u, v

Standard Library procedure that plots a two-dimensional velocity field.

PLOTS, x [, y [, z]]

Plots vectors or points on the current graphics device in either two or three dimensions.

POLYFILL, x [, y [, z]]

Fills the interior of a region of the display enclosed by an arbitrary two- or three-dimensional polygon.

POLYSHADE (vertices, polygons)

Constructs a shaded surface representation of one or more solids described by a set of polygons.

PROFILE (image)

Standard Library function that extracts a profile from an image.

PROFILES, image

Standard Library procedure that lets you interactively draw row or column profiles of the image displayed in the current window. The profiles are displayed in a new window, which is deleted when you exit the procedure.

SCALE3D

Standard Library procedure that scales a three-dimensional unit cube into the viewing area.

SET_SHADING

Modifies the light source shading parameters affecting the output of SHADE_SURF and POLYSHADE.

SHADE_SURF, z [, x, y]

Standard Library procedure that creates a shaded surface representation of a regular or nearly regular gridded surface, with shading from either a light source model or from a specified array of intensities.

SHADE_SURF_IRR, z, x, y

Creates a shaded-surface representation of a semiregularly gridded surface, with shading from either a light source model or from a specified array of intensities.

SHOW3, array

Standard Library procedure that displays a two-dimensional array as a combination contour, surface, and image plot. The resulting display shows a surface with an image underneath and a contour overhead.

SURFACE, z [, x, y]

Draws the surface of a two-dimensional array projected into two dimensions, with hidden lines removed.

T3D

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformations and stores the result in the system variable !P.T.

THREED, array [, space]

Standard Library procedure that plots a two-dimensional array as a pseudo three-dimensional plot on the currently selected graphics device.

USERSYM, x [, y]

Lets you create a custom symbol for marking plotted points.

VEL, u, v

Standard Library procedure that draws a graph of a velocity field with arrows pointing in the direction of the field. The length of an arrow is proportional to the strength of the field at that point.

VELOVECT, u, v [, x, y]

Standard Library procedure that draws a two-dimensional velocity field plot, with each directed arrow indicating the magnitude and direction of the field.

Polygon Generation Routines

POLY_SPHERE, radius, px, py, vertex_list, polygon_list

Generates the vertex list and polygon list that represent a sphere.

POLY_SURF, surf_dat, vertex_list, polygon_list, pg_num

Generates a 3D vertex list and a polygon list, given a 2D array containing Z values.

SHADE_VOLUME, volume, value, vertex, poly

Given a 3D volume and a contour value, produces a list of vertices and polygons describing the contour surface (also known as an iso-surface).

Polygon Manipulation Routines

POLY_C_CONV (polygon_list, colors)

Returns a list of colors for each polygon, given a polygon list and a list of colors for each vertex.

POLY_COUNT (polygon_list)

Returns the total number of polygons contained in a polygon list.

POLY_MERGE, vertex_list1, vertex_list2, polygon_list1, polygon_list2, vert, poly, pg_num

Merges two vertex lists and two polygon lists together so that they can be rendered in a single pass.

Polygon Rendering Routines

POLY_PLOT, vertex_list, polygon_list, pg_num, winx, winy, fill_colors, edge_colors, poly_opaque

Renders a given list of polygons.

POLYSHADE (vertices, polygons)

POLYSHADE (x, y, z, polygons)

Constructs a shaded surface representation of one or more solids described by a set of polygons.

RENDER (object1, ..., objectn)

Generates a ray-traced rendered image from one or more predefined objects.

ADDVAR, name, local

Creates a variable on the $MAIN$ program level and binds a local variable to it.

BREAKPOINT, file, line

Lets you insert and remove breakpoints in programs for debugging.

CHECKFILE( filename )

Determines if a file can be read from or written to.

CHECK_MATH ([print_flag, message_inhibit])

Returns and clears the accumulated math error status.

DEFINE_KEY, key [, value]

Programs a keyboard function key with a string value, or with a specified action.

DEFSYSV, name, value [, read_only]

Creates a new system variable initialized to the specified value.

DELFUNC, function_i ,..., function_n

Deletes one or more compiled functions from memory.

DELPROC, procedure_i ,..., procedure_n

Deletes one or more compiled procedures from memory.

DELSTRUCT, structure_i ,..., structure_n

Deletes one or more named structure definitions from memory.

DELVAR, v₁, ... ,v_n

Deletes variables from the main program level.

EXIT

Exits PV-WAVE and returns you to the operating system.

FINITE (x)

Returns a value indicating if the input variable is finite or not.

HAK

Standard Library procedure that lets you implement a "hit any key to continue" function.

KEYWORD_SET (expr)

Tests if an input expression has a nonzero value.

MESSAGE, text

Issues error and informational messages using the same mechanism employed by built-in PV-WAVE routines.

N_ELEMENTS (expr)

Returns the number of elements contained in any expression or variable.

N_PARAMS ( )

Returns the number of non-keyword parameters used in calling a PV-WAVE procedure or function.

N_TAGS (expr)

Returns the number of structure tags contained in any expression.

ON_ERROR, n

Determines the action taken when an error is detected inside a PV-WAVE user-written procedure or function.

ON_ERROR_GOTO, label

Specifies a statement to jump to if an error occurs in the current procedure.

ON_IOERROR, label

Specifies a statement to jump to if an I/O error occurs in the current procedure.

PARAM_PRESENT (parameter)

Tests if a parameter was actually present in the call to a procedure or function.

PARSEFILENAME (pathname)

Extracts specified parts of a full file pathname.

RENAME, variable, new_name

Renames a PV-WAVE variable.

RETALL

Issues RETURNs from nested routines. Used primarily to recover from errors in user-written procedures and functions.

RETURN [, expr]

Returns control to the caller of a user-written procedure or function.

SIZE (expr)

Returns a vector containing size and type information for the given expression.

STOP [, expr₁,... , expr_n]

Stops the execution of a running program or batch file, and returns control to the interactive mode.

STRMESSAGE (errno)

Returns the text of the error message specified by the input error number.

STRUCTREF ({structure})

Returns a list of all existing references to a structure.

TAG_NAMES (expr)

Returns a string array containing the names of the tags in a structure expression.

UPVAR, name, local

Accesses a variable that is not on the current program level.

VAR_MATCH( )

Standard Library function that scans for PV-WAVE variables that match the given criteria.

WAIT, seconds

Suspends execution of a PV-WAVE program for a specified period.

Ray Tracing Routines

CONE ( )

Defines a conic object that can be used by the RENDER function.

CYLINDER ( )

Defines a cylindrical object that can be used by the RENDER function.

MESH (vertex_list, polygon_list)

Defines a polygonal mesh object that can be used by the RENDER function.

RENDER (object1, ..., objectn)

Generates a ray-traced rendered image from one or more predefined objects.

SPHERE ( )

Defines a spherical object that can be used by the RENDER function.

VOLUME (voxels)

Defines the volumetric data that can be used by the RENDER function.

INFO, expr₁, ... , expr_n

Displays information on many aspects of the current PV-WAVE session.

JOURNAL [, param]

Provides a record of an interactive session by saving in a file all text entered from the terminal in response to a prompt.

RESTORE [, filename]

Restores the PV-WAVE objects saved in a file by the SAVE procedure.

SAVE [, var₁, ... , var_n]

Saves variables in a file for later recovery by RESTORE.

BESELI (x [, n])

Calculates the Bessel I function for the input parameter.

BESELJ (x [, n])

Calculates the Bessel J function for the input parameter.

BESELY (x [, n])

Calculates the Bessel Y function for the input parameter.

ERRORF (x)

Calculates the standard error function of the input variable.

GAMMA (x)

Calculates the gamma function of the input variable.

GAUSSINT (x)

Evaluates the integral of the Gaussian probability function.

STRCOMPRESS (string)

Compresses the white space in an input string.

STRJOIN(expr [, sep]

Concatenates all of the elements of a string array into a single scalar string.

STRLEN (expr)

Returns the length of the input parameter.

STRLOOKUP([name])

Queries, creates, saves, or modifies a string server database.

STRLOWCASE (string)

Converts a copy of the input string to lowercase letters.

STRMATCH(string, expr [, registers])

Matches a specified string to an existing regular expression.

STRMID (expr, first_character, length)

Extracts a substring from a string expression.

STRPOS (object, search_string [, position] )

Searches for the occurrence of a substring within an object string, and returns its position.

STRPUT, destination, source [, position]

Inserts the contents of one string into another.

STRSPLT(expr, pattern)

Splits a string into an array of tokens (substrings).

STRSUBST(expr, pattern, repl)

Performs string substitution (search and replace).

STRTRIM (string [, flag] )

Removes extra blank spaces from an input string.

STRUPCASE (string)

Converts a copy of the input string to uppercase letters.

BUILD_TABLE ( ' var_i [alias], ..., var_n [alias] ' )

Creates a table from one or more vectors (one-dimensional arrays).

GROUP_BY(in_table, `sum_column [alias] [ASC | DESC]')

Performs summary (aggregate) functions to groups of rows in a PV-WAVE table variable.

ORDER_BY(in_table, `col_1 [ASC | DESC] [, col_2 [ASC | DESC]] ... [, col_n [ASC | DESC]]')

Sorts the rows in a PV-WAVE table variable to create a new table.

QUERY_TABLE ( table, ' [Distinct] * | col_i [alias] [, ..., col_n [alias]] [Where cond] [Group By colg_i [,... colg_n]] | [Order By colo_i [direction][,..,colo_n [direction]]] ' )

Subsets a table created with the BUILD_TABLE function.

UNIQUE (vec)

Returns a vector (one-dimensional array) containing the unique elements from another vector variable.

Transcendental Mathematical Functions

ACOS (x)

Returns the arc-cosine of x.

ALOG (x)

Returns the natural logarithm of x.

ALOG10 (x)

Returns the logarithm to the base 10 of x.

ASIN (x)

Returns the arcsine of x.

ATAN (x [, y] )

Calculates the arctangent of the input variable (s).

COS (x)

Calculates the cosine of the input variable.

COSH (x)

Calculates the hyperbolic cosine of the input variable.

EXP (x)

Raises e to the power of the value of the input variable.

SIN (x)

Returns the sine of the input variable.

SINH (x)

Returns the hyperbolic sine of the input variable.

SQRT (x)

Calculates the square root of the input variable.

TAN (x)

Returns the tangent of the input variable.

TANH (x)

Returns the hyperbolic tangent of the input variable.

Navigator

Starts the Navigator.

WzAnimate, var

Starts a VDA Tool used for animating a sequence of images.

WzColorEdit [, var1[, var2, var3]]

Starts a VDA Tool used for editing the image and plot color tables used in other VDA Tools.

WzContour, var

Starts a VDA Tool used for plotting contours.

WzExport, var

Starts a VDA Tool used for exporting a PV-WAVE variable to an external file in a specified format.

WzHistogram, var

Starts a VDA Tool used for plotting a histogram.

WzImage, var

Starts a VDA Tool used for displaying image data.

WzImport [, var₁, var₂, ... , var_n]

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

WzMultiView

Starts a VDA Tool used to display multiple plots.

WzPlot, var₁ [, var₂, ... , var_n]

Starts a VDA Tool used for 2D plotting.

WzPreview [, filename]

Starts a VDA Tool used to view an ASCII file's contents and select which parts of the file are to be read in as PV-WAVE variables.

WzSurface, z [, x, y]

Starts a VDA Tool used for surface plots.

WzTable, var

Starts a VDA Tool used for creating an editable 2D array of cells containing string data.

WzVariable

Starts a VDA Tool used for viewing and exporting variables.

---

NOTE: For detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

TmAddSelectedVars, tool_name, var_name

Adds selected variables from a VDA Tool to the list of selected variables in the Tools Manager.

TmAddVar, tool_name, var_name

Adds a variable to a VDA Tool.

TmAxis, tool_name

Adds axes to a VDA Tool.

TmCodeGen, string

Writes a specified string to the code generation file.

TmCopy, tool_name

Copies the selected graphical elements from the specified VDA Tool to the clipboard.

TmCut, tool_name

Cuts the selected graphical elements from the specified VDA Tool and moves them to the clipboard.

TmDelVar, tool_name [, var_names]

Removes variables from a VDA Tool.

TmDelete, tool_name

Permanently deletes the selected graphical elements from the specified VDA Tool.

TmDeselectVars

Clears the current list of selected variables.

TmDynamicDisplay, indices

Displays selected data in all active VDA Tools, provided that the VDA Tools can display the related variable(s).

TmEndCodeGen

Closes the file in which generated code is written.

TmEnumerateAttributes(tool_name, item)

Obtains the attributes for a specified graphical element, variable, or other item in a VDA Tool.

TmEnumerateItems(tool_name)

Obtains the items defined for a specified VDA Tool.

TmEnumerateMethods(tool_name)

Obtains the methods that were set for a VDA Tool.

TmEnumerateSelectedVars( )

Returns the names of variables on the selected variables list.

TmEnumerateToolNames( )

Returns all the registered VDA Tool names.

TmEnumerateVars(tool_name)

Returns all the variables associated with an instance of a VDA Tool.

TmExecuteMethod, tool_name, method_name

Executes a method that was set by TmSetMethod.

TmExport, variable_names, destination_tool_names

Exports $MAIN$-level variables to specified VDA Tools or to all currently active VDA Tools.

TmExportSelection, destination_tool_names

Exports the contents of the variable selection list to specified VDA Tools.

TmGetAttribute(tool_name, item, attr_name)

Returns the value that was set for an attribute in a VDA Tool instance.

TmGetMessage( [message_file], message_code)

Loads a string resource file into the resource database and extracts a message string from the database.

TmGetMethod(tool_name, method_name)

Returns the data structure of the specified method.

TmGetTop(tool_name)

Gets the top-level widget ID for a VDA Tool.

TmGetUniqueToolName(tool_name)

Returns a unique name for a particular instance of a specified VDA Tool.

TmGetVarMainName(tool_name, local_variable)

Returns the $MAIN$ level name of a variable.

TmInit

Initializes the VDA Tools Manager layer.

TmList(tool_name)

Creates a list item.

TmListAppend, tool_name, list_name, item

Adds a new item at the end of the specified list.

TmListClear, tool_name, list_name

Resets a specified list to its initial state, clearing all previously defined items.

TmListDelete, tool_name, list_name [, pos]

Deletes an item in the specified list.

TmListDestroy, tool_name, list_name

Clears all items and destroys the list.

TmListExtend, tool_name, list_name

Extends the specified list by adding empty items.

TmListGetMethod(tool_name, list_name, method_name)

Returns the procedure name associated with the specified list method name.

TmListInsert, tool_name, list_name, item, pos

Inserts a new item into the specified list.

TmListReplace, tool_name, list_name, item, pos

Replaces an item in a list with a new item.

TmListRetrieve(tool_name, list_name)

Gets the items currently set in the specified list.

TmListSetMethod, tool_name, list_name, method_name, method

Sets the method procedure name for a specific list method.

TmPaste, tool_name

Pastes the graphical elements from the clipboard to the specified VDA Tool.

TmRegister, unique_name, topShell

Registers a VDA Tool with the Tools Manager.

TmRestoreTemplate(tool_name, filename)

Restores a saved VDA Tool template.

TmRestoreTools(filename)

Restores the VDA Tools that were saved with the TmSaveTools procedure.

TmSaveTools, filename [, tool_names]

Saves the specified VDA Tools in a file.

TmSetAttribute(tool_name, item, attr_name, attr_value)

Set an attribute for an item in the given VDA Tool.

TmSetMethod, tool_name, method_name, method_call

Sets a method for a given VDA Tool.

TmStartCodegen, filename

Opens a file into which PV-WAVE code is written.

TmUnregister, tool_name

Removes the specified VDA Tool from the Tools Manager registry.

---

NOTE: For detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

TmAddGrael, tool_name, grael_name

Adds a graphical element to the graphical element list for the specified instance of a VDA Tool.

TmAddSelectedGrael, tool_name, grael_name

Adds a graphical element to the graphical element selection list.

TmAxis, tool_name

Adds axes to a VDA Tool.

TmBitmap, tool_name, bitmap_name

Adds a bitmap (2D array) to a VDA Tool.

TmBottomGrael, tool_name, grael_name

Sets the specified graphical element to be on the bottom of the display list (displayed behind the other graphical elements).

TmDelGrael, tool_name, grael_name

Removes a specified graphical element from the list of graphical elements associated with a VDA Tool instance.

TmDelSelectedGraels, tool_name, grael_name

Deletes a graphical element from the list of selected graphical elements.

TmEnumerateGraelMethods(tool_name, grael_name)

Obtain a list of all the methods set for a graphical element in a specified VDA Tool.

TmEnumerateGraels(tool_name)

Returns all the graphical elements that were set for a given VDA Tool.

TmEnumerateSelectedGraels(tool_name)

Obtains a list of graphical elements or other items currently on the graphical items selection list.

TmExecuteGraelMethod, tool_name, grael_name, method_name

Executes a method for a graphical method based on the method name.

TmGetGraelMethod(tool_name, grael_name, method_name)

Obtains the data structure for the specified method.

TmGetGraelRectangle(tool_name, grael_name)

Returns the rectangular boundary of a graphical element.

TmGetUniqueGraelName(tool_name, grael_name)

Obtains a unique name based on the name of the specified graphical element.

TmGroupGraels(tool_name, grael_names)

Groups a number of selected graphical elements as one graphical element with a unique name.

TmLegend, tool_name

Adds a legend to a VDA Tool. The exact size and position of the legend is determined interactively by the user.

TmLine, tool_name

Adds a line to a VDA Tool. The exact length and position of the line is determined interactively by the user.

TmRect, tool_name

Adds a rectangle to a VDA Tool. The exact size and position of the rectangle is determined interactively by the user.

TmSetGraelMethod, tool_name, grael_name, method_name, method_value

Sets the name of the method procedure for a given method name and graphical element.

TmSetGraelRectangle, tool_name, grael_name, rectangle

Sets the selection rectangle for a graphical element, or a set of graphical elements.

TmText, tool_name

Adds text to a VDA Tool. The position of the text and the text itself are determined interactively by the user.

TmTopGrael, tool_name, grael_name

Sets the specified graphical element to be at the top of the display list (displayed in front of other graphical elements).

TmUngroupGraels, tool_name, group_name

Ungroups a group of graphical elements.

---

NOTE: For detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

WoAddButtons, toolname, buttons

Adds a bank of buttons to a button bar.

WoAddMessage, toolname, message_key

Adds a message to a message area created by WoMessage.

WoAddStatus, toolname, status_key

Display a message in the status bar of a VDA Tool.

WoBuildResourceFilename(file)

Returns the full path name for a specified resource file.

WoButtonBar(parent, toolname, [buttons])

Creates a predefined, two-row button bar that can be included in a VDA Tool.

WoButtonBarSet, toolname, descriptor, setting

Changes the setting of a button in a button bar.

WoButtonBarSetSensitivity, toolname, descriptor, sensitivity

Sets the sensitivity of one or more buttons on a button bar.

WoCheckFile(file)

Confirms if a file is readable or writable.

WoColorButton(parent)

Creates a button that brings up a color table dialog box used to set colors in a VDA Tool. The button has an associated color pixmap that reflects the currently selected color.

WoColorButtonGetValue(wid)

Gets the currently selected color index from a color button created by WoColorButton.

WoColorButtonSetValue(wid, color)

Sets the current color index for a color button created by WoColorButton, and updates the color button's color pixmap.

WoColorConvert(color)

Convert from a long RGB value to an index into the current color table, or from an index in the current color table to an RGB value.

WoColorGrid(parent)

Creates a grid of color squares from the current color table.

WoColorGridGetValue(wid, index, num_values)

Gets the color indices for a range of colors in a color grid.

WoColorGridSetValue, wid, index, color

Sets the color indices for a range of colors in the color grid.

WoColorWheel(tool_name, color_index, value_changed_cb)

Creates a color wheel that can be used to modify a single color in the current color table.

WoConfirmClose, wid, tool_name

Displays a dialog box requiring the user to confirm a window close action.

WoDialogStatus, toolname, status

Saves or restores the status of a dialog box by saving or restoring the state of its widgets as stored in the Tools Manager.

WoFontOptionMenu(parent, toolname)

Creates an option menu with the standard list of software (vector-drawn) fonts found in PV-WAVE.

WoFontOptionMenuGetValue(wid)

Gets the software font command for the currently selected font.

WoFontOptionMenuSetValue, wid, font

Sets the current font and updates the font option menu.

WoGenericDialog(parent, topLayout [,callback])

Creates a generic dialog box for use in VDA Tools.

WoGetToolNameFromTitle(window_title)

Gets the unique name of a VDA tool given the unique window title of the VDA Tool.

WoGetUniqueWindowTitle(primary, secondary)

Given a window title, adds a numeric suffix to make the title unique.

WoLabeledText(parent, label_names, verify_callback)

Creates a group of aligned text widgets (widgets with a label and a text field).

WoLinestyleOptionMenu(parent, toolname)

Creates an option menu for selecting linestyles.

WoLinestyleOptionMenuGetValue(wid)

Gets the currently selected linestyle.

WoLineStyleOptionMenuSetValue, wid, linestyle

Sets the option menu to a specified linestyle.

WoLoadResources, file

Loads resources and strings from a file for VDA tools.

WoLoadStrings, file

Loads strings from a resource file for use by the VDA tools.

WoMenuBar(parent, toolname [,menus])

Create a menu bar for a VDA Tool.

WoMenuBarSetSensitivity, toolname, pane_index, item_index, sensitivity

Sets the sensitivity of one or more items in a menu.

WoMenuBarSetToggle, tool_name, pane_index, item_index, value

Sets the status of a menu toggle button.

WoMessage(parent, toolname)

Creates a message area for a VDA Tool

WoSaveAsPixmap, tool_name, varname

Saves graphics from a specified VDA Tool as a pixmap.

WoSetCursor, tool_name

Changes the cursor for a VDA Tool.

WoSetToolIcon, tool_name, icon

Assigns a pixmap to be the icon for a VDA Tool.

WoSetWindowTitle, tool_name, window_title

Specifies a unique title for a VDA Tool window.

WoStatus(parent, toolname)

Create a status bar for a VDA Tool.

WoVariableOptionMenu(parent, toolname)

Creates an option menu containing the names of all of the variables associated with the current tool.

WoVariableOptionMenuGetValue(wid)

Gets the currently selected variable name from an option menu that was created with the WoVariableOptionMenu function.

WoVariableOptionMenuSetValue, wid, value

Sets the current selection in the variable option menu.

CENTER_VIEW

Sets system viewing parameters to display data in the center of the current window (a convenient way to set up a 3D view).

SET_VIEW3D, viewpoint, viewvector, perspective, izoom, viewup, viewcenter, winx, winy, xr, yr, zr

Generates a 3D view, given a view position and a view direction.

T3D

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformation and stores the results in the system variable !P.T.

VIEWER, win_num, xsize, ysize, size_fac, xpos, ypos, colors, retain, xdim, ydim, zdim

Lets users interactively define a 3D view, a slicing plane, and multiple cut-away volumes for volume rendering. (Creates a View Control and a View Orientation window in which to make these definitions.)

Virtual Reality Modeling Language (VRML) Routines

VRML_AXIS, origin [, length, range]

Adds an axis to a VRML world.

VRML_CAMERA, position

Positions a VRML camera for rendering the VRML view.

VRML_CLOSE

Closes the VRML file.

VRML_CONE

Creates a VRML cone.

VRML_CUBE

Positions a VRML cube in the world.

VRML_CYLINDER

Positions a VRML cylinder in the world.

VRML_LIGHT, position

Sets up the light source for a VRML world.

VRML_LINE, x, y, z

Creates a VRML line object.

VRML_OPEN

Opens a VRML file and writes out header information consistent with VRML formatting.

VRML_POLY, vlist, plist

Creates a VRML polyline node, based on PV-WAVE's variables for vertex list and polygon list.

VRML_SPHERE

Creates a sphere in a VRML world.

VRML_SPOTLIGHT, position

Creates a VRML spotlight.

VRML_SURFACE, z [, x, y]

Creates a VRML surface node based on PV-WAVE-type variables.

VRML_TEXT, text

Creates a VRML text object in an open VRML file.

Volume Manipulation Routines

SLICE_VOL (volume, dim, cut_plane)

Returns a 2D array containing a slice from a 3D volumetric array.

VOL_PAD (volume, pad_width)

Returns a 3D volume of data padded on all six sides with zeroes.

VOL_TRANS (volume, dim, trans)

Returns a 3D volume of data transformed by a 4-by-4 matrix.

Volume Rendering Routines

RENDER (object1, ..., objectn)

Generates a ray-traced rendered image from one or more predefined objects.

VECTOR_FIELD3, vx, vy, vz, n_points

Plots a 3D vector field from three arrays.

VOL_MARKER, vol, n_points

Displays colored markers scattered throughout a volume.

VOL_REND (volume, imgx, imgy)

Renders volumetric data in a translucent manner.

---

NOTE: For detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

WwAlert(parent, label [, answers])

Creates a modal (blocking) or modeless (non-blocking) popup alert box containing a message and optional control buttons.

WwAlertPopdown, wid

Destroys an alert box.

WwButtonBox (parent, labels, callback)

Creates a horizontally or vertically oriented box containing push buttons.

WwCallback(wid, callback, reason, client_data)

Adds or removes a WAVE Widgets callback.

WwCommand (parent, enteredCallback, doneCallback)

Creates a command window.

WwControlsBox (parent, labels, range, changedCallback)

Creates a box containing sliders.

WwDialog (parent, label, OKCallback, CancelCallback, HelpCallback)

Creates a blocking or nonblocking dialog box.

WwDrawing (parent, windowid, drawCallback, wsize, dsize)

Creates a drawing area, which allows users to display graphics generated by PV-WAVE.

WwFileSelection (parent, OKCallback, CancelCallback, HelpCallback)

Creates a file selection widget, which lets the user display the contents of directories and select files.

WwGenericDialog(parent, layout [, labels] [, callback])

Creates a generic dialog box that can be filled with custom widgets.

WwGetButton(event)

Obtains the index of a pressed or released button passed as an event structure by a WAVE Widgets event handler.

WwGetKey(event)

Obtains the ASCII value of a pressed or released key passed as an event structure by a WAVE Widgets event handler.

WwGetPosition(event)

Obtains the coordinates of a selected point inside a widget. The selected point coordinates are passed in an event structure by a WAVE Widgets event handler.

WwGetValue (widget)

Returns a specific value for a given widget.

WwHandler(wid, handler [, mask [, userdata]])

Adds or removes a WAVE Widgets event handler from a widget.

WwInit (app_name, appclass_name, workarea [, destroyCallback])

Initializes the WAVE Widgets environment, opens the display, creates the first top-level shell, and creates a layout widget.

WwLayout (parent)

Creates a layout widget that is used to control the arrangement of other widgets.

WwList (parent, items, selectedCallback, defaultCallback)

Creates a scrolling list widget.

WwListUtils(wid [, param1[, param2]])

Manages the contents of a list widget.

WwLoop

Handles the dispatching of events and calling of PV-WAVE callbacks.

WwMainWindow (parent, workarea, [destroyCallback])

Creates a top-level window and a layout widget.

WwMenuBar (parent, items)

Creates a menu bar.

WwMenuItem (parent, item, value [, callback])

Adds, modifies, or deletes specified menu items.

WwMessage (parent, label, OKCallback, CancelCallback, HelpCallback)

Creates a blocking or nonblocking message box.

WwMultiClickHandler(wid, handler [, userdata])

Adds or removes a multi-click event handler.

WwOptionMenu (parent, label, items)

Creates an option menu.

WwPickFile(parent [, HelpCallback ] )

Creates a modal file selection dialog that blocks until a file name has been selected.

WwPopupMenu (parent, items)

Creates a popup menu.

WwPreview, parent, confirmCallback, clearCallback

Creates an ASCII data preview widget.

WwPreviewUtils(wid [, param1, param2, param3])

Manages the contents of a preview widget.

WwRadioBox (parent, labels, callback)

Creates a box containing radio buttons.

WwResource([resvar])

Queries, creates, saves, or modifies the widget resource database.

WwSeparator( parent )

Creates a horizontal or vertical line that separates components in a graphical user interface.

WwSetCursor(wid, cursor)

Sets the cursor for a widget.

WwSetValue (widget, [value])

Sets the specified value for a given widget.

WwTable (parent, callback [, variable])

Creates an editable 2D array of cells containing string data, similar to a spreadsheet.

WwTableUtils(wid [, param1, ..., param9])

Manages the contents of a table widget.

WwText (parent, verifyCallback)

Creates a text widget that can be used for both single-line text entry or as a full text editor. In addition, this function can create a static text label.

WwTimer(time, timer_proc [, userdata])

Registers a WAVE Widgets timer procedure.

WwToolBox (parent, labels, callback)

Creates an array of graphic buttons (icons).

WgAnimateTool, image_data [, parent [, shell ]]

Creates a window for animating a sequence of images.

WgCbarTool [, parent [, shell [, windowid [, movedCallback], [, range]]]]]

Creates a simple color bar that can be used to view and interactively shift a PV-WAVE color table.

WgCeditTool [, parent [, shell ]]

Creates a full-featured set of menus and widgets enclosed in a window; this window allows you to edit the values in PV-WAVE color tables in many different ways.

WgCtTool [, parent [, shell ]]

Creates a simple widget that can be used interactively to modify a PV-WAVE color table.

WgIsoSurfTool, surface_data [, parent [, shell ]]

Creates a window with a built-in set of controls; these controls allow you to easily view and modify an iso-surface taken from a three-dimensional block of data.

WgMovieTool, image_data [, parent [, shell [, windowid [, rate]]]]

Creates a window that cycles through a sequence of images.

WgSimageTool, image_data [, parent [, shell ]]

Creates two windows: 1) a scrolling image window and 2) an optional smaller window that shows a reduced view of the entire image.

WgSliceTool, block_data [, parent [, last_slice [, shell ]]]

Creates a window with a built-in set of controls; these controls allow you to easily select and view "slices" from a three-dimensional block of data.

WgStripTool [, x, y1, y2, ... , y10, parent [, shell ]]

Creates a window that displays data in a style that simulates a real-time, moving strip chart.

WgSurfaceTool, surface_data [, parent [, shell ]] 431

Creates a surface window with a built-in set of controls: these controls allow you to interactively modify surface parameters and view the result of those modifications.

WgTextTool [, parent [, shell ]]

Creates a scrolling window for viewing text from a file or character string.

---

NOTE: For detailed information on the following routines, please refer to the PV-WAVE GUI Application Developer's Guide.

---

WtAddCallback (widget, reason, callback [, client_data] )

Registers a PV-WAVE callback routine for a given widget.

WtAddHandler (widget, eventmask, handler [, client_data] )

Registers the X event handler function for a given widget.

WtClose (widget)

Closes the current Xt (Motif) session, and destroys all children of the top-level widget created in WtInit. This routine can also be used to destroy additional widget trees.

WtCreate (name, class, parent [, argv] )

Creates a widget or shell instance specified by widget class.

WtCursor (function, widget [, index] )

Sets or changes the cursor.

WtGet (widget [, resource] )

Retrieves widget resources.

WtInit (app_name, appclass_name [, Xserverargs ...] )

Initializes the Widget Toolbox and the Xt toolkit, opens the display, and creates the first top-level shell.

WtInput (function [, parameters] )

Registers a PV-WAVE input source handler procedure.

WtList (function, widget [, parameters] )

Controls the characteristics of scrolling list widgets.

WtLookupString(event)

Maps a KeyPress or KeyRelease event to its KeyEvent structure (and optionally, to its Keysym) when a user presses a key.

WtLoop

Handles the dispatching of events and calling of PV-WAVE callback routines.

WtMainLoop

Handles the dispatching of events.

WtPointer (function, widget [, parameters] )

The pointer utility function.

WtPreview(action, widget)

Handles utility functions for the preview widget (XvnPreview).

WtProcessEvent( )

Handles the dispatching of a Widget Toolbox event.

WtResource([resvar])

Queries, creates, saves, or modifies the widget resource database.

WtSet (widget, argv)

Sets widget resources.

WtTable (function, widget [, parameters] )

Modifies an xbaeMatrix class widget.

WtTimer (function, params, [client_data] )

Registers a callback function for a given timer.

WtWorkProc (function, parameters)

Registers a PV-WAVE work procedure for background processing.

WCOPY ( [window_index] )

(Microsoft Windows Only) Copies the contents of a graphics window onto the Clipboard.

WDELETE [, window_index]

Deletes the specified window.

WINDOW [, window_index]

Creates a window for the display of graphics or text.

WMENU (strings)

Displays a menu inside the current window whose choices are given by the elements of a string array and which returns the index of the user's response.

WPASTE ( [window_index] )

(Microsoft Windows Only) Pastes the contents of the Clipboard into a graphics window.

WPRINT [, window_index]

(Microsoft Windows Only) Prints the contents of a specified window.

WREAD_DIB ( [window_index] )

(Microsoft Windows Only) Loads a Device Independent Bitmap (DIB) from a file into a graphics window.

WREAD_META ( [window_index] )

(Microsoft Windows Only) Loads a Windows metafile (WMF) into a graphics window.

WSET [, window_index]

Used to select the current window to be used by the graphics and imaging routines.

WSHOW [, window_index [, show]]

Exposes or hides the designated window. It does not automatically make the designated window the active window.

WWRITE_DIB ( [window_index] )

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Device Independent Bitmap (DIB).

WWRITE_META ( [window_index] )

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Windows metafile (WMF).