First_Run Macro

The First_Run macro is included with Daqarta. (See Macro Examples and Mini-Apps for the full list.)

This macro has an ID of '!', which means it will run automatically every time Daqarta starts up. It begins by testing Var0, and skips to the end if it is not zero. Otherwise it waits one second, then shows a long message giving startup tips, with a list of included macros and their hot-keys.

The last line of the message asks "Show this message on next start?". If WaitMsgAns=7 it means the user has clicked "No" (or hit the 'N' key), in which case Var0 is set to 1 so the initial test will fail on the next start. (User Variables Var0-9 and VarA-Z are retained across Daqarta sessions.)

Whether you answer "Yes" or "No" you can still see the message at any time by hitting F8 followed by !, or by opening the Macro Dialog (CTRL+F8) and double-clicking on the !..First_Run entry. You can then change your answer for future Daqarta starts.

Following is the complete First_Run macro listing. The outer IF (on the first line) passes unless (the ! here means "not") Var0 is 1 (previous "No" answer) and (&&) the macro is being auto-run (MacroDlg?A is 1). (See the Logical Operators subtopic under Macro Expressions and Operators.)

If it is being auto-run, a 1-second delay is added before the message is shown. Otherwise, for manual activation, the message is shown immediately.

Note that the WaitMsg spans multiple lines; the line breaks will appear as shown in the displayed message. (That's why the extra lines are not indented from the outer IF statement for clarity... the indents would mess up the message layout.)

;<Help=H4915
IF.!(Var0 && MacroDlg?A)=1
    IF.MacroDlg?A=1
        WaitSecs=1
    ENDIF.
    WaitMsgType=Y2
    WaitMsgTitle="First Run - Daqarta 11.7.0"
    WaitMsg="Right-click any control for Context Help.

Thin buttons beneath toolbar items
open control dialogs.

CHECK FOR UPDATES:
 Help Menu - Check for Updates (manual)
 Edit - Start Preferences - Auto-Update Check

SHORTCUTS:
 F9   Opens output volume sliders.

 F8, then ID-key for mini-apps and macros:
  A   Auto_Recorder (Sound-Activated)
  a   Audible Phase Demonstration
  B   Beats Demo - Monaural/Binaural
  C   Channel Difference (A - B)
  D   DaqMusiq
  E   Engine Crank and Cam Simulator
  F   FFT Filter Demo
  f   Missing Fundamental
  G   BMP Image to WAV Sound File
  g   WAV Sound to Spectrogram Image
  H   HMS Timer / Stopwatch / Alarm
  I   IMD Meter
  L   Lissajous (X-Y) display
  M   Multiple Meters
  m   Music_from_Anything
  N   File Navigator
  O   DaquinOscope
  P   Phase Meter
  Q   EQuation-to-Curve
  R   Chart Recorder
  r   DC Chart Recorder
  S   Phantom Signals
  T   THD Meter (t = low frequency version)
  U   Pulse Meter
  W   WAV Stereo-to-Mono File Converter
  w   WAV Convert to 16-bit
  Z   LCR Meter with ESR, DF, and Q

Show this message on next start?"
    IF.WaitMsgAns=7
        Var0=1
    ELSE.
        Var0=0
    ENDIF.
ENDIF.

See also Macro Examples and Mini-Apps