gnuplot_open_file — Open a gnuplot file for visualization of images and control values.
gnuplot_open_file is obsolete and is only provided for reasons of backward compatibility.
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_image. 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_image (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. The corresponding identifier for the gnuplot output stream is returned in GnuplotFileID.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Base name for control and data files.
File extension: .gp
Identifier for the gnuplot output stream.
gnuplot_open_file returns the value 2 (H_MSG_TRUE) if the control file could be opened. Otherwise, an exception is raised.
gnuplot_open_pipe, gnuplot_close, gnuplot_plot_image