N


Intro       Symbols A B C D E F G H I J K L M N O P Q R S T U V W X Y Z       Index  
name name &optional new [Function]

Returns name or a new symbol based on name if new is t. Use name in place of symbolic names to insure that a new name is created each time the form is evaluated.

Example:

? (loop for n in '(a b c) collect (thread (name n) ()))
(#<THREAD: A> #<THREAD: B> #<THREAD: C>)

See Also:

Describing Music Algorithmically

 


note [Class]

An abstract class representing objects that produce sound.

Slots made available by note:

rhythm {number}
A time increment to the next event. Tine be expressed as milliseconds or seconds depending on the current clock mode.
time {number}
The current time (in seconds) of the event. time should be treated as a read only slot. The value is set by the system and reflects the most recent processing of the event.

See Also:

clm-note, CMN, csound-note, rest, m4c-note, midi-message, midi-note, music-kit-note

 


note [Item Type]

The symbolic note name of an entry in a musical scale. Scale entries have three different aspects: a note, or symbolic note name, a pitch, or floating point frequency, and a degree, or ordinal position.

Each of these reference types is supported by a function for converting to that type and a macro for creating item streams of that type.

See Also:

degree, note [Function], notes, pitch

 


note reference &optional scale [Function]

Returns the symbolic note name of reference in scale. Reference may be a note, degree, or pitch. If scale is omitted it defaults to *standard-scale*.

Example:

? (note 'a4)
A4

? (note 440.0)
A4

? (note 69)
A4

See Also:

degree, degrees, note [Item Type], notes, pitch, pitches, *standard-scale*

 


notes {reference}+ {option value}* [Macro]

Creates an item stream of symbolic note names. Each reference may be a note, degree, pitch or item stream.

notes implements the following option value pairs:

of {scale}
Sets the scale of the stream. Defaults to *standard-scale*.
An additional set of basic option valuepairs are available in all item stream macros. Others may be available based on the pattern type specified to the macro.

Example:

? (setf x (notes (notes c2 d) (notes c3 d) (notes c4 d) in heap))
#<HEAP-NOTE-STREAM 136100641>

? (read-items x)
(C4 D4 C3 D3 C2 D2)

See Also:

degree, degrees, Item Streams, note, pitch, pitches

 


numbers {option value}* [Macro]

Creates a stream of cyclic or random numbers.

numbers implements the following option value pairs:

in {pattern}
Sets the pattern type of the stream. Only cycle and random are implemented.
from {number | stream}
Sets the initial value for number generation, defaults to 0.
to {number | stream}
Sets the inclusive upper bound for number generation.
below {number | stream}
Sets the exclusive upper bound for number generation.
downto {number | stream}
Sets the inclusive lower bound for number generation.
above {number | stream}
Sets the exclusive lower bound for number generation.
by {number | stream}
Sets the increment amount, defaults to 1.
An additional set of basic option valuepairs are available in all item stream macros. Others may be available based on the pattern type specified to the macro.

Example:

? (setf x (numbers from 1 below (items 5 10) in random))
#<RANDOM-NUMBER-STREAM 136100641>

? (read-items x)
(1 1 1 2)

? (read-items x)
(3 8 1 6 4 8 1 8 9)

See Also:

Item Streams