Copyright © 2001-2023 MultiMedia Soft

TracksBoard.ItemVolumePointAmplitudeGet method

Previous pageReturn to chapter overviewNext page

Remarks

 

Obtains the amplitude of a specific volume point previously added to the given sound item through the TracksBoard.ItemVolumePointAdd method. The amplitude of the volume point can be modified through the TracksBoard.ItemVolumePointAmplitudeSet method or, on the TracksBoard user interface, through mouse interaction.

 

 

For details about the use of the TracksBoard refer to the How to use the TracksBoard to visually compose songs tutorial.

For further details about methods of the TracksBoard refer to the TracksBoard class section.

 

 

Syntax

 

[Visual Basic]

control.TracksBoard.ItemVolumePointAmplitudeGet (

nUniqueId as Long,

nIndex as Long,

ByRef fAmplitude as Single

) as enumErrorCodes


 

[C++]

short control.TracksBoard.ItemVolumePointAmplitudeGet (

long nUniqueId,

long nIndex,

float *fAmplitude

);


 

Parameter

Description

 

 

nUniqueId

Unique identification number assigned to the sound item after being generated by one of the following methods:

TracksBoard.ItemClone when an existing item has been cloned

nIndex

Zero-based index of the volume point. The total number of available volume points can be obtained through the TracksBoard.ItemVolumePointCountGet method.

fAmplitude

Reference that, on return from the method call, will contain the amplitude of the volume point.

Can be a number within the range 0.0 - 2.0; values outside this range will be automatically cut to the nearest accepted value.

- value 0.0 mutes the sound

- values higher than 0.0 and lower than 1.0 attenuate the sound volume

- value 1.0 sets the sound at full volume

- values higher than 1.0 up to 2.0 amplify the sound volume

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred, check the LastError property value in order to get the error code

enumErrorCodes.ERR_NOERROR (0)

The method call was successful