Herror ::gnuplot_open_pipe (
    long *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 -> long *
Identifier for the gnuplot output stream.


Result

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


Possible Successors

::gnuplot_plot_image, ::gnuplot_plot_ctrl, ::gnuplot_close


Alternatives

::gnuplot_open_file


Module

System



Copyright © 1996-2002 MVTec Software GmbH