gnuplot_open_pipe ( : : : GnuplotFileID )

Open a pipe to a gnuplot process for visualization of images and control values.

gnuplot_open_pipe opens a pipe to a gnuplot sub-process with which subsequently images can be visualized as 3D-plots (gnuplot_plot_image) or control values can be visualized as 2D-plots (gnuplot_plot_ctrl). The sub-process must be terminated after displaying the last plot by calling gnuplot_close. The corresponding identifier for the gnuplot output stream is returned in GnuplotFileID.


Attention

gnuplot_open_pipe is only implemented for Unix because gnuplot for Windows (wgnuplot) cannot be controlled by an external process.


Parameters

GnuplotFileID (output_control)
gnuplot_id -> integer
Identifier for the gnuplot output stream.


Result

gnuplot_open_pipe returns the value 2 (H_MSG_TRUE) if the sub-process could be created. Otherwise, an exception handling is raised.


Parallelization Information

gnuplot_open_pipe is processed completely exclusively without parallelization.


Possible Successors

gnuplot_plot_image, gnuplot_plot_ctrl, gnuplot_close


Alternatives

gnuplot_open_file


Module

System



Copyright © 1996-2005 MVTec Software GmbH