Data AcQuisition And Real-Time AnalysisScope - Spectrum - Spectrogram - Signal Generator
Software for Windows
Science with your Sound Card!
Contact us about
Macro Read-Only Variables
Read-only variables can only be read. (Attempts to set them are ignored.) Generally, that means you can only use them like normal or string variables on the right side of an expression, as in A=DeltY or Msg=Freq.
However, you can also use them on the left side of an IF test, as in IF.Frames=>100.
Similarly, you can use them on the left side of a WHILE statement, as in WHILE.Volts=<1.000.
The following is a list of read-only variables:
CursY, CursY?, CursDotY, CursDotY?, UnitX, UnitY DeltX, DeltY WinVer Frames Freq, Total SPL Volts GenMode SyncMode DiskSpace Timer Time FileName, FileName? FileInfo?B, FileInfo?F, FileInfo?T - file format FileInfo?C, FileInfo?M - file channels FileInfo?S - file total samples RangeDlg?, GainDlg? Atten_dB?, Atten_G? Range? UserFactor?, UserSPL? FcountDlg?, SPLdlg?, VoltDlg?, MacroDlg? Ch? ColorNum? Key? Posn? Buf0? to Buf7? Mtr0?, Mtr1?, Mtr2?, Mtr3? Ctrls?, Ctrl0?, Ctrl1?, Ctrl2?, Ctrl3? MIDIrec?
The variables ending in '?' require a single query character immediately following, which specifies one of a subset of possible values to be read. For example, Posn?X holds the current X position of the mouse cursor, while Posn?Y holds the Y position. Note that some of these query-type variables (CursY, CursDotY, RangeDlg, GainDlg, UserFactor, UserSPL, FcountDlg, SPLdlg, VoltDlg, MacroDlg, Ch, Mtr0-3, and Ctrl0-3) are also used as ordinary controls without the '?'.
Read-only variables can be used in String Expressions for such things as Notes, Custom Meters, message text (WaitMsg and Msg), and Log File macros. Note, however, that DeltX, Freq, Volts, and SPL have a default format that is the same as that used for the normal Daqarta display.
For example, if the Voltmeter reads "123.456 mV" then Msg=Volts will display that string exactly. But if you use any of the numeric formatting options discussed in String Variables and Expressions, that takes priority. Only numeric data is shown, and the "mV" is rolled into the value. Msg=Volts(0.5) would thus show "0.12345".
See also Macro Overview
Questions? Comments? Contact us!We respond to ALL inquiries, typically within 24 hrs.
Over 35 Years of Innovative Instrumentation
© Copyright 2007 - 2021 by Interstellar Research
All rights reserved