|
WANALYZER_HORIZONTAL_LINE structure |
  
|
|
WANALYZER_HORIZONTAL_LINE structure |
|
The WANALYZER_HORIZONTAL_LINE structure describes settings applied to a horizontal line added to the Waveform Analyzer through the WaveformAnalyzer.GraphicItemHorizontalLineAdd. The current settings can be retrieved through the WaveformAnalyzer.GraphicItemHorizontalLineParamsGet method and modified through the WaveformAnalyzer.GraphicItemHorizontalLineParamsSet method.
For details about the use of the Waveform Analyzer refer to the How to use the Waveform Analyzer section.
For further details about methods of the Waveform Analyzer refer to the WaveformAnalyzer object section.
Visual C++ definition
typedef struct
{
OLE_COLOR color;
long nChannel;
long nDashStyle;
short nHeightInPix;
short nTranspFactor;
short nVertPosInPerc;
long nLeftCap;
long nRightCap;
long nDashCap;
} WANALYZER_HORIZONTAL_LINE;
This data structure is defined inside the AdjMmsEngDef.h header file which can be found inside the product's Include directory (default \Program files\MultiMedia Soft\Active Sound Recorder\include).
Visual Basic definition
Public Type WANALYZER_HORIZONTAL_LINE
color As OLE_COLOR
nChannel As enumHorizontalLineChannel
nDashStyle As enumWaveformLineDashStyles
nHeightInPix As Integer
nTranspFactor As Integer
nVertPosInPerc As Integer
End Type
This data structure is defined inside the AdjMmsEngDef.bas module file which can be found inside the product's Include directory (default \Program files\MultiMedia Soft\Active Sound Recorder\include).
Member |
Description |
||||||||||||||||||||||||
|
|
||||||||||||||||||||||||
Color used for rendering the line. |
|||||||||||||||||||||||||
Audio channel on which the horizontal line is drawn. Supported values are the following:
|
|||||||||||||||||||||||||
Line dash style. Supported values are the following:
On the screenshot below you can see the different types of horizontal lines with the corresponding value displayed on the buddy text:
|
|||||||||||||||||||||||||
Height of the line expressed in pixels. |
|||||||||||||||||||||||||
Transparent factor. This value can range from 0 (total opacity) to 255 (total transparency). Values outside of this range will be automatically capped to the nearest valid value. |
|||||||||||||||||||||||||
Vertical position of the line expressed in percentage of wave amplitude. May assume values from -100 to 100: a negative value indicates that the line should be drawn over negative waveform peaks. In case you should be willing the set the line position based upon a logarithmic scale, you could convert your value in dB to a value in percentage using the following formula: ValueInPerc = 100 * pow (10, ValueInDB/20);
On the screenshot below you can see 3 horizontal lines, 2 on positive peaks, respectively at 70% and 25% of the waveform amplitude, and one on negative peaks at -80% of the waveform amplitude.
|
|||||||||||||||||||||||||
Type of cap for the left end of the line. Supported values are the following:
On the screenshot below you can see the different types of line caps with the corresponding value displayed on the buddy text:
|
|||||||||||||||||||||||||
Type of cap for the right end of the line. Supported values are the same as seen for the nLeftCap field above. |
|||||||||||||||||||||||||
Type of dash/dot cap for the line. Supported values are the following:
On the screenshot below you can see the different types of line dash caps with the corresponding value displayed on the buddy text:
|
