gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipe (Operator)

Name

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

Signature

gnuplot_open_pipe( : : : GnuplotFileID)

Description

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

gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipe is only implemented for Unix-like systems because gnuplot for Windows (wgnuplot) cannot be controlled by an external process.

Parallelization

Multithreading type: exclusive (runs in parallel only with independent operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID (output_control) gnuplot_id → (integer)

Identifier for the gnuplot output stream.

Result

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

Possible Successors

gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImage, gnuplot_plot_ctrlgnuplot_plot_ctrlGnuplotPlotCtrlgnuplot_plot_ctrlGnuplotPlotCtrlGnuplotPlotCtrl, gnuplot_closegnuplot_closeGnuplotClosegnuplot_closeGnuplotCloseGnuplotClose

Alternatives

gnuplot_open_filegnuplot_open_fileGnuplotOpenFilegnuplot_open_fileGnuplotOpenFileGnuplotOpenFile

Module

Foundation

Operators