Description
SPLSourceFile is used to create SPLists from a soundfile.It also calls the SPListAnalyst programm, which creats the analyse files of a soundfile. this binary file is read to create the Periods of a SPList.
Class Methods
.newSPL
returns directly a new SPList. the SPLSourceFile is referenced by its Periods. this is the normal usecase.
Arguments:
| minsize |
the minimum size of a period. |
| soundfilename |
the name of the soundfile, |
| anafilename |
the name of the analyse file which has to be written. the default is nil in this case the name is: soundfilename++".jspbl"++minsize |
| minvol |
minimum amplitude (0 to 1) that has to be reached so that a period counts as a distinct period. |
Returns:
a SPList
.new
*new (minsize, soundfilename, anafilename) Creates a new SPLSourceFile.
Arguments:
| minsize |
The minimum size of a period. |
| soundfilename |
The name of the soundfile. |
| anafilename |
The name of the analyse file which has to be written. The default is nil in this case the name is: soundfilename++".jspbl"++minsize |
| minvol |
Minimum amplitude (0 to 1) that has to be reached so that a period counts as a distinct period. |
Returns:
a SPLSourceFile
Instance Methods
.getNewSPL
Reads the data from the analyse-file and put it into a new SPList
Returns:
a SPList
.analyseSoundfile
Starts the analyse command only when its not done already.
.minsize
The minimum size of a period.
.soundfilename
The name of the soundfile
Returns:
(describe returnvalue here)
.anafilename
The name of the analyse file which has to be written.
.minvol
Minimum amplitude (0 to 1) that has to be reached so that a period counts as a distinct period.
Examples
normal way of using SPLSourceFile is the following. The SPLSourceFile is rarely needed.