gnuplot_open_file ( : : Filename : )

Open a gnuplot file for visualization of images and control values.

gnuplot_open_file allows the output of images and control values in a format which can be later processed by gnuplot. The parameter Filename determines the base-name of the files to be created by calls to gnuplot_plot. gnuplot_open_file generates a gnuplot control file with the name <Filename>.gp, in which the respective plot commands are written. Each image plotted by gnuplot_plot (or control values plotted by gnuplot_plot_ctrl) creates a data file with the name Filename.dat.<Number>, where Number is the number of the plot in the current sequence. The generated control file can later be edited to create the desired effect. After the last plot gnuplot_close has to be called in order to close all open files.


Attention

There can only be one gnuplot output-stream open at any given time. If gnuplot_open_file when a gnuplot output stream is open, the old output stream is closed first.


Parameters

Filename (input_control)
filename.named -> string
Base name for control and data files.


Result

gnuplot_open_file returns the value TRUE if the control file could be opened. Otherwise, an exception is raised.


Possible Successors

gnuplot_plot, gnuplot_close


Alternatives

gnuplot_open_pipe


See also

gnuplot_open_pipe, gnuplot_close, gnuplot_plot



Copyright © 1996-1997 MVTec Software GmbH