PlayListItemVolAutomPointParamsGet method |
|
Remarks
Obtains parameters of an existing volume point of a playlist's item. The volume point can have been previously added through the PlayListItemVolAutomPointAdd method or as a result of a playlist loading through the PlayListLoad method.
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] control.PlayListItemVolAutomPointParamsGet ( nPlayer as Integer, nItem as Integer, strVolumePointName as String, nPositionUnit as enumVolumeAutomationPosUnits, fPosition as Single, nVolumeScaleType as enumVolumeScales, fVolumeLevel as Single, nCurveType as enumVolumeCurves, nDesignerUniqueId as Long ) as enumErrorCodes |
[C++] short control.PlayListItemVolAutomPointParamsGet ( short nPlayer, short nItem, LPCTSTR strVolumePointName, short nPositionUnit, float *fPosition, short nVolumeScaleType, float *fVolumeLevel, short *nCurveType, short *nLeftX, short *nLeftY, short *nRightX, short *nRightY ); |
Parameter |
Description |
|||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||
nPlayer |
Number representing the zero-based index of the involved player. |
|||||||||||||||||||||||||||
nItem |
Number representing the zero-based index of the item inside the playlist. The number of available items can be obtained using the PlayListGetCount method. |
|||||||||||||||||||||||||||
strVolumePointName |
String representing the friendly name of the volume point to modify |
|||||||||||||||||||||||||||
nPositionUnit |
The unit used to define positions of volume points. Supported values are the following:
|
|||||||||||||||||||||||||||
fPosition |
Reference that, on return from the method call, will contain the position of the volume point expressed in the same unit set into the nPositionUnit parameter. |
|||||||||||||||||||||||||||
nVolumeScaleType |
The volume scaling type. Supported values are the following:
|
|||||||||||||||||||||||||||
fVolumeLevel |
Reference that, on return from the method call, will contain the volume level expressed in the same unit set into the nVolumeScaleType parameter. |
|||||||||||||||||||||||||||
nCurveType |
Reference that, on return from the method call, will contain the type of curve applied to reach the next volume point. Set this parameter to -1 if you need to leave the current curve type unchanged. Supported values are the following:
|
|||||||||||||||||||||||||||
nLeftX |
Reference that, on return from the method call, will contain the horizontal position, expressed in percentage of the designer's area, of the left control point. This parameter can be ignored when the nCurveType parameter above is set to a value different from VOLUME_CURVE_CUSTOM. |
|||||||||||||||||||||||||||
nLeftY |
Reference that, on return from the method call, will contain the vertical position, expressed in percentage of the designer's area, of the left control point. This parameter can be ignored when the nCurveType parameter above is set to a value different from VOLUME_CURVE_CUSTOM. |
|||||||||||||||||||||||||||
nRightX |
Reference that, on return from the method call, will contain the horizontal position, expressed in percentage of the designer's area, of the right control point. This parameter can be ignored when the nCurveType parameter above is set to a value different from VOLUME_CURVE_CUSTOM. |
|||||||||||||||||||||||||||
nRightY |
Reference that, on return from the method call, will contain the vertical position, expressed in percentage of the designer's area, of the right control point This parameter can be ignored when the nCurveType parameter above is set to a value different from VOLUME_CURVE_CUSTOM. |
Return value
Value |
Meaning |
|
|
enumErrorCodes.NOERROR (0) |
The method call was successful |
Negative value |
An error occurred: see the LastError property for further error details or for a list of the possible error values. |