Programmer Guide/General Descriptions/Segment Expressions - Revision history

Jw at 07:50, 12 September 2016

2016-09-12T07:50:57Z

← Older revision		Revision as of 09:50, 12 September 2016
Line 66:		Line 66:
	==Notes==		==Notes==
	For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''		For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''

			<!-- hidden keywords -->
			<div class="keywords">Time Expression</div>

Jw: /* Label Expression */

2016-09-12T07:47:37Z

Label Expression

← Older revision		Revision as of 09:47, 12 September 2016
Line 47:		Line 47:

	{\|class="keinrahmen" style="margin-left:1.5em;"		{\|class="keinrahmen" style="margin-left:1.5em;"
	\|Where: \|\|<var>x</var>\|\|is\|\|a number		\|Where: \|\|<var>x</var>\|\|is a number
	\|-		\|-
	\| \|\|<var>sr</var>\|\|is\|\|the signal sampling rate in Hz		\| \|\|<var>sr</var>\|\|is the signal sampling rate in Hz
	\|-		\|-
	\| \|\|<var>l</var>\|\|is\|\|the signal length in samples (e.g. soundfile length)		\| \|\|<var>l</var>\|\|is the signal length in samples (e.g. soundfile length)
	\|-		\|-
	\| \|\|<var>segid</var>\|\|is\|\|the ID of a segment defined in the XML file		\| \|\|<var>segid</var>\|\|is the ID of a segment defined in the XML file
	\|}		\|}

Jw at 07:39, 12 September 2016

2016-09-12T07:39:17Z

← Older revision		Revision as of 09:39, 12 September 2016
Line 2:		Line 2:
	{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment names]] and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment names]] and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment ~~expression:~~ A ''segment expression'' addresses a part of a sound file with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		==Segment Expression==
			A ''segment expression'' addresses a part of a sound file with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.
	{\|class="einrahmen" style="margin-left:1.5em;"		{\|class="einrahmen" style="margin-left:1.5em;"
	!segment expression!!description		!segment expression!!description
Line 16:		Line 17:
	\|}		\|}

	~~;Labels~~: A ''label expression'' is a position in a sound file (e.g. the begin/end of a segment) or the duration of a segment. A label expression may consist of a sign (+/-) and one or more values formatted as described below and combined with the operators + (add) or – (subtract). If a label expression contains blanks, it must be quoted when used as an argument.		==Label Expression==
			: A ''label expression'' is a position in a sound file (e.g. the begin/end of a segment) or the duration of a segment. A label expression may consist of a sign (+/-) and one or more values formatted as described below and combined with the operators + (add) or – (subtract). If a label expression contains blanks, it must be quoted when used as an argument.
	{\|class="einrahmen" style="margin-left:1.5em;"		{\|class="einrahmen" style="margin-left:1.5em;"
	!label expression!!description!!value in samples !!comment		!label expression!!description!!value in samples !!comment
Line 54:		Line 56:
	\|}		\|}

	~~;Simple examples:~~ Below you will find a short list of examples.		==Examples==
			Below you will find a short list of examples.
	:;<code>0_4s</code>: addresses the segment from sample 0 (the beginning) to 4 seconds into the file		:;<code>0_4s</code>: addresses the segment from sample 0 (the beginning) to 4 seconds into the file
	:;<code>SegmentA:B+100_+10s</code>: addresses 100 samples after the beginning of an existing segment called "SegmentB" for a duration of ten seconds		:;<code>SegmentA:B+100_+10s</code>: addresses 100 samples after the beginning of an existing segment called "SegmentB" for a duration of ten seconds
Line 61:		Line 64:
	:;<code>SegmentB:E_-100ms</code>: addresses the range starting 100 milliseconds ''before'' the end of SegmentB and ending at the end of SegmentB		:;<code>SegmentB:E_-100ms</code>: addresses the range starting 100 milliseconds ''before'' the end of SegmentB and ending at the end of SegmentB

	;Notes: For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''		==Notes==
			For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''

Jw at 07:37, 12 September 2016

2016-09-12T07:37:05Z

← Older revision		Revision as of 09:37, 12 September 2016
Line 2:		Line 2:
	{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment names]] and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment names]] and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a ~~soundfile~~ with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a sound file with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.
	{\|class="einrahmen" style="margin-left:1.5em;"		{\|class="einrahmen" style="margin-left:1.5em;"
	!segment expression!!description		!segment expression!!description

Jw at 15:20, 30 August 2016

2016-08-30T15:20:57Z

← Older revision		Revision as of 17:20, 30 August 2016
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment names]] and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.

Jw at 15:19, 30 August 2016

2016-08-30T15:19:17Z

← Older revision		Revision as of 17:19, 30 August 2016
Line 2:		Line 2:
	{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a [[User_Guide/Project/Segment#Segment_Name_Restrictions\|segment name]], or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.
	{\|class="einrahmen" style="margin-left:1.5em;"		{\|class="einrahmen" style="margin-left:1.5em;"
	!segment expression!!description		!segment expression!!description

Jw at 07:42, 1 June 2015

2015-06-01T07:42:24Z

← Older revision		Revision as of 09:42, 1 June 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	~~The~~ {{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		{{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.

Jw at 07:41, 1 June 2015

2015-06-01T07:41:01Z

← Older revision		Revision as of 09:41, 1 June 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	The {{STX}} uses ~~an amazing~~ syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		The {{STX}} uses a special syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.

Christian at 16:05, 29 April 2014

2014-04-29T16:05:49Z

← Older revision		Revision as of 18:05, 29 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	{{STX}} uses an amazing syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.		The {{STX}} uses an amazing syntax to address a segment of a sound file. The syntax allows for the mixed use of segment names and time values in a complex expression known as a ''segment expression''. Segment expressions may be used in all commands and dialogs where a signal segment (or a position/duration) may be specified (exceptions are described in the [[Programmer_Guide/Command_Reference\|Command Reference]]). In dialogs, the supported value formats/types are always described in the control/dialog caption.

	;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.		;Segment expression: A ''segment expression'' addresses a part of a soundfile with a non-zero duration. It can consist of (1) a segment ''name'', or (2) of two label expressions (see below) specifying the ''beginning'' and the ''end'' of the segment, or (3) of two label expressions (see below) specifying the ''position'' of the segment and its ''duration''.

Christian at 18:32, 28 April 2014

2014-04-28T18:32:51Z

← Older revision		Revision as of 20:32, 28 April 2014
Line 61:		Line 61:
	:;<code>SegmentB:E_-100ms</code>: addresses the range starting 100 milliseconds ''before'' the end of SegmentB and ending at the end of SegmentB		:;<code>SegmentB:E_-100ms</code>: addresses the range starting 100 milliseconds ''before'' the end of SegmentB and ending at the end of SegmentB

	Notes: For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''		;Notes: For some expressions, the values <code>number%</code> (percentage of the full duration) and <code>number%%</code> (thousandths of the full duration) can be used, but only if the full signal is available/defined (e.g. for envelopes of sequence signals). A <code>segmentname</code> can only be used if a sound file or an audio-element of an XML file is involved in the expression evaluation. ''Segment names are case sensitive.''