|
FileOpen macro command |
  
|
|
FileOpen macro command |
|
Macro commands may be used either in macros or by sending the commands to DPlot via dynamic data exchange (DDE). Some commands are valid only in macros (noted by Macros Only). Commands sent to DPlot via DDE must be enclosed by square brackets [ ]. Macro commands should not include the brackets.
Command parameters shown in the descriptions below are placeholders for the actual values. Command parameters are either numeric values or character strings; character string parameters are always bound by double quotation marks.
All indices into arrays are 1-based, e.g. Curve1=1 refers to the first curve in a plot.
A 0x prefix for numbers in the descriptions below indicates hexadecimal notation; e.g. 0x0010 = 16.
JR/Viewer indicates that the command is supported by DPlot Jr or DPlot Viewer.
JR/Viewer indicates that the command is NOT supported by DPlot Jr or DPlot Viewer.
[FileOpen("filename")] |
|
Opens and displays a file in a new or empty document window. If the file type is not a DPlot file, then the FileType command should be issued before the FileOpen command. Subsequent commands reference the document created by this command. The path to the file should either be absolute (as in "c:\datafiles\mydata.dat") or relative to the current directory. By default, the current directory is the My Documents\DPlot folder. The current directory can be changed with a Directory command. You can embed Windows' environment variables in filenames, delimited with percent (%) symbols. For example "%USERPROFILE%\My Documents\DPlot\test.csv" will be interpreted as "c:\Documents and Settings\<username>\My Documents\DPlot\test.csv" on most XP systems, and "c:\Users\<username>\My Documents\DPlot\test.csv" on Windows Vista.
The second form of this command is only useful for file import plugins that include the function plugin_readfileex. The interpretation of the options string is entirely up to the plugin and is passed unchanged to the plugin_readfileex function. Generally this options string is used to accept options for the plugin programmatically rather than forcing user input via a dialog box. Options for file import plugins distributed with DPlot are described below.
Bitmap to 3D
Options are comma-separated values. All entries are optional and are read in the order Scale,Black_Value,White_Value,Filter,Left,Top,Right,Bottom,Xlo,Ylo,Xhi,Yhi
where:
| Scale | Integer from 10 to 100. Controls how many columns and rows the surface plot will have. At 100, the number of data columns will be equal to the width of the selected part of the image; the number of data rows will be equal to the height. Default=100. |
| Black_Value | Z value mapped to color index 0 in the (possibly converted) 8-bit gray scale image. Default=0. |
| White_Value | Z value mapped to color index 255 in the image. Default=255. |
| Filter | For scales less than 100%, specifies the resampling filter to use on the image. 0=bilinear, 1=B-spline, 2=bicubic. Default=2. |
| Left,Top,Right,Bottom | Specifies the 0-based extents of the portion of the image to use, in pixels. 0,0 is the top left corner of the image. Default is to use entire image. |
| Xlo,Ylo,Xhi,Yhi | Maps Left,Bottom,Right,Top image pixels to X and Y values in the generated surface plot. Default is 0,0 to width-1,height-1. |
All entries are optional, but you must include all previous options. For example you cannot specify Filter without also specifying Scale,Black_Value, and White_Value. If at least one option is specified then the default options shown above are used for any omitted options.
AMO Transient Recorder Files
Options are comma-separated values.
Option, Start_Time, Stop_Time
where:
| Option | 0=read entire record. 1=read 1st preview block. 2=read 2nd preview block. 3=read 3rd preview block. 4=read full record between Start_Time and Stop_Time (seconds). Start_Time and Stop_Time are optional and are ignored for all but Option=4. |
Page url: http://www.dplot.com/help/index.htm?fileopencommand.htm