COMPILE Procedure

NOTE: To execute a runtime mode application, you must have a runtime license. Without a runtime license for PV-WAVE, you will be unable to start PV-WAVE in runtime mode as described in this section. For information on obtaining a runtime license for PV-WAVE, please contact Visual Numerics.

Example 1

This example demonstrates how to save a single compiled procedure. Assume the following procedure is saved in the current working directory in the file log_plot.pro:

PRO log_plot

x = FLTARR(256)
x(80:120) = 1
freq = FINDGEN(256)
freq = freq  (256-freq)
fil = 1. / (1+(freq / 20) ^2)
PLOT_IO, freq, ABS(FFT(X,1)), Xtitle =  $
    'Relative Frequency', Ytitle ='Power',  $
    Xstyle = 1
OPLOT, freq, fil
WAIT, 3
WDELETE

END

Now start PV-WAVE. At the WAVE prompt:, compile the procedure with .RUN, and save the compiled procedure in a file using the COMPILE procedure. Then, delete the compiled procedure from memory and run the compiled procedure that is stored in the file.

.RUN log_plot

; Compile the procedure.

COMPILE, 'log_plot'

; Save the compiled procedure.

$ls log_plot*

log_plot.cpr      log_plot.pro

; The file log_plot.cpr is created. This file contains the compiled
; procedure.

DELPROC, 'log_plot'

; Delete the log_plot procedure that is currently in memory.

log_plot

; Run the compiled procedure log_plot.cpr.

EXIT

; Exit PV-WAVE, and return to the operating system prompt.

At the system prompt, enter the following:

% wave -r -nohome log_plot

This command runs the compiled procedure from the operating system prompt. The -r flag signifies "runtime" mode.

Example 2

This example demonstrates how several files from a single application can be compiled and saved in one file. This simple application creates a Command Tool widget and includes three separate callback routines.

Place the following code in a file called comtool.pro, and save the file in the current working directory:

Widget commands:

PRO ComTool

top=WwInit('example2', 'Examples', layout)
button=WwButtonBox(layout, 'Command', 'CbuttonCB')
status=WwSetValue(top, /Display)
WwLoop

END

Callback routines:

PRO CbuttonCB, wid, data

command = WwCommand(wid, 'CommandOK',  $
    'CommandDone', Position=[300,300],  $
    Title = 'Command Entry Window')

END
PRO CommandOK, wid, shell

value = WwGetValue(wid)
PRINT, value

END
PRO CommandDone, wid, shell

status = WwSetValue(shell, /Close)

END

Now start PV-WAVE and enter the following commands at the WAVE prompt:

.RUN comtool

; Compile the application.

COMPILE, 'ComTool', 'CbuttonCB', 'CommandOK', 'CommandDone',  $
    Filename = 'comtool'

; Save the compiled procedures in the file comtool.cpr.

$ls comtool*

comtool.cpr      comtool.pro

; The file comtool.cpr is created. This file contains the compiled
; procedures.

EXIT

At the system prompt, enter the following:

% wave -r comtool

This command runs the compiled comtool application from the operating system command line. Note that the filename must be the same as the main procedure in the file for the application to run successfully from the operating system prompt. The -r flag signifies "runtime" mode.

COMPILE Procedure

Usage

Input Parameters

Keywords

Discussion

Example 1

Example 2

See Also