gnuplot_open_fileT_gnuplot_open_fileGnuplotOpenFileGnuplotOpenFile (Operator)

Name

gnuplot_open_fileT_gnuplot_open_fileGnuplotOpenFileGnuplotOpenFile — Öffnen einer gnuplot-Datei für Bilder und Steuerparameter.

Warnung

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFile ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt.

Signatur

gnuplot_open_file( : : FileName : GnuplotFileID)

Herror T_gnuplot_open_file(const Htuple FileName, Htuple* GnuplotFileID)

void GnuplotOpenFile(const HTuple& FileName, HTuple* GnuplotFileID)

void HGnuplot::GnuplotOpenFile(const HString& FileName)

void HGnuplot::GnuplotOpenFile(const char* FileName)

void HGnuplot::GnuplotOpenFile(const wchar_t* FileName)   (Nur Windows)

static void HOperatorSet.GnuplotOpenFile(HTuple fileName, out HTuple gnuplotFileID)

void HGnuplot.GnuplotOpenFile(string fileName)

Beschreibung

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFile erlaubt die Ausgabe von Bildern und Steuerparametern in einem Format, das später von gnuplot verarbeitet werden kann. Der Parameter FileNameFileNameFileNameFileNamefileName gibt den Basisnamen für die mit gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImage zu erstellenden Plots an. gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFile erzeugt daraus eine Steuerdatei mit dem Namen <Filename>.gp, in der die einzelnen Plot-Befehle abgelegt werden. Für jedes ausgegebene Bild (oder Steuereparamater) wird dann von gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImage eine Datei angelegt, die die eigentlichen Daten enthält, und den Namen Filename.dat.<Zahl> erhält, wobei Zahl die Nummer des Plots in der aktuellen Folge ist. Die erzeugte Steuerdatei kann später vom Benutzer an die eigenen Bedürfnisse angepasst werden. Nach Ausgabe des letzten Plots muss gnuplot_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClose ausgeführt werden, um die offenen Dateien zu schließen. Der zugehörige Identifikator für den gnuplot-Ausgabestrom wird in GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID zurückgeliefert.

Ausführungsinformationen

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write HTupleHTupleHtuple (string) (string) (HString) (char*)

Basisname für die Steuer- und Ausgabedateien.

Dateiendung: .gp

GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID (output_control)  gnuplot HGnuplot, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Identifikator für den gnuplot-Ausgabestrom.

Ergebnis

gnuplot_open_filegnuplot_open_fileGnuplotOpenFileGnuplotOpenFileGnuplotOpenFile liefert den Wert 2 (H_MSG_TRUE), falls die Steuerdatei geöffnet werden konnte. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Nachfolger

gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImage, gnuplot_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClose

Alternativen

gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipeGnuplotOpenPipe

Siehe auch

gnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipeGnuplotOpenPipe, gnuplot_closegnuplot_closeGnuplotCloseGnuplotCloseGnuplotClose, gnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImageGnuplotPlotImage

Modul

Foundation