Data AcQuisition And Real-Time AnalysisScope - Spectrum - Spectrogram - Signal Generator
Software for Windows
Science with your Sound Card!
Contact us about
Macros: Notes, NotesDlg
The Notes edit window is at the bottom of the Daqarta window. You can enter notes here at any time. They will be saved with .DQA files, and will appear here when you later open the file for viewing.
Notes can be up to 2047 characters long, including Enter keys for new lines. You can use the scroll bars to see lower lines. The Font button allows you to select the font you prefer.
You can use CTRL+Tab to move to the next tab stop. (The Tab key alone will exit the Notes field and move to the next item on the screen.)
You can use CTRL+ALT+D to enter the current date, or CTRL+ALT+T to enter the current time. The Edit Date/Time Preferences menu allows you to specify the date or time format, and whether UTC time or local time will be used. (You can also enter date or time via macros... see the Macro Notes below.)
Since most Daqarta edit controls are for entering values, you can conclude an entry in them just by hitting Enter. That won't work here, since an Enter is used to start a new line. Instead, you can use the Tab key to move to the next control, or just click on another control. Alternatively, the little Notes button next to the edit window changes to 'OK' as soon as you start an entry, and you can click that to end an entry (which will change it back to 'Notes').
If you click the Notes button instead of just starting to type in the Notes window, it will open a larger copy of the Notes window in its own dialog, which can be positioned as desired. This is especially useful with 640x480 screens, which will cut off most of the normal Notes window. It may also be useful with higher screen resolutions, if you have multiple windows open. You can conclude entry in this pop-up Notes dialog by clicking on its OK button, or the OK button next to the main Notes.
You can also toggle the Notes dialog open or closed via ALT+SHIFT+N.
NotesDlg=1 opens the Notes dialog, NotesDlg=0 closes it, and NotesDlg=x toggles between open and closed. You do not need to open the dialog to enter Notes text via macro command.
Notes="Notes Test Message" replaces the current Notes with the text enclosed in quotes.
Notes can make use of string variables and expressions. It can also include itself to allow appending and prepending:
Notes=Notes + " with extension." will append the quoted text to the current Notes.
Notes="This is a " + Notes will prepend the quoted text at the start of the current Notes.
Thus, if you use the above examples in the order presented, the final Notes will read "This is a Notes Test Message with extension."
Multiple lines may be included in the command text, surrounded by a single pair of quotes, and the lines will likewise appear in the resulting Notes. For example:
Notes="This is Line 1. This is Line 2."
will result in:
This is Line 1. This is Line 2.
Sometimes it may be more convenient to use a multi-item string with the Newline command (n) inserted where needed. The above could be accomplished with:
Notes="This is Line 1." +n + "This is Line 2."
You can use string variables to insert many different values in a multi-item string line, such as time, date, cursor readouts, Labels, Fields, Macro Variables, Averager Total Frames Counter, or Frequency Counter, Sound Level Meter, or Voltmeter readouts. You can also use the p formatting command to set specific columns for data. For example,
Notes=Notes +n + Freq +p20 +t
will append a new line showing the Frequency Counter readout value followed by the local time starting at column 20. See String Variables and Expressions for details.
There are also special macro commands to copy the Notes contents to macro array buffers Buf0-Buf7. For example, Buf0="<Notes" copies a list of numerical values from Notes to Buf0, filling as many Buf0 elements as there are values.
Alternatively, Buf0="<NoteS" (note uppercase 'S') copies a string of characters from Notes into Buf0, one character per element, filling as many elements as there are characters.
There are also variants to copy from Notes that were saved as part of a .DQA file, either single-screen or a longer DDisk file, when that file is later opened for use. This is true even if the file is loaded into the Generator as an Arb or Play file, such that its Notes are not shown normally.
In addition, Buf0="<NotesR" performs a "Raw bulk" copy of everything in the Notes area, including control characters, stored contiguously at 8 per array element and accessible as String Array elements. Conversely, Buf0="<uN" can be used to "upload" the array back to Notes.
Both of these commands can be followed by a digit from 0-3, such as Buf0="<NotesR1" or Buf0="<uN". The digit designates one of 4 separate 256-element array blocks, each of which can hold the contents of an entire 2047-character Notes area.
BLmN="<Notes" copies a list of values from Notes to macro array BufN, one value per element.
BLmN="<NoteS" copies a Notes string to macro array BufN as 8-bit characters, one per element.
There is no MIDI script command to perform a "Raw bulk" copy, nor to upload back to Notes.
Questions? Comments? Contact us!We respond to ALL inquiries, typically within 24 hrs.
Over 30 Years of Innovative Instrumentation
© Copyright 2007 - 2017 by Interstellar Research
All rights reserved