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_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.
|
FileName (input_control) |
filename -> HTuple.char * |
| Base name for control and data files. | |
|
GnuplotFileID (output_control) |
gnuplot_id -> long * |
| Identifier for the gnuplot output stream. | |
::gnuplot_open_file returns the value H_MSG_TRUE if the control file could be opened. Otherwise, an exception handling is raised.
::gnuplot_plot_image, ::gnuplot_close
::gnuplot_open_pipe, ::gnuplot_close, ::gnuplot_plot_image
System
