iForth HTML Help File

"|" "almost-bar" IMM MANX
( -- )

Usage: "|" ... This word is almost equal to | , but does not compile synchronisation code. Typical use is when a bar only contains a DUPLICATES DUPLICATE REDO BIS or ENCORE statement. You do then not want this "meta bar" itself to be counted in the display set up by .bars? . The correct useage of this word is also very important when a score is prepared for a network of metallophones. In this case repetitions may happen at different places in the parts, resulting in rendez-vous point not expected by the other players.
See also: | L: DUPLICATES DUPLICATE REDO .. BIS

& MANX
( -- )

Separates parts of a parallel construct. For example, if one voice plays /4 d1 g1 and the other one /8 rest d2 rest g2 , then we say:

	{{ /4 d1 g1  &  /8 rest d2 rest g2 }}

Note: This construct can not be nested.
See also: {{ }}

(IDENT) IMMEDIATE MANX
Allows a definition to access its own name.

The dictionary entry address (dea) of the definition is compiled as a literal. This is definitely non-standard. On systems that don't have the words @LATEST , LATEST or LAST you may consider compiling the name of the definition as a string, using C" . This works just as well, is standard, wastes space and is definitely ugly.

+ART MANX
( n -- )

Increase (relatively) the articulation of the current PART by the factor n (positive or negative!).
See also: +VOL +TEMPO

+TEMPO MANX
( mul div -- )

Sets the tempo to be mul/div times as fast.

		 98 100 +TEMPO  ( play 2% slower)
		102 100 +TEMPO  ( play 2% faster)

The command can be issued anywhere, but the Conductor PART is the safest place to put it. When used in the Conductor PART , skip to the next place to adjust the timing of with rest and/or WHOLE rest

	2 /4 MEASURE  200 MM  /4 rest  8 10 +TEMPO /4 rest ||

+VOL MANX
( mul div -- )

Increase (relatively) the volume of the current PART by the factor mul/div.

-aluminium MANX
( -- )

Marker for the words compiled from ALUMINIUM.FRT . This file contains a driver for the aluminium metallophone (which has percussion).

-brass MANX
( -- )

Marker for the words compiled from BRASS.FRT . This file contains a driver for the brass metallophone (no percussion).

-defs MANX
( -- )

Marker for the words compiled from DEFS.FRT . This file contains utilities, global data and execution vectors.

-midirw MANX
( -- )

Marker for the words compiled from MIDIRW.FRT . This file contains all MIDI utilities.

-pcspeaker MANX
( -- )

Marker for the words compiled from PCSPEAKER.FRT . This file contains a driver for the PC-speaker.

-relays MANX
( -- )

Marker for the words compiled from RELAYS.FRT . This file contains a multiplexer for two metallophones.

-synth MANX
( -- )

Marker for the words compiled from SYNTH.FRT . This file contains a driver for a General MIDI synthesizer.

-tie MANX
( -- )

Releases a tied note. Example: /4 tie- a2 ... -tie a2 A tied note is kept in its sustain phase (if the instrument is able to do this) for the indicated period. This word can be used just before, or inside a chord:

		-tie { a2 f2 g3 } 
	or	{ -tie a2 f2 g3 }   
	or	{ARP a2 f2 -tie g3 }

When used before a chord, -tie is applied to all elements of the chord. Used inside a chord, -tie applies to all notes following in the input stream, until } tie- or -tie- is encountered. Outside a chord -tie only works on the immediately following note.
See also: -tie- tie-

-tie- MANX
( -- )

Can be used as a visual reminder that the following note is still being tied. Does not actually do anything.

	| 4 /4 measure  /1 tie- a2  | /1 -tie- a2  | /1 -tie a2 ||

This word can be used just before, or inside a chord:

		-tie- { a2 f2 g3 } 
	or	{ -tie- a2 f2 g3 }   
	or	{ARP a2 f2 -tie- g3 }

When used before a chord, -tie- is applied to all elements of the chord. Used inside a chord, -tie- applies to all notes following in the input stream, until } tie- or -tie is encountered. Outside a chord -tie- only works on the immediately following note.
See also: tie- -tie

.. MANX
( -- )

Used to indicate the range of bars to be played by BIS .

	13 .. 26 BIS  ( play bars 13 upto 26 inclusive)

See also: VOL

WHOLE MANX
( -- )

Sets the note length to the length of one complete bar.
See also: MEASURE

WRITE-MIDI? MANX
( "name" -- bool )

Reads the file name.SCO, converts the text in it to a stream of MIDI events and writes these to the file name.MID . The MIDI header information of these files is wrong when bool is FALSE . At least one extra execution of WRITE-MIDI? corrects this (returns TRUE ).

[--] MANX
( -- )

The next note or 'hit' is played much more Legato . Multiple invocation allowed.

	/4 c2 [--] e2 g2     ( g2 is very short)

[-] MANX
( -- )

The next note or 'hit' is played more Legato . Multiple invocation allowed.

		/4 c2 [-] e2 g2     ( g2 is short)
		/8 [-] plok plok2   ( plok2 is short)

[..] MANX
( -- )

The next note or 'hit' is played much more Staccatissimo . Multiple invocation allowed.

	/4 c2 [..] e2 g2    ( e2 is much shorter)

[.] MANX
( -- )

The next note or 'hit' is played more Staccatissimo. Multiple invocation allowed.

		/4 c2 [.] e2 g2    ( e2 is short)
		/8 [.] plok plok2  ( plok is short)

[>>] MANX
( -- )

Extra emphasis on the next note or 'hit'. Multiple invocation allowed.

	/4 c1 [>>] e1 c1 ( e1 is MUCH louder)

[>] MANX
( -- )

Emphasizes the next note or 'hit'. Multiple invocation allowed.

		/4 c2 [>] e2 g2     ( e2 is louder)
		/4 c1 [>] [>] e1 c1 ( e1 is MUCH louder)
		/8 [>] plok plok2   ( plok is loudest)

[v] MANX
( -- )

De-emphasizes the next note or 'hit'. Multiple invocation allowed.

		/4 c2 [v] e2 g2     ( e2 is piano)
		/4 c1 [v] [v] e1 c1 ( e1 is very silent)
		/8 [v] plok plok2   ( plok2 is loudest)

[vv] MANX
( -- )

Extra de-emphasis on the next note or 'hit'. Multiple invocation allowed.

	/4 c1 [vv] e1 c1 ( e1 is very silent)

\ART MANX
( -- )

Save current articulation on a stack.
See also: /ART

\Fortissimo MANX
( -- )

Also: ..\Pianissimo etc. Set a loudness for the following word only.

		c3 \Fortissimo des2  gis3
		c3 \Fortissimo theme  gis3

\L0 MANX
( -- )

Also: \L1..\L8. Set an articulation for the following word only.

		c3 \L3 des2   gis3
		c3 \L3 theme  gis3

\LONG MANX
( -- )

Next note is played 10% longer than actually notated.
See also: \SHORT

\SHORT MANX
( -- )

Next note is played 10% shorter than actually notated.
See also: \LONG

\TEMP MANX
( -- )

Save current tempo on a stack.
See also: /TEMP

\VOL MANX
( -- )

Save current loudness on a stack.
See also: /VOL

\yyy MANX
( u -- )

MANX variable note lengths are shown in the following table.

	3 \12  ( set length to three twelfths)

	\1	\2	\3	\4	\6	\8	\9	\12
	\16	\24	\32	\48	\64	\128	\192	\384
	\480	\960	\2304

aluminium? MANX
( -- bool )

Set to TRUE when the piece of sound hardware you actually have available is a 37-note (aluminium) metallophone with 3 percussion instruments. Every sound output is channelled to this device.

bar-lock? MANX

If this value is set to TRUE , the bars of different PARTs are strictly time-locked. When this is not wanted ('human feel' or when the time signature differs) bar-lock? should be set to FALSE . The default (bar-lock? is true) makes it very easy to see that a *.SCO still is buggy: during a BUILD-MIDI messages are printed that inform you that very large (more than 10 ticks) adjustments have been made to certain bars.

brass? MANX
( -- bool )

Set to TRUE when the piece of sound hardware you actually have available is a 37-note (brass) metallophone with no percussion. Every sound output is channelled to this device.

channeltouch MANX
( u -- )

Set the MIDI channel aftertouch for the current channel to u. See midirw.frt

chorus MANX
( u -- )

Set the chorus effect for the current channel to u. See midirw.frt

com# MANX

This value contains the number of the serial port used to SYNC the available instruments. As com2 is used for the mouse on many systems, it is advised to set 1 TO com# . A serial port is not needed when the number of instruments is less than 3 (it is possible to have one computer control up to two devices).
See also: ENSEMBLE SOLO

devoffs MANX
( ?? -- ?? )

Impersonates devoffs1 or devoffs2 , depending on the active track.

devoffs1 MANX
( ?? -- ?? )

This system value controls the offset between the note asked for (by MANX) and the note that really gets played on the brass metallophone.

devoffs2 MANX
( ?? -- ?? )

This system value controls the offset between the note asked for (by MANX) and the note that really gets played on the aluminium metallophone.

drivermax#n MANX
( -- u )

The number of notes that can be played simultaneously by the current driver. For the PC-speaker this is 1, for a MIDI synthesizer at least 28, for the metallophones it is 37.

env-attack MANX
( n -- )

Set the relative filter and amplitude envelope attack rate on the current channel. Allowable range: 0 .. 100 See midirw.frt

env-decay MANX
( n -- )

Set the relative filter and amplitude envelope decay rate on the current channel. Allowable range: 0 .. 100 See midirw.frt

env-release MANX
( n -- )

Set the relative filter and amplitude envelope release rate on the current channel. Allowable range: 0 .. 100 See midirw.frt

force-metallo? MANX

When force-metallo? is set to TRUE , the articulation changes to L0 and stays that way, even when L1 .. L8 , Legato , Staccatissimo etcetera are executed. The command is active when compiling .SCO files for use with percussion instruments. It has effect also when directly sending keyboard data to an attached metallophone. Note however that nothing happens when replaying binary data.

guitar? MANX
( -- bool )

Set to TRUE when the piece of sound hardware you actually have available is a 1-note mechanical guitar without percussion. Every sound output is channelled to this device.

kb-transpose MANX
( n -- )

When recording user input ( RECORD-MIDI ) the contents of this value (say n) are used to transpose the input over n semitones.

max#n MANX
( -- u )

The maximum number of simultaneous notes the hardware can play.

octave MANX
( n -- ) | ( -- n )

Shift all instruments (except percussion) up or down over n octaves. This value can be modified by the user.

pan MANX
( u -- )

Place the current channel at position u in the stereo sound field. The value 0 corresponds to extreme left, 100 to extreme right. See midirw.frt

pc-speaker? MANX
( -- bool )

Set to TRUE when the piece of sound hardware you actually have available is a (PC) speaker. Every sound output is channelled to this device.

pitchbend MANX
( u -- )

Set the MIDI pitchbend for the current channel to u. See midirw.frt

polytouch MANX
( u -- )

Set the MIDI polyphonic aftertouch for the current channel to u. See midirw.frt

portamento MANX
( bool -- )

When TRUE , switch on the MIDI portamento effect for the current channel. See midirw.frt
See also: portatime

portatime MANX
( u -- )

Set the MIDI portamento time for the current channel to u. Has an audible effect only after executing TRUE portamento . See midirw.frt, portamento

replay-speed MANX
( ?? -- ?? )

Every word that reads data from a MIDI-file will adjust the replay speed of the events according to the formula: replay_speed == stored_speed replay-speed */ So 90 100 TO replay-speed plays a MIDI-file 10% slower than its maker intended.

reprogram MANX
( u -- )

Switch to synthesizer patch u . The GM standard defines the possible u-values. MANX allows symbolic names to be used, like Acoustic-Grand-Piano or Orchestral-Harp .

rest MANX
( -- )

A rest. A rest has a length, but makes no sound (it is mute).

reverb MANX
( u -- )

Set the reverberation effect for the current channel to u. See midirw.frt

sostenuto MANX
( bool -- )

When TRUE , switch on the MIDI sostenuto effect for the current channel. See midirw.frt

sustain MANX
( bool -- )

When TRUE , switch on the MIDI sustain effect for the current channel. See midirw.frt

synth? MANX
( -- bool )

Set to TRUE when the piece of sound hardware you actually have available is a General MIDI synthesizer with a full set of percussion instruments. Every sound output is channelled to this device.

tie- MANX
( -- )

Ties a note. Example: /4 tie- a2 ... -tie a2 A tied note is kept in its sustain phase (if the instrument is able to do this) until -tie for the same note is encountered. This word can be used just before, or inside a chord:

		tie- { a2 f2 g3 } 
	or	{ARP tie- a2 f2 g3 }   
	or	{ a2 f2 tie- g3 }

When used before a chord, tie- is applied to all elements of the chord. Used inside a chord, tie- applies to all notes following in the input stream, until } -tie or -tie- is encountered. Outside a chord tie- only works on the immediately following note.
See also: -tie -tie-

transpose MANX
( n -- ) | ( -- n )

Shift all instruments (except percussion) up or down over n semitones. This value can be modified by the user.

tremolo MANX
( bool -- )

When TRUE , switch on the MIDI tremolo effect for the current channel. See midirw.frt
See also: tremotime (not available)

tvf-cutoff MANX
( n -- )

Set the relative filter cutoff frequency on the current channel. Allowable range: 0 .. 100 See midirw.frt

tvf-resonance MANX
( n -- )

Set the relative amount of filter peaking on the current channel. Allowable range: 0 .. 100 See midirw.frt

vibrato-delay MANX
( n -- )

Set the relative vibrato delay on the current channel. Allowable range: 0 .. 100 See midirw.frt

vibrato-depth MANX
( n -- )

Set the relative vibrato depth on the current channel. Allowable range: 0 .. 100 See midirw.frt

vibrato-rate MANX
( n -- )

Set the relative vibrato rate on the current channel. Allowable range: 0 .. 100 See midirw.frt

{ IMM MANX
( -- )

Groups a number of notes, delimited by } , into a chord (or arpeggio). The notes in a chord (arpeggio) are executed in parallel instead of sequentially.
See also: {ARP CHORD ARPEGGIO

{ARP IMM MANX
( -- )

Groups a number of notes, delimited by } , into an arpeggio (or chord). The notes in the arpeggio (chord) are executed in parallel instead of sequentially.
See also: { CHORD ARPEGGIO

{{ MANX
( -- )

Starts the first part of a parallel construct. For example, if one voice plays /4 d1 g1 and the other one /8 rest d2 rest g2 , then we say:

	{{ /4 d1 g1  &  /8 rest d2 rest g2 }}

Note: This construct can not be nested.
See also: & }}

| "bar" IMM MANX
( -- )

Usage: | ... Stops execution of the previous bar (if any) and initiates compilation of the next bar. Compiles a call to a synchronisation routine (see "|" ). Each bar is a :NONAME definition whose execution token is stored at index n (0.../bars-1) in a static array. instrument_name PART sets up the pointer to the start address of this array (during compilation AND execution). It is possible to duplicate a number of bars using n DUPLICATES or DUPLICATE . In this case the execution tokens of the last bar are used to fill the "gap" :

	 | c1 e1 g1   ( 1)
	 | duplicate
	 | g1 e1 c1   ( 2)
	 | 3 duplicates 
	 | b1 a1 c1   ( 3)
	||

Plays bar 1 twice, bar 2 4 times and bar 3 once. Also the words L: ( label), REDO .. and BIS are possible:

	L: intro
	| c2 e2 g2 
	|   intro redo
	...
	L: bar2
 	...
	L: bar8
	...
	| b2 a2 c2  
	|   bar2 .. bar8  bis
	|   intro redo 
	||

See also: "|" L: DUPLICATES DUPLICATE REDO .. BIS

|| "end" IMM MANX
( -- )

Appends the xt of a silencer to the current array of execution tokens. This will stop the instrument interpreter and return control to the Forth outer interpreter.

}} MANX
( -- )

Delimits a parallel construct. For example, if one voice plays /4 d1 g1 and the other one /8 rest d2 rest g2 , then we say:

	{{ /4 d1 g1  &  /8 rest d2 rest g2 }}

Note: This construct can not be nested.
See also: & {{

-manx MANX
( -- )

Marker for the words compiled from MANX.FRT. This file contains the top level music language words.

free counter