Difference between revisions of "Programmer Guide/Command Reference/SFTRUNCATE"

From STX Wiki
Jump to navigation Jump to search
 
Line 2: Line 2:
 
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.
 
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.
+
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]].
 
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]].

Latest revision as of 18: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.