Programmer Guide/Shell Items/Wave/SET WAVE - Revision history

Jw: /* Copying signals */

2018-08-13T13:25:31Z

Copying signals

← Older revision		Revision as of 15:25, 13 August 2018
Line 12:		Line 12:
	==Copying signals==		==Copying signals==

	The following commands can be used to copy signal data to and from a wave item. Note that the wave item <var>wave</var> must be associated with a file on disk.		The following commands can be used to copy signal data to and from a wave item. Note that the wave item <var>wave</var> must be associated with a file on disk, otherwise you will get a <samp>wave item has no data-stream</samp> error (63).

	===COPY===		===COPY===

Jw: /* Playback and Recording */

2018-06-21T09:23:22Z

Playback and Recording

← Older revision		Revision as of 11:23, 21 June 2018
Line 159:		Line 159:
	Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option <code>/Reverse</code> is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options <code>/2</code>, <code>/3</code> or <code>/4</code> select the number of bytes per sample.		Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option <code>/Reverse</code> is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options <code>/2</code>, <code>/3</code> or <code>/4</code> select the number of bytes per sample.

	The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the ~~soundfile~~ has finished playing (e.g. messages or dialog box).		The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the sound file has finished playing (e.g. messages or dialog box).

	The parameters <var>mTable</var> and <var>mField</var> can be used to map specific wave channels to specific soundcard device channels. If these parameters is not specified, the soundcard's channels are automatically mapped 1=1, 2=2, 3=3. If the soundcard has more channels than the wave item, these extra channels are not mapped. A wave-item channel can be mapped to more than one device channel. A device channel can only be mapped to once. If mapping is used, then only mapped channels are played. If an entry contains an invalid device or or wave-item channel value, the entry is ignored.		The parameters <var>mTable</var> and <var>mField</var> can be used to map specific wave channels to specific soundcard device channels. If these parameters is not specified, the soundcard's channels are automatically mapped 1=1, 2=2, 3=3. If the soundcard has more channels than the wave item, these extra channels are not mapped. A wave-item channel can be mapped to more than one device channel. A device channel can only be mapped to once. If mapping is used, then only mapped channels are played. If an entry contains an invalid device or or wave-item channel value, the entry is ignored.

Jw: /* Playback and Recording */

2018-06-21T09:22:58Z

Playback and Recording

← Older revision		Revision as of 11:22, 21 June 2018
Line 157:		Line 157:
	<code>SET <var>wave</var> PLAY [ <var>samples count begin end timeritem</var> [ <var>gain</var> ][ <var>mTable</var> [ <var>mField</var>=0 ]]] [ /1\|2\|3\|4 ] [ /Reverse ]</code>		<code>SET <var>wave</var> PLAY [ <var>samples count begin end timeritem</var> [ <var>gain</var> ][ <var>mTable</var> [ <var>mField</var>=0 ]]] [ /1\|2\|3\|4 ] [ /Reverse ]</code>

	Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option <code>/Reverse</code> is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options /2, /3 or /4 select the number of bytes per sample.		Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option <code>/Reverse</code> is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options <code>/2</code>, <code>/3</code> or <code>/4</code> select the number of bytes per sample.

	The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the soundfile has finished playing (e.g. messages or dialog box).		The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the soundfile has finished playing (e.g. messages or dialog box).

Jw: /* PLAY */

2018-06-21T09:22:19Z

PLAY

← Older revision		Revision as of 11:22, 21 June 2018
Line 157:		Line 157:
	<code>SET <var>wave</var> PLAY [ <var>samples count begin end timeritem</var> [ <var>gain</var> ][ <var>mTable</var> [ <var>mField</var>=0 ]]] [ /1\|2\|3\|4 ] [ /Reverse ]</code>		<code>SET <var>wave</var> PLAY [ <var>samples count begin end timeritem</var> [ <var>gain</var> ][ <var>mTable</var> [ <var>mField</var>=0 ]]] [ /1\|2\|3\|4 ] [ /Reverse ]</code>

	Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option /Reverse is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options /2, /3 or /4 select the number of bytes per sample.		Start playing the signal of wave-item <var>wave</var>. The arguments <var>samples</var> and <var>count</var> are used in the play-function for I/O-buffer allocation. The sample values <var>begin</var> and <var>end</var> can be used to play only the selected part of the signal. If the option <code>/Reverse</code> is specified, the signal is played backwards (end -> begin). For wave-out devices using digital-to-audio converters (DACs) with a higher sample resolution than normal adapters, the options /2, /3 or /4 select the number of bytes per sample.

	The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the soundfile has finished playing (e.g. messages or dialog box).		The argument <var>timeritem</var> is the name of a value item (with a configured and stopped timer). If specified, it is used as a timer running synchronously with the playback process. Note that if you do not use a timer, you may need to use another method to pause macro execution until the soundfile has finished playing (e.g. messages or dialog box).

Toni: /* DEVICE */

2018-03-06T11:50:55Z

DEVICE

← Older revision		Revision as of 13:50, 6 March 2018
Line 246:		Line 246:
	:Initialize the ASIO interface of the device.		:Initialize the ASIO interface of the device.

	The number of wave items which can record or playback at the same time is dependant on the type of device and the Windows operating system. ASIO devices can have an unlimited number of wave items attached to them. During playback or recording, all wave items must, however, use the same device. MME under Windows 2000 supports one playback and one recording wave item per device. MME under Windows XP supports one playback and multiple recording wave items per device.All wave items must have the same sampling rate.Another way to play signals from different sources synchronously is to use a wave-item of type sequence (see ~~<code>~~[[~~Programmer Guide~~/~~SPU Reference~~/~~CCONV - real~~/~~complex spectrum conversions~~\|NEW WAVE]]~~</code>~~).		The number of wave items which can record or playback at the same time is dependant on the type of device and the Windows operating system. ASIO devices can have an unlimited number of wave items attached to them. During playback or recording, all wave items must, however, use the same device. MME under Windows 2000 supports one playback and one recording wave item per device. MME under Windows XP supports one playback and multiple recording wave items per device. All wave items must have the same sampling rate. Another way to play signals from different sources synchronously is to use a wave-item of type sequence (see [[Programmer_Guide/Shell_Items/Wave/NEW_WAVE\|NEW WAVE]]).

	==Sequences==		==Sequences==

Toni: /* Sequences */

2018-03-05T10:42:32Z

Sequences

← Older revision		Revision as of 12:42, 5 March 2018
Line 252:		Line 252:
	Sequences are useful for generating, filtering and concaternating signals. A sequence can contain different signals in each channel.		Sequences are useful for generating, filtering and concaternating signals. A sequence can contain different signals in each channel.

	These functions create and modify or filter sequence signals. A sequence wave object is created with the [[~~Programmer Guide~~/~~SPU Reference~~/~~CCONV - real~~/~~complex spectrum conversions~~\|NEW wave]] command and the option /Q. Once you have finished defining and filtering your sequence signal, use the <code>SET sequence END</code> command to generate the wave signal.		These functions create and modify or filter sequence signals. A sequence wave object is created with the [[Programmer_Guide/Shell_Items/Wave/NEW_WAVE\|NEW wave]] command and the option /Q. Once you have finished defining and filtering your sequence signal, use the <code>SET sequence END</code> command to generate the wave signal.

	===Filtering a Sequence===		===Filtering a Sequence===

Toni: /* Use WAVE Items in Numerical Expressions (EVAL) */

2018-03-05T10:30:53Z

Use WAVE Items in Numerical Expressions (EVAL)

← Older revision		Revision as of 12:30, 5 March 2018
Line 144:		Line 144:
	#wlen := eval $#wave[!srate] * 0.125 // set window length to 125ms		#wlen := eval $#wave[!srate] * 0.125 // set window length to 125ms
	for #p := 0 to $#p+$#wlen <= $#wave[!length] step #p := int $#p + $#wlen/2		for #p := 0 to $#p+$#wlen <= $#wave[!length] step #p := int $#p + $#wlen/2
	#rms * '$(eval ($#wave[!signal,1,$#p,$#wlen] ^ 2) / $#wlen)'		$#rms * '$(eval ($#wave[!signal,1,$#p,$#wlen] ^ 2) / $#wlen)'
	end		end
	$#rms := eval lin2log($#rms, 1, 10)		$#rms := eval lin2log($#rms, 1, 10)

Toni: /* Playback and Recording */

2018-03-05T10:09:21Z

Playback and Recording

← Older revision		Revision as of 12:09, 5 March 2018
Line 202:		Line 202:

	:Play the signal backwards.		:Play the signal backwards.


	;See also:		;See also:

Toni: /* PLAY */

2018-03-05T10:09:04Z

PLAY

← Older revision		Revision as of 12:09, 5 March 2018
Line 203:		Line 203:
	:Play the signal backwards.		:Play the signal backwards.

	~~You can~~ also ~~play back a wave~~ item ~~in a dialog using the~~ macro <code>~~SHOWITEM~~</code>.
			;See also:
			* [[Programmer_Guide/Macro_Library/SHOWITEM\|macro ShowItem]] → use the general item-data display macro for playback <code>showitem <var>mywaveitem ; myplaydialogtitle</var></code>
			* [[Programmer_Guide/Macro_Library/PlayWave\|class PlayWave]] → this class implements a dialog for the playback of any kind of signal object
			* [[Programmer_Guide/Macro_Library/XWave\|class XWave]] → a class for accessing signals e.g. for dsp algorithms; implements a simple playback function

	===RECORD===		===RECORD===

Toni: /* Playback and Recording */

2018-03-05T09:56:33Z

Playback and Recording

← Older revision		Revision as of 11:56, 5 March 2018
Line 203:		Line 203:
	:Play the signal backwards.		:Play the signal backwards.

	You can also play back a wave item in a dialog using the macro <code>SHOWITEM</code>.=====RECORD=====		You can also play back a wave item in a dialog using the macro <code>SHOWITEM</code>.

			===RECORD===

	<code>SET <var>wave</var> RECORD [<var>samples count begin end timeritem</var> [<var>mTable</var> [<var>mField</var>=0]]] [/1\|2\|3\|4]</code>		<code>SET <var>wave</var> RECORD [<var>samples count begin end timeritem</var> [<var>mTable</var> [<var>mField</var>=0]]] [/1\|2\|3\|4]</code>