Remarks
Converts a specific range inside the given sound file, stored in RAW format, using the sound encoding format defined inside the EncodeFormats.FormatToUse property..
A conversion session can be stopped at any time through a call to the ConvertFileCancel method.
For converting the full file you can use the ConvertFileRaw method.
During the conversion phase, a few effects, like Normalization and DC Offset removal, may be applied through the ConvertFileDestEffectsSet method and a few options may be set through the ConvertFileDestOptionsSet and through the ConvertFileDestResamplingSet methods.
A successful call to this method will fire the ConvertSoundFileStarted event followed by a number of ConvertSoundFilePerc events and finally by the ConvertSoundFileDone event.
Syntax
[Visual Basic]
Public Function ConvertFileRawRange (
strSourcePathname as String,
nStartPosition as Int32,
nEndPosition as Int32,
nEncodeMode as enumRAWEncodeModes,
bIsBigEndian as Boolean,
nFrequency as Int32,
nChannels as Int32
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes ConvertFileRawRange (
string strSourcePathname,
Int32 nStartPosition,
Int32 nEndPosition,
enumRAWEncodeModes nEncodeMode,
bool bIsBigEndian,
Int32 nFrequency,
Int32 nChannels
);
|
|
[C++]
public: enumErrorCodes ConvertFileRawRange (
string strSourcePathname,
Int32 nStartPosition,
Int32 nEndPosition,
enumRAWEncodeModes nEncodeMode,
bool bIsBigEndian,
Int32 nFrequency,
Int32 nChannels
);
|
|
Parameter
|
Description
|
|
|
strSourcePathname
|
String representing the absolute pathname of the input file.
|
nStartPosition
|
Start position, expressed in milliseconds, of the sound range to convert
|
nEndPosition
|
End position, expressed in milliseconds, of the sound range to convert. If set to -1 the end position will be set to the end of the sound.
|
nEncodeMode
|
Encode mode used to encode the RAW file.
Supported values are the following:
Mnemonic constant
|
Numeric value
|
Meaning
|
RAW_ENCODE_PCM_U8
|
0
|
RAW PCM 8 bits Unsigned
|
RAW_ENCODE_PCM_S8
|
1
|
RAW PCM 8 bits Signed
|
RAW_ENCODE_PCM_S16
|
2
|
RAW PCM 16 bits Signed
|
RAW_ENCODE_PCM_S24
|
3
|
RAW PCM 24 bits Signed
|
RAW_ENCODE_PCM_S32
|
4
|
RAW PCM 32 bits Signed
|
RAW_ENCODE_FLOAT32
|
5
|
RAW 32 bits floating point
|
RAW_ENCODE_G711_ULAW
|
6
|
RAW G711 U-LAW
|
RAW_ENCODE_G711_ALAW
|
7
|
RAW G711 A-LAW
|
RAW_ENCODE_GSM_610
|
8
|
RAW GSM 6.10
|
RAW_ENCODE_DIALOGIC_VOX
|
9
|
RAW Dialogic ADPCM VOX
|
|
bIsBigEndian
|
Boolean flag that specifies if bits order inside the RAW file are little-endian or big-endian
Supported values are the following:
Mnemonic Value
|
Meaning
|
false
|
The RAW file is encoded using little-endian
|
true
|
The RAW file is encoded using big-endian
|
|
nFrequency
|
Sample rate of the RAW file (e.g. 44100)
|
nChannels
|
Number of channels of the RAW file, for example 1 for Mono, 2 for Stereo, 6 for 5.1 surround, etc.
|
Return value
Value
|
Meaning
|
|
|
Negative value
|
An error occurred. Check the LastError property value in order to see the last error.
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful.
|
|
