gnuplot_open_file
— Öffnen einer gnuplot-Datei für Bilder und Steuerparameter.
gnuplot_open_file
ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt.
gnuplot_open_file( : : FileName : GnuplotFileID)
gnuplot_open_file
erlaubt die Ausgabe von Bildern und
Steuerparametern in einem Format, das später von gnuplot
verarbeitet werden kann. Der Parameter FileName
gibt den
Basisnamen für die mit gnuplot_plot_image
zu erstellenden
Plots an. gnuplot_open_file
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_image
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_close
ausgeführt werden, um die offenen Dateien
zu schließen. Der zugehörige Identifikator für den
gnuplot-Ausgabestrom wird in GnuplotFileID
zurückgeliefert.
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.
FileName
(input_control) filename.write →
(string)
Basisname für die Steuer- und Ausgabedateien.
Dateiendung: .gp
GnuplotFileID
(output_control) gnuplot →
(handle)
Identifikator für den gnuplot-Ausgabestrom.
gnuplot_open_file
liefert den Wert 2 (H_MSG_TRUE), falls die
Steuerdatei geöffnet werden konnte. Ansonsten wird eine
Fehlerbehandlung durchgeführt.
gnuplot_plot_image
,
gnuplot_close
gnuplot_open_pipe
,
gnuplot_close
,
gnuplot_plot_image
Foundation