Nyquist Globals
There are many global variables in Nyquist. A convention in Lisp is to place asterisks (*) around global variables, e.g. *table*
. This is only a convention, and the asterisks are just like any other letter as far as variable names are concerned. Here are some globals users should know about:
-
*table*
- Default table used by
osc
and other oscillators.
*A4-Hertz*
- Frequency of A4 in Hertz.. Note: you must call
(set-pitch-names)
to recompute pitches after changing *A4-Hertz*
.
*breakenable*
- Controls whether XLisp enters a break loop when an error is encountered.
*control-srate*
- Part of the environment, establishes the control sample rate. See Section ``The Environment'' for details.
*default-sf-bits*
- The default bits-per-sample for sound files. Typically 16.
*default-sf-dir*
- The default sound file directory. Unless you give a full path for a file, audio files are assumed to be in this directory.
*default-sf-format*
- The default sound file format. When you write a file, this will be the default format: AIFF for Mac and most Unix systems, NeXT for NeXT systems, and WAV for Win32.
*default-sf-srate*
- The default sample rate for sound files. Typically 44100.0, but often set to 22050.0 for speed in non-critical tasks.
*default-control-srate*
- Default value for
*control-srate*
. This value is restored when you execute (top)
to pop out of a debugging session. Change it by calling (set-control-srate value)
.
*default-sound-srate*
- Default value for
*sound-srate*
. This value is restored when you execute (top)
to pop out of a debugging session. Change it by calling (set-sound-srate value)
.
*file-separator*
- The character that separates directories in a path, e.g. ``
/
'' for Unix, ``:
'' for Mac, and ``\
'' for Win32. This is normally set in system.lsp
.
*rslt*
- When a function returns more than one value,
*rslt*
is set to a list of the ``extra'' values. This provides a make-shift version of the multiple-value-return
facility in Common Lisp.
*sound-srate*
- Part of the environment, establishes the audio sample rate. See Section ``The Environment'' for details.
*soundenable*
- Controls whether writes to a sound file will also be played as audio. Set this variable by calling
(sound-on)
or (sound-off)
.
*tracenable*
- Controls whether XLisp prints a backtrace when an error is encountered.
Environment variables
- See ``The Environment'' for definitions of variables used in the environment for behaviors. In general, you should never set or access these variables directly.
Various constants
- See ``Predefined Constants'' for definitions of predefined constants for loudness, duration, and pitch.
Previous Section | Next Section | Table of Contents | Index | Title Page