Programmer Guide/Command Reference/SFTRUNCATE: Difference between revisions
m (1 revision: Initial import) |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
The <code>SFTRUNCATEy</code> commands removes part of the [[Programmer_Guide/Concepts/Current_Soundfile|current, i.e. active, i.e. currently active, soundfile]]. It will return the number of remaining samples. | |||
Note that the [[segment directory]] will not be updated. This doesn't matter, though, because it is unclear what the term [[segment directory]] ''means'' anyway - maybe the segment list in the {{STx}} GUI. | |||
Also note that you can use the command [[Programmer_Guide/Macro_Library/BSF#Select|<code>BSF SELECT</code>]] to designate a sound file the [[Programmer_Guide/Concepts/Current_Soundfile|current soundfile]]. | |||
<var>var</var> := SFTRUNCATE <var>endaddress</var> | |||
This will truncate the [[Programmer_Guide/Concepts/Current_Soundfile|current soundfile]] at the [[XXX|address]] <var>endaddress</var>. This document doesn't tell us how this address is specified - my guess is that if works like a [[Programmer_Guide/General_Descriptions/Segment_Expression|segment expression]], but don't rely on that. | |||
<var>var</var> := SFTRUNCATE <var>segment</var> | |||
This will remove everything from the [[Programmer_Guide/Concepts/Current_Soundfile|current soundfile]] before and after the respective <var>segment</var>. This document doesn't tell us if <var>segment</var> has to be the name of a segment or if you may use a full [[Programmer_Guide/General_Descriptions/Segment_Expression|segment expression]]. My guess is the latter, but don't rely on that. | |||
Latest revision as of 17:20, 29 April 2014
The SFTRUNCATEy commands removes part of the current, i.e. active, i.e. currently active, soundfile. It will return the number of remaining samples.
Note that the segment directory will not be updated. This doesn't matter, though, because it is unclear what the term segment directory means anyway - maybe the segment list in the STx GUI.
Also note that you can use the command BSF SELECT to designate a sound file the current soundfile.
var := SFTRUNCATE endaddress
This will truncate the current soundfile at the address endaddress. This document doesn't tell us how this address is specified - my guess is that if works like a segment expression, but don't rely on that.
var := SFTRUNCATE segment
This will remove everything from the current soundfile before and after the respective segment. This document doesn't tell us if segment has to be the name of a segment or if you may use a full segment expression. My guess is the latter, but don't rely on that.
