:Convert() - Converts Audio File to .WAV Format
Class
Syntax
:Convert(cInFile, [nInFormat], cOutFile[, nOutFormat]) --> lSuccess
Parameters
|
|
cInFile |
The name of the file that is to be converted. |
|
|
nInFormat |
Optional: Identifies the audio format of the file that is to be converted. |
|
|
cOutFile |
The name of the file that is to be created. If the file already exists, it will be overwritten. |
|
|
nOutFormat |
Optional: Identifies the audio format of the file that is to be created. |
Return
If the function succeeds, the return value is TRUE.
If the function fails, the return value is FALSE. To get extended error information, see :nErr and :cErr . Failure typically indicates that the input file could not be opened or read, or that the output file could not be created.
Description
Remarks
The following audio formats are recognized:
|
Format |
Description |
|
AUDIO_FORMAT_AIFF |
Silicon Graphics and Apple sound format |
|
AUDIO_FORMAT_SUN |
Sun and NeXT sound format |
|
AUDIO_FORMAT_VOICE |
Create Labs sound format |
|
AUDIO_FORMAT_WAVE |
Microsoft Windows sound format |
|
AUDIO_FORMAT_RAW |
Raw 8-bit sound format |
Currently the only output audio format that is supported is AUDIO_FORMAT_WAVE, the native Windows audio file format.
If a different format is specified, the ERROR_AUDIO_NOSUPPORT error will be set in :nErr.