Methods > Playlists > PlayListItemVolAutomSetMixPos method

Remarks

Set volume automation mixing positions to an item of the playlist.

This method will return an error if the playlist has not been created with the PlayListCreate method or loaded with the PlayListLoad or PlayListLoadSync methods having the nMode parameter set to PLAYLIST_AUTOMATION_MODE.

For further details about playlists management see the How to create and manage a playlist tutorial.

For details about using Volume Automation refer to the How to manage Volume Automation tutorial.

Syntax

[Visual Basic]

Public Function PlayListItemVolAutomSetMixPos (

nPlayerIndex as Int16,

nItem as Int16,

nPositionUnit as enumVolumeAutomationPositionUnits,

fStartPos as Single,

fMixPos as Single,

fEndPos as Single

) as enumErrorCodes

[C#]

public enumErrorCodes PlayListItemVolAutomSetMixPos (

Int16 nPlayerIndex,

Int16 nItem,

enumVolumeAutomationPositionUnits nPositionUnit,

float fStartPos,

float fMixPos,

float fEndPos

);

[C++]

public: enumErrorCodes PlayListItemVolAutomSetMixPos (

Int16 nPlayerIndex,

Int16 nItem,

enumVolumeAutomationPositionUnits nPositionUnit,

float fStartPos,

float fMixPos,

float fEndPos

);

Parameter

Description

nPlayerIndex

Number representing the zero-based index of the involved player

nItem

Number representing the zero-based index of the item inside the playlist

nPositionUnit

The unit used to define the position of the cue point through the fPosition parameter below.

Supported values are the following:

Mnemonic constant	Value	Meaning
VA_POS_UNIT_SECONDS	0	Position is expressed in seconds
VA_POS_UNIT_PERCENTAGE	1	Position is expressed in percentage
VA_POS_UNIT_MILLISECONDS	2	Position is expressed in milliseconds

fStartPos

Number representing the start position expressed in nPositionUnit. This parameter is the equivalent of the StartPosSec/StartPosMs/StartPosPerc attributes of the Item sub-key of the PDJ format.

fMixPos

Number representing the mixing position expressed in nPositionUnit. This parameter is the equivalent of the MixPosSec/MixPosMs/MixPosPerc attributes of the Item sub-key of the PDJ format.

fEndPos

Number representing the end position expressed in nPositionUnit. This parameter is the equivalent of the EndPosSec/EndPosMs/EndPosPerc attributes of the Item sub-key of the PDJ format.

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.