Copyright © 2005-2023 MultiMedia Soft

Fader.FadeOutVolumeCurveSetEx method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets the volume curve for fade-out operations.

 

This setting is lost after invoking the Fader.Exit method so you should call again this method after a new eventual call to the Fader.Init method.

 

 

Syntax

 

[Visual Basic]

Public Function FadeOutVolumeCurveSetEx (

nCurveType as enumVolumeCurves,

nLeftX as Int16,

nLeftY as Int16,

nRightX as Int16,

nRightY as Int16

) as enumErrorCodes


 

[C#]

public enumErrorCodes FadeOutVolumeCurveSetEx (

enumVolumeCurves nCurveType,

Int16 nLeftX,

Int16 nLeftY,

Int16 nRightX,

Int16 nRightY

);


 

[C++]

public: enumErrorCodes FadeOutVolumeCurveSetEx (

enumVolumeCurves nCurveType,

Int16 nLeftX,

Int16 nLeftY,

Int16 nRightX,

Int16 nRightY

);


 

 

Parameter

Description

 

 

nCurveType

Type of curve applied to the volume sliding.

Supported values are the following:

Mnemonic constant

Value

Meaning

 

 

 

VOLUME_CURVE_LINEAR

1

Linear curve

adjstudnet_i000086

VOLUME_CURVE_EXPONENTIAL

2

Exponential curve

adjstudnet_i000087

VOLUME_CURVE_COSINE

3

Cosine curve

adjstudnet_i000088

VOLUME_CURVE_SMOOTH

4

Smooth curve

adjstudnet_i000089

VOLUME_CURVE_CUSTOM

5

Custom Bézier curve.

adjstudnet_i00008a

nLeftX

The horizontal position, expressed in percentage of the custom curve designer's area, of the left control point (*). This parameter is ignored if the nScaleType parameter above has been set to a value different from VOLUME_CURVE_CUSTOM.

nLeftY

The vertical position, expressed in percentage of the custom curve designer's area, of the left control point (*). This parameter is ignored if the nScaleType parameter above has been set to a value different from VOLUME_CURVE_CUSTOM.

nRightX

The horizontal position, expressed in percentage of the custom curve designer's area, of the right control point (*). This parameter is ignored if the nScaleType parameter above has been set to a value different from VOLUME_CURVE_CUSTOM.

nRightY

The vertical position, expressed in percentage of the custom curve designer's area, of the right control point (*). This parameter is ignored if the nScaleType parameter above has been set to a value different from VOLUME_CURVE_CUSTOM.

 

(*) The custom curve designer manages a windowed control, whose visual aspect can be defined programmatically, which allows designing volume curves based upon Bézier curves whose shape is defined through the manual positioning of 2 control points (displayed in cyan color on the graphic below). For further information about the use of the embedded CurveDesigner refer to the tutorial How to create custom volume curves.

 

 

 

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.