Jackson Labs PHASE STATION 53100A, User Manual, Page: 154 / 225

PhaseStation 53100A User’s Manual V1.04 25-Apr-2022 154
to
path
that contains the specified file. Unlike
path
, the
subdir
folder will be created
automatically if it does not already exist.
This function can be used to poll for signals from external or host processes that create
empty files with specific names. See the
EventTimer()
handler in
53100A_command_line_example.js
for a detailed usage example.
FileImageURI()
Returns a .GIF image of the current TimeLab display in the form of an HTML data URI.
FileLoad(String path, [String subdir,] String filename)
Reads the specified .TIM file into memory and allocates a plot for it, just as if the plot
had been created by calling
AcqStartAcquisition
(). On success, the fully-qualified pathname
of the loaded file is returned.
Typically,
DisplayRefresh()
should be called after
FileLoad()
in order to display the newly-
loaded file and make the measurement data available to other JavaScript API functions.
An exception is thrown if the file could not be loaded or if the script is already bound to
an existing plot.
ScriptUnbind()
must be called prior to
FileLoad()
in this case.
By default, if
path
is empty, the user’s Documents folder is treated as the path. This path
must already exist. The
subdir
parameter is optional; it represents a subdirectory relative
to
path
that contains the specified file. Unlike
path
, the
subdir
folder will be created
automatically if it does not already exist.
FileNumLoadedPlots()
Returns the number of currently-loaded plots, from 0 to 9.
FileNumUnsavedPlots()
Returns the number of currently-loaded plots, from 0 to 9, that have not been saved
since being acquired or modified.
FileSave(String path, [String subdir,] String filename)
Based on the (case-insensitive) suffix of
filename
,
FileSave()
saves either a screen image in
.TGA, .GIF, .BMP, .PCX, or .PNG format, or a .TIM file representing the measurement
currently associated with the script.
By default, if
path
is empty, the user’s Documents folder is treated as the destination
path. This path must already exist. The
subdir
parameter is optional; it represents a
subdirectory relative to
path
in which the destination file will be saved. Unlike
path
, the
subdir
folder will be created automatically if it does not already exist.