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]
Public Function BitmapViewSaveToMemory (
nPlayerIndex as Int16,
nStartPos as Int32,
nEndPos as Int32,
nBitmapWidth as Int32,
nBitmapHeight as Int32,
nWaveformType as enumWaveformTypes
) as IntPtr
|
|
[C#]
public IntPtr BitmapViewSaveToMemory (
Int16 nPlayerIndex,
Int32 nStartPos,
Int32 nEndPos,
Int32 nBitmapWidth,
Int32 nBitmapHeight,
enumWaveformTypes nWaveformType
);
|
|
[C++]
public: IntPtr BitmapViewSaveToMemory (
Int16 nPlayerIndex,
Int32 nStartPos,
Int32 nEndPos,
Int32 nBitmapWidth,
Int32 nBitmapHeight,
enumWaveformTypes nWaveformType
);
|
|
Parameter
|
Description
|
|
|
nPlayerIndex
|
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
|
|
