Programmer Guide/Command Reference/SEGMENT - Revision history

Jw: /* {{anchor|usage3|Based on data from an XML segment definition}} */

2018-04-17T10:01:55Z

← Older revision		Revision as of 12:01, 17 April 2018
Line 26:		Line 26:

	SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]
			:;<var>segexpr</var>:the segment expression to be evaluated
	:;<var>xmlfile</var>:an [[Programmer_Guide/Shell_Items/File\|XML file item]] containing the metadata; the selected element must contain sound file metadata, and the segment definitions must be stored as child elements		:;<var>xmlfile</var>:an [[Programmer_Guide/Shell_Items/File\|XML file item]] containing the metadata; the selected element must contain sound file metadata, and the segment definitions must be stored as child elements
	:;<var>srattr</var>:the XML attribute of the selected element containing the sampling rate (in Hz)		:;<var>srattr</var>:the XML attribute of the selected element containing the sampling rate (in Hz)

Jw: /* {{anchor|usage2|Based on supplied data}} */

2018-04-17T10:01:47Z

← Older revision		Revision as of 12:01, 17 April 2018
Line 17:		Line 17:

	SEGMENT <var>segexpr</var> <var>sr</var> <var>l</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> <var>sr</var> <var>l</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]
			:;<var>segexpr</var>:the segment expression to be evaluated
	:;<var>sr</var>:sampling rate in Hz		:;<var>sr</var>:sampling rate in Hz
	:;<var>l</var>:maximum signal duration in samples		:;<var>l</var>:maximum signal duration in samples

Jw at 10:01, 17 April 2018

2018-04-17T10:01:12Z

← Older revision		Revision as of 12:01, 17 April 2018
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	<code>SEGMENT</code> evaluates a segment expression in various ways, returning a string		The <code>SEGMENT</code> command evaluates a segment expression in various ways returning a string indicating the ''begin'' (<var>bseg</var>), the ''end'' (<var>eseg</var>) and the ''length'' (<var>lseg</var>) of the segment addressed by the respective segment expression.

	<var>bseg</var> <var>eseg</var> <var>lseg</var>		<var>bseg</var> <var>eseg</var> <var>lseg</var>

	~~indicating the ''begin'' (<var>bseg</var>), the ''end'' (<var>eseg</var>) and the ''length'' (<var>lseg</var>) of the segment addressed by the respective segment expression.~~

	== {{anchor\|usage1\|Based on the current sound file}} ==		== {{anchor\|usage1\|Based on the current sound file}} ==

Jw: /* Further Examples */

2018-04-17T09:59:06Z

Further Examples

← Older revision		Revision as of 11:59, 17 April 2018
Line 47:		Line 47:
	segment 50%-1s_+2s		segment 50%-1s_+2s

	Address 1 second to 1 second plus 100 samples of a signal with 10kHz sampling rate a 5 seconds duration:		Address 1 second to 1 second plus 100 samples of a signal with a 10kHz sampling rate and a 5 seconds duration:
	segment 1s_+100 10000 5*10000		segment 1s_+100 10000 5*10000

Jw: /* {{anchor|usage1|Based on the current soundfile}} */

2016-05-23T06:29:33Z

← Older revision		Revision as of 08:29, 23 May 2016
Line 6:		Line 6:
	indicating the ''begin'' (<var>bseg</var>), the ''end'' (<var>eseg</var>) and the ''length'' (<var>lseg</var>) of the segment addressed by the respective segment expression.		indicating the ''begin'' (<var>bseg</var>), the ''end'' (<var>eseg</var>) and the ''length'' (<var>lseg</var>) of the segment addressed by the respective segment expression.

	== {{anchor\|usage1\|Based on the current ~~soundfile~~}} ==		== {{anchor\|usage1\|Based on the current sound file}} ==

	Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the length of the [[Programmer_Guide/Concepts/Current_Soundfile\|current ~~soundfile~~]] (see [[../LOAD\|LOAD SOUNDFILE]]):		Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the length of the [[Programmer_Guide/Concepts/Current_Soundfile\|current sound file]] (see [[../LOAD\|LOAD SOUNDFILE]]):

	SEGMENT <var>segexpr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]

Jw: /* {{anchor|usage3|Based on data from an XML segment definition}} */

2016-02-23T10:46:00Z

← Older revision		Revision as of 12:46, 23 February 2016
Line 24:		Line 24:
	== {{anchor\|usage3\|Based on data from an XML segment definition}} ==		== {{anchor\|usage3\|Based on data from an XML segment definition}} ==

	Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>~~xitem~~</var>.		Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>xmlfile</var>.

	SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]

Jw: /* {{anchor|usage3|Based on data from an XML segment definition}} */

2016-02-23T10:45:00Z

← Older revision		Revision as of 12:45, 23 February 2016
Line 27:		Line 27:

	SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]
	:;<var>xmlfile</var>:an [[Programmer_Guide/Shell_Items/File\|XML file item]] containing the metadata; the selected element must contain ~~soundfile~~ metadata, and the segment definitions must be stored as child elements		:;<var>xmlfile</var>:an [[Programmer_Guide/Shell_Items/File\|XML file item]] containing the metadata; the selected element must contain sound file metadata, and the segment definitions must be stored as child elements
	:;<var>srattr</var>:the XML attribute of the selected element containing the sampling rate (in Hz)		:;<var>srattr</var>:the XML attribute of the selected element containing the sampling rate (in Hz)
	:;<var>segtag</var>:the XML element tag used for segment definitions		:;<var>segtag</var>:the XML element tag used for segment definitions

Christian: /* Examples */

2014-04-28T18:29:18Z

Examples

← Older revision		Revision as of 20:29, 28 April 2014
Line 40:		Line 40:
	{{:Programmer_Guide/General_Descriptions/Segment_Expressions}}		{{:Programmer_Guide/General_Descriptions/Segment_Expressions}}

	==Examples==		==Further Examples==
	Address 0 samples to 4 seconds of the current soundfile:		Address 0 samples to 4 seconds of the current soundfile:
	segment 0_4s		segment 0_4s

Christian: /* Based on data from an XML segment definition */

2014-04-28T18:11:45Z

Based on data from an XML segment definition

← Older revision		Revision as of 20:11, 28 April 2014
Line 22:		Line 22:
	:;<var>l</var>:maximum signal duration in samples		:;<var>l</var>:maximum signal duration in samples

	== Based on data from an XML segment definition ==		== {{anchor\|usage3\|Based on data from an XML segment definition}} ==

	Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>xitem</var>.		Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>xitem</var>.

Christian: /* Based on supplied data */

2014-04-28T18:11:33Z

Based on supplied data

← Older revision		Revision as of 20:11, 28 April 2014
Line 14:		Line 14:
	:;[[Programmer_Guide/Command_Reference_Options/Silent\|<code>/Silent</code>]], <code>/?</code>:silent error handling; generate warnings rather than errors.		:;[[Programmer_Guide/Command_Reference_Options/Silent\|<code>/Silent</code>]], <code>/?</code>:silent error handling; generate warnings rather than errors.

	== Based on supplied data ==		== {{anchor\|usage2\|Based on supplied data}} ==

	Evaluate the segment expression <var>segexpr</var>, using the specified sampling rate and length.		Evaluate the segment expression <var>segexpr</var>, using the specified sampling rate and length.

← Older revision		Revision as of 12:46, 23 February 2016
Line 24:		Line 24:
	== {{anchor\|usage3\|Based on data from an XML segment definition}} ==		== {{anchor\|usage3\|Based on data from an XML segment definition}} ==

	Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>~~xitem~~</var>.		Evaluate the segment expression <var>segexpr</var>, using the sampling rate and the segment definitions stored in the [[Programmer_Guide/Shell_Items/File\|XML file item]] <var>xmlfile</var>.

	SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]		SEGMENT <var>segexpr</var> <var>xmlfile</var> <var>srattr</var> <var>segtag</var> <var>idattr</var> <var>pattr </var> <var>lattr</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/Silent \| /?]] ]