Copyright © 2006 - 2008 MultiMedia Soft 
Return to Table of contents  
 
 
SetMixingParams method 
 
Remarks 
 
Sets the parameters used for mixing an existing sound to the actual recording session contents. 
This feature is very useful if you want to apply a background sound to your recording session. The background sound can be also put in loop for a given range. 
 
For details about applying a background sound to your recording session, take a look to the How to mix sounds to your recording session tutorial. 
 
 
Syntax 
 
[Visual Basic] 
Public Function SetMixingParams ( 
nStartPosition as Int32, 
nEndPosition as Int32, 
nNewSoundSeekPosition as Int32, 
bStopMixOnCompletion as Boolean, 
bLoop as Boolean, 
fVolumeOriginalSound as Single, 
fVolumeNewSound as Single, 
nScaleType as enumVolumeScales 
) as enumErrorCodes
 
[C#] 
public enumErrorCodes SetMixingParams ( 
Int32 nStartPosition, 
Int32 nEndPosition, 
Int32 nNewSoundSeekPosition, 
bool bStopMixOnCompletion, 
bool bLoop, 
float fVolumeOriginalSound, 
float fVolumeNewSound, 
enumVolumeScales nScaleType 
);
 
[C++] 
public: enumErrorCodes SetMixingParams ( 
Int32 nStartPosition, 
Int32 nEndPosition, 
Int32 nNewSoundSeekPosition, 
bool bStopMixOnCompletion, 
bool bLoop, 
float fVolumeOriginalSound, 
float fVolumeNewSound, 
enumVolumeScales nScaleType 
);
 
 
Parameter
Description
 
 
nStartPosition
Number representing the start position, expressed in milliseconds, inside the recording session where the mixing will begin
nEndPosition
Number representing the end position, expressed in milliseconds, inside the recording session where the mixing will end: if this parameter is set to -1, the mixing will be applied till the end of the recording session
nNewSoundSeekPosition
Initial seek position, expressed in milliseconds, inside the loaded sound: sound data before this position will be ignored and not mixed to the actual contents of the recording session
bStopMixOnCompletion
Boolean value that tells if the mixing session should stop when the end of the current recording session or the nEndPosition position are reached
bLoop
Boolean value that tells if the sound mixed to the recording session must be put in loop: it's important to note that, if the input sound file in loop mode should exceed the defined range limit, it would be in any case mixed until its completion so no unwanted cut would result on the input sound.
fVolumeOriginalSound
Floating point value representing the volume applied to the portion of recording session affected by the mixing session
fVolumeNewSound
Floating point value representing the volume applied to the loaded sound that will be mixed to the actual recording session contents
nScaleType
The volume scaling type. 
Supported values are the following: 
Mnemonic constant
Value
Meaning
SCALE_LINEAR
0
The passed volume is based upon a linear scale and can be in the range from 0.0 (silence) to 100.0 (max volume)
SCALE_LOG
1
The passed volume, expressed in dB, is based upon a logarithmic scale and can be in the range from -100  (silence) to 0 (max volume) 
The actual applied formula for converting a linear volume into a logarithmic volume is the following: 
VolumeInDB = 20 * log10 (VolumeLinear/100) 
The C syntax for converting a logarithmic volume into a linear volume is the following: 
float e = 2.7182818281f; 
float exp = (float)((fVolumeInDB + (20 * log(100))) / 20); 
fVolumeLinear = (float) pow (e, exp);
 
 
 
Return value 
 
Value
Meaning
 
 
Negative value
An error occurred (see the LastError property for further error details)
enumErrorCodes.NOERROR (0)
The method call was successful.
 
 
 
 
 
 
 
 
 
 
 
 
 
Copyright © 2006 - 2008 MultiMedia Soft 
Return to Table of contents