Remarks
Creates a view (in form of memory bitmap referenced by a HBITMAP) of the waveform for the sound loaded inside the given player: the view can represent the full sound's waveform or portions of it.
Before calling this method it's mandatory performing a previous sound's analysis through a call to the Waveform.AnalyzeFullSound method and waiting its completion through the WaveAnalysisDone event.
For further details about generating a waveform bitmap of the loaded sound, before starting its playback, refer to the How to obtain the sound's waveform tutorial.
Syntax
[Visual Basic]
control.Waveform.BitmapViewSaveToMemory (
nPlayer as Integer,
nStartPos as Long,
nEndPos as Long,
nBitmapWidth as Integer,
nBitmapHeight as Integer,
nWaveformType as enumWaveformTypes
) as Long
|
|
[C++]
long control.Waveform.BitmapViewSaveToMemory (
short nPlayer,
long nStartPos,
long nEndPos,
long nBitmapWidth,
long nBitmapHeight,
short nWaveformType
);
|
|
Parameter
|
Description
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will use the Waveform
|
nStartPos
|
Number representing the sound's position, expressed in milliseconds, where the waveform visualization begins.
The value 0 represents the sound's beginning.
|
nEndPos
|
Number representing the sound's position, expressed in milliseconds, where the waveform visualization ends.
The value -1 represents the sound's end.
|
nBitmapWidth
|
Number representing the generated bitmap width, expressed in pixels. A value of -1 indicates no width constraints: in this case the control will generate a bitmap large enough in order to contain the full sound's waveform.
|
nBitmapHeight
|
Number representing the generated bitmap height, expressed in pixels.
|
nWaveformType
|
The type of rendered waveform, related to the sound's channels.
Supported values are the following:
Mnemonic value
|
Value
|
Meaning
|
WAVEFORM_TYPE_LEFT
|
0
|
The bitmap contains sound data for the left channel
|
WAVEFORM_TYPE_RIGHT
|
1
|
The bitmap contains sound data for the right channel
|
WAVEFORM_TYPE_MIXED
|
2
|
The bitmap contains sound data for left and right mixed channels
|
|
Return value
Value
|
Meaning
|
|
|
0
|
An error occurred (check the LastError property for error details)
|
Value is not 0
|
The method call was successful and the returned value represents the handle (HBITMAP) of the waveform's bitmap stored in memory. When the returned HBITMAP is no more needed or before exiting the container application, in order to avoid memory leaks this handle should be deleted using the DeleteObject Windows API.
|
|
