TracksBoard.ItemWaveColorsGet method |
|
Remarks
If previously modified through the TracksBoard.ItemWaveColorsSet method, obtains colors used to render the item's waveform, its amplitude line and its volume points.
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.ItemWaveColorsGet ( nUniqueId as Long, colorWaveLineCenter as OLE_COLOR, colorWaveLinePeak as OLE_COLOR, colorVolumePointsLine as OLE_COLOR, colorVolumePoints as OLE_COLOR, colorVolumePointsSelected as OLE_COLOR, colorAmplitudeLine as OLE_COLOR ) as enumErrorCodes |
[C++] short control.TracksBoard.ItemWaveColorsGet ( long nUniqueId, OLE_COLOR *colorWaveLineCenter, OLE_COLOR *colorWaveLinePeak, OLE_COLOR *colorVolumePointsLine, OLE_COLOR *colorVolumePoints, OLE_COLOR *colorVolumePointsSelected, OLE_COLOR *colorAmplitudeLine ); |
Parameter |
Description |
||||||
|
|
||||||
nUniqueId |
Unique identification number assigned to the sound item after being generated by one of the following methods:
|
||||||
colorWaveLineCenter |
Reference that, on return from the method call, will contain the color used for rendering the center of the waveform line; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorWaveLineCenter field of the TRACKSBOARD_WAVEFORM_SETTINGS data structure |
||||||
colorWaveLinePeak |
Reference that, on return from the method call, will contain the color used for rendering peaks of the waveform line; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorWaveLinePeak field of the TRACKSBOARD_WAVEFORM_SETTINGS data structure |
||||||
colorVolumePointsLine |
Reference that, on return from the method call, will contain the color used for rendering the line connecting available volume points; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorVolumePointsLine field of the TRACKSBOARD_ITEM_SETTINGS data structure |
||||||
colorVolumePoints |
Reference that, on return from the method call, will contain the color used for rendering available volume points; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorVolumePoints field of the TRACKSBOARD_ITEM_SETTINGS data structure |
||||||
colorVolumePointsSelected |
Reference that, on return from the method call, will contain the color used for rendering the selected volume point; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorVolumePointsSelected field of the TRACKSBOARD_ITEM_SETTINGS data structure |
||||||
colorAmplitudeLine |
Reference that, on return from the method call, will contain the color used for rendering the amplitude line; a returned value -1 means that this color has not been modified through a previous call to the TracksBoard.ItemWaveColorsSet method and that the rendering is performed through the default color set into the colorAmplitudeLine field of the TRACKSBOARD_ITEM_SETTINGS data structure |
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 |