Programmer Guide/Macro Library/BSeq - Revision history

Toni: /* Example */

2018-03-06T15:17:52Z

Example

← Older revision		Revision as of 17:17, 6 March 2018
Line 249:		Line 249:

	==Example==		==Example==
	The example script '''bseq_example.sts''' is part of the installed example script package (directory: ''stx-root'''''\scripts\examples'''		The example script '''bseq_example.sts''' is part of the installed example script package (directory: ''stx-root'''''\scripts\examples''').

	<pre>		<pre>

Toni: /* Example */

2018-03-06T15:17:19Z

Example

← Older revision		Revision as of 17:17, 6 March 2018
Line 257:		Line 257:

	// create a BSeq instance		// create a BSeq instance
	#bseq := BSeq srate=44100; channels=1; envelope=cos;250;250		#bseq := BSeq srate=44100; channels=1; envelope=cos;250;250; factor=0.5
	if '$#bseq[?]' != 'instance' em -1 ; $#mac::Error - failed to create a BSeq instance		if '$#bseq[?]' != 'instance' em -1 ; $#mac::Error - failed to create a BSeq instance
	// define a 100s sine tone at 1000Hz		// define a 100s sine tone at 1000Hz

Toni: /* Example */

2018-03-06T15:15:45Z

Example

← Older revision		Revision as of 17:15, 6 March 2018
Line 257:		Line 257:

	// create a BSeq instance		// create a BSeq instance
	#bseq := BSeq		#bseq := BSeq srate=44100; channels=1; envelope=cos;250;250
	if '$#bseq[?]' != 'instance' em -1 ; $#mac::Error - failed to create a BSeq instance		if '$#bseq[?]' != 'instance' em -1 ; $#mac::Error - failed to create a BSeq instance
	// define a 100s sine tone at 1000Hz		// define a 100s sine tone at 1000Hz

Toni: /* Example */

2018-03-06T15:13:43Z

Example

← Older revision		Revision as of 17:13, 6 March 2018
Line 250:		Line 250:
	==Example==		==Example==
	The example script '''bseq_example.sts''' is part of the installed example script package (directory: ''stx-root'''''\scripts\examples'''		The example script '''bseq_example.sts''' is part of the installed example script package (directory: ''stx-root'''''\scripts\examples'''

			<pre>
			// play a 1000Hz sine tone using the BSeq class

			[Macro bseq_example]

			// create a BSeq instance
			#bseq := BSeq
			if '$#bseq[?]' != 'instance' em -1 ; $#mac::Error - failed to create a BSeq instance
			// define a 100s sine tone at 1000Hz
			$#bseq Signal * ; begin ; 0 ; tone ; 100 ; 1 ; 1000 ; 0
			if '$result' != 0 em $result ; $#mac::Error - sequence Signal call failed
			// play the tone using the playback dialog
			$#bseq play 1
			if '$result' != 0 em $result ; $#mac::Error - playback failed
			// destroy the instance
			$#bseq destroy

			exit 1 int 0
			</pre>

Toni at 15:11, 6 March 2018

2018-03-06T15:11:06Z

← Older revision		Revision as of 17:11, 6 March 2018
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}} - Signal Sequence}}		{{DISPLAYTITLE:{{SUBPAGENAME}} - Signal Sequence}}
	:'''File''': BSeq.STX, linked to library STX.LIB		:'''File''': BSeq.STX, linked to library STX.LIB
			:'''Parent class''': [[Programmer Guide/Macro Library/COBJ\|CObj]]
	:'''See also''': [[Programmer_Guide/Shell_Items/Wave/SET_WAVE#Sequences\|Sequences]]		:'''See also''': [[Programmer_Guide/Shell_Items/Wave/SET_WAVE#Sequences\|Sequences]]

	The class <code>BSeq</code> can create and play sequences and provides an interface to the [[Programmer_Guide/Shell_Items/Wave/SET_WAVE#Sequences\|sequence wave-item]] functions.		The class <code>BSeq</code> can create and play sequences and provides an interface to the [[Programmer_Guide/Shell_Items/Wave/SET_WAVE#Sequences\|sequence wave-item]] functions.

	==Create an Instance ~~of BSeq~~==		==Create BSeq Instance==
	;Usage:		;Usage:
	:<code>bseq [ <var>attr</var>=<var>value</var> ; ... ]</code>		:<code>bseq [ <var>attr</var>=<var>value</var> ; ... ]</code>
Line 246:		Line 247:
	::* sampling rate (attribute '''SR'''=''srate'') and number of channels (attribute '''CH'''=''channels'') as attributes of the element <var>ref</var>		::* sampling rate (attribute '''SR'''=''srate'') and number of channels (attribute '''CH'''=''channels'') as attributes of the element <var>ref</var>
	::* all signal defintions including envelope, filter and modulation defintions as content (data) of the child element '''ASequenceSignals''' of the element <var>ref</var>		::* all signal defintions including envelope, filter and modulation defintions as content (data) of the child element '''ASequenceSignals''' of the element <var>ref</var>

			==Example==
			The example script '''bseq_example.sts''' is part of the installed example script package (directory: ''stx-root'''''\scripts\examples'''

Toni: /* Dialog to Add / Edit Signals */

2018-03-06T14:46:23Z

Dialog to Add / Edit Signals

← Older revision		Revision as of 16:46, 6 March 2018
Line 86:		Line 86:

	===Dialog to Add / Edit Signals===		===Dialog to Add / Edit Signals===
	;Usage: <code><var>bseq_instance</var> dialogedit <var>pos</var></code>		;Usage:<code><var>bseq_instance</var> dialogedit <var>pos</var></code>
	.;<var>pos</var>: the index of the signal; '''*''' for the last defined signal		:;<var>pos</var>: the index of the signal; '''*''' for the last defined signal
	;Result: none (void)		;Result: none (void)
	;Description: A dialog is displayed, where new signals can be difined and existing signals can be modified or deleted. In the dialog also the envelope, filter and modulation functions for a signal can be configured.		;Description: A dialog is displayed, where new signals can be difined and existing signals can be modified or deleted. In the dialog also the envelope, filter and modulation functions for a signal can be configured.

	===Delete Signal===		===Delete Signal===

Toni: /* Assign Envelope */

2018-03-06T14:45:29Z

Assign Envelope

← Older revision		Revision as of 16:45, 6 March 2018
Line 98:		Line 98:

	===Assign Envelope===		===Assign Envelope===
	;Usage: <code><var>bseq_instance</var> envelope <var>pos ; type ; t1 a1 t2 a2 ...</var></code>		;Usage:<code><var>bseq_instance</var> envelope <var>pos ; type ; t1 a1 t2 a2 ...</var></code>
	:;<var>pos</var>: the signal index; '''*''' for last defined signal		:;<var>pos</var>: the signal index; '''*''' for last defined signal
	:;<var>type</var>: the type of envelope. The types '''none''' (no envelope), '''linear''' and '''cosine''' are supported		:;<var>type</var>: the type of envelope. The types '''none''' (no envelope), '''linear''' and '''cosine''' are supported

Toni: /* Delete Signal */

2018-03-06T14:45:15Z

Delete Signal

← Older revision		Revision as of 16:45, 6 March 2018
Line 92:		Line 92:

	===Delete Signal===		===Delete Signal===
	;Usage: <code><var>bseq_instance</var> delete <var>pos</var></code>		;Usage:<code><var>bseq_instance</var> delete <var>pos</var></code>
	:;<var>pos</var>: the index of the signal; '''*''' for the last defined signal		:;<var>pos</var>: the index of the signal; '''*''' for the last defined signal
	;Result: always '''0'''		;Result: always '''0'''

Toni: /* Delete Signal */

2018-03-06T14:44:58Z

Delete Signal

← Older revision		Revision as of 16:44, 6 March 2018
Line 93:		Line 93:
	===Delete Signal===		===Delete Signal===
	;Usage: <code><var>bseq_instance</var> delete <var>pos</var></code>		;Usage: <code><var>bseq_instance</var> delete <var>pos</var></code>
	.;<var>pos</var>: the index of the signal; '''*''' for the last defined signal		:;<var>pos</var>: the index of the signal; '''*''' for the last defined signal
	;Result: always '''0'''		;Result: always '''0'''
	;Description: Delete the specified signal defintion from the sequence.		;Description: Delete the specified signal defintion from the sequence.

Toni: /* Assign Amp-Modulation */

2018-03-06T14:44:24Z

Assign Amp-Modulation

← Older revision		Revision as of 16:44, 6 March 2018
Line 155:		Line 155:
	===Assign Amp-Modulation===		===Assign Amp-Modulation===
	;Usage:		;Usage:
	:<code><var>bseq_instance</var> ~~fmod~~ <var>pos</var> ; none</code>		:<code><var>bseq_instance</var> amod <var>pos</var> ; none</code>
	:<code><var>bseq_instance</var> ~~fmod~~ <var>pos</var> ; sine ; <var>rate ; k ; p</var></code>		:<code><var>bseq_instance</var> amod <var>pos</var> ; sine ; <var>rate ; k ; p</var></code>
	:<code><var>bseq_instance</var> ~~fmod~~ <var>pos</var> ; rectangle \| triangle ; <var>rate ; k ; dc</var></code>		:<code><var>bseq_instance</var> amod <var>pos</var> ; rectangle \| triangle ; <var>rate ; k ; dc</var></code>
	:;<var>pos</var>: the signal index; '''*''' for last defined signal		:;<var>pos</var>: the signal index; '''*''' for last defined signal
	;:<var>rate</var>: modulation rate in Hz		;:<var>rate</var>: modulation rate in Hz