gnuplot_open_fileT_gnuplot_open_fileGnuplotOpenFileGnuplotOpenFilegnuplot_open_file (算子)

名称

gnuplot_open_fileT_gnuplot_open_fileGnuplotOpenFileGnuplotOpenFilegnuplot_open_file — 打开 gnuplot 文件以可视化图像和控件值。

警告

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFilegnuplot_open_file 已过时，仅出于向后兼容性考虑而保留。

签名

gnuplot_open_file( : : FileName : GnuplotFileID)

描述

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFilegnuplot_open_file allows the output of images and control values in a format which can be later processed by gnuplot. The parameter FileNameFileNameFileNameFileNamefileNamefile_name determines the base-name of the files to be created by calls to gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImagegnuplot_plot_image。gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFilegnuplot_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_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImagegnuplot_plot_image (or control values plotted by gnuplot_plot_ctrlgnuplot_plot_ctrlGnuplotPlotCtrlGnuplotPlotCtrlGnuplotPlotCtrlgnuplot_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_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClosegnuplot_close has to be called in order to close all open files. The corresponding identifier for the gnuplot output stream is returned in GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileIDgnuplot_file_id。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。

参数

FileNameFileNameFileNameFileNamefileNamefile_name (输入控制) filename.write → (string)

Base name for control and data files.

File extension: .gp

GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileIDgnuplot_file_id (输出控制) gnuplot → (handle)

Identifier for the gnuplot output stream.

结果

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFilegnuplot_open_file 返回值 2 ( H_MSG_TRUE) if the control file could be opened.否则，将抛出异常。

可能的后继

gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImagegnuplot_plot_image, gnuplot_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClosegnuplot_close

替代

gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipeGnuplotOpenPipegnuplot_open_pipe

另见

gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipeGnuplotOpenPipegnuplot_open_pipe, gnuplot_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClosegnuplot_close, gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImagegnuplot_plot_image

模块

基础

算子