Copyright © 2005-2011 MultiMedia Soft

PreAmplifierSetValue method

Previous pageReturn to chapter overviewNext page

Remarks

 

Modifies the current pre-amplifier's amplification value. The current value can be obtained through the PreAmplifierGetValue method.

Pre-amplification is applied only if enabled through a previous call to the PreAmplifierEnable method.

 

 

Syntax

 

[Visual Basic]

Public Function PreAmplifierSetValue (

nPlayerIndex as Int16,

fValue as Single,

nScaleType as enumVolumeScales

) as enumErrorCodes

 

[C#]

public enumErrorCodes PreAmplifierSetValue (

Int16 nPlayerIndex,

float fValue,

enumVolumeScales nScaleType

);

 

[C++]

public: enumErrorCodes PreAmplifierSetValue (

Int16 nPlayerIndex,

float fValue,

enumVolumeScales nScaleType

);

 

 

Parameter

Description

 

 

nPlayerIndex

Number representing the zero-based index of the involved player

fValue

Amplification value expressed in the unit specified by the nScaleType parameter.

nScaleType

The amplification scaling type.

Supported values are the following:

Mnemonic constant

Value

Meaning

SCALE_LINEAR

0

Amplification, expressed in percentage, is based upon a linear scale:

- value 0.0 mutes the playing sound

- values higher than 0.0 and smaller than 100.0 attenuate the playing sound

- value 100.0 keeps sound level unchanged

- values higher than 100.0 amplify the playing sound

SCALE_LOG

1

Amplification, expressed in dB, is based upon a logarithmic scale:

- value -100.0 mutes the playing sound

- values higher than -100.0 and smaller than 0.0 attenuate the playing sound

- value 0.0 keeps sound level unchanged

- values higher than 0.0 amplify the playing sound

 

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:

VolumeLinear = 100 * pow (10, VolumeInDB/20);

 

 

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.