COM Objects > WaveformAnalyzer object > Data structures > WANALYZER_GENERAL

The WANALYZER_GENERAL_SETTINGS structure describes the general settings applied to the Waveform Analyzer. The current settings can be retrieved through the WaveformAnalyzer.SettingsGeneralGet method and modified through the WaveformAnalyzer.SettingsGeneralSet 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

{

short bAppearance3d;

long nResolution;

float fHorizontalZoomFactor;

float fVerticalZoomFactor;

short nPositionLineWidth;

long nPositionLineDashStyle;

OLE_COLOR colorPositionLine;

short bPlaybackLineVisible;

short nPlaybackLineWidth;

long nPlaybackLineDashStyle;

OLE_COLOR colorPlaybackLine;

long nPositionLineHighCap;

long nPositionLineLowCap;

long nPositionLineDashCap;

short nPositionLineTranspFactor;

long nPlaybackLineHighCap;

long nPlaybackLineLowCap;

long nPlaybackLineDashCap;

short nPlaybackLineTranspFactor;

short bVerticalLinesOnTimeRuler;

short bAutoRefresh;

} WANALYZER_GENERAL_SETTINGS;

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_GENERAL_SETTINGS

bAppearance3d as Boolean

nResolution as enumAnalyzerResolutions

fHorizontalZoomFactor as Single

fVerticalZoomFactor as Single

nPositionLineWidth as Integer

nPositionLineDashStyle as enumWaveformLineDashStyles

colorPositionLine as OLE_COLOR

bPlaybackLineVisible as Boolean

nPlaybackLineWidth as Integer

nPlaybackLineDashStyle as enumWaveformLineDashStyles

colorPlaybackLine as OLE_COLOR

nPositionLineHighCap as enumLineCaps

nPositionLineLowCap as enumLineCaps

nPositionLineDashCap as enumLineDashCaps

nPositionLineTranspFactor as Integer

nPlaybackLineHighCap as enumLineCaps

nPlaybackLineLowCap as enumLineCaps

nPlaybackLineDashCap as enumLineDashCaps

nPlaybackLineTranspFactor as Integer

bVerticalLinesOnTimeRuler as Boolean

bAutoRefresh as Boolean

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

bAppearance3d

Boolean value that specifies if the Waveform Analyzer is displayed with 3D borders.

asrec_i00007c

Supported values are the following:

Mnemonic constant	Meaning
False	Doesn't display 3D borders
True	Displays 3D borders

nResolution

Resolution used for waveform's analysis.

Supported values are the following:

Mnemonic constant	Value	Meaning
WAVEANALYZER_RES_MINIMUM	100	Minimum resolution, faster calculation time. Each line on the analyzer is the average for 256 PCM samples.
WAVEANALYZER_RES_VERY_LOW	101	Very low resolution. Each line on the analyzer is the average for 128 PCM samples.
WAVEANALYZER_RES_LOW	102	Low resolution. Each line on the analyzer is the average for 64 PCM samples.
WAVEANALYZER_RES_MIDDLE	103	Middle resolution. Each line on the analyzer is the average for 32 PCM samples.
WAVEANALYZER_RES_HIGH	104	High resolution. Each line on the analyzer is the average for 16 PCM samples.
WAVEANALYZER_RES_VERY_HIGH	105	Very high resolution. Each line on the analyzer is the average for 8 PCM samples.
WAVEANALYZER_RES_MAXIMUM	106	Maximum resolution, slower calculation time. Each line on the analyzer is the average for 4 PCM samples.

fHorizontalZoomFactor

Floating point value indicating the factor applied to zooming operations: by default the zoom factor is 2.0.

The value of this field cannot be lower than 1.01. Smaller values will be automatically capped to 1.01.

fVerticalZoomFactor

Factor applied to vertical zooming operations. can assume values ranging from 0.5 to 5. Values outside of this range will be automatically capped to the nearest valid value.

- Values smaller than 1 will vertically zoom-out the waveform, reducing its vertical size

- Value 1 will display the waveform without zooming (default)

- Values higher than 1 will vertically zoom-in the waveform, increasing its vertical size

nPositionLineWidth

Width in pixels of the line that indicates a selected position on the waveform

nPositionLineDashStyle

Dash style of the line that indicates a selected position on the waveform.

Supported values are the following:

Mnemonic constant	Value	Meaning
LINE_DASH_STYLE_SOLID	0	Solid line.
LINE_DASH_STYLE_DASH	1	Dashed line.
LINE_DASH_STYLE_DOT	2	Dotted line.
LINE_DASH_STYLE_DASH_DOT	3	Alternating dash-dot line line.
LINE_DASH_STYLE_DASH_DOT_DOT	4	Alternating dash-dot-dot line line.

On the screenshot below you can see the different dash styles with the corresponding value displayed:

colorPositionLine

Color used for rendering the line that indicates a selected position on the waveform.

bPlaybackLineVisible

Boolean value that specifies if the line that indicates the playback position is visible during a playback session.

Supported values are the following:

Mnemonic constant	Meaning
False	Doesn't display the position line during playback
True	Displays the position line during playback

nPlaybackLineWidth

Width in pixels of the playback line

nPlaybackLineDashStyle

Dash style of the line that indicates the playback position on the waveform during a playback session.

Supported values are the same as seen for the nPositionLineDashStyle field above.

colorPlaybackLine

Color used for rendering the line that indicates the playback position on the waveform during a playback session.

nPositionLineHighCap

Type of cap for the high end of the position line.

Supported values are the following:

Mnemonic constant	Value	Meaning
LINE_CAP_SQUARE	0	Specifies a square cap.
LINE_CAP_ROUND	1	Specifies a circular cap.
LINE_CAP_TRIANGLE	2	Specifies a triangular cap.
LINE_CAP_SQUARE_ANCHOR	3	Specifies that the line ends are anchored with a square.
LINE_CAP_ROUND_ANCHOR	4	Specifies that the line ends are anchored with a circle.
LINE_CAP_DIAMOND_ANCHOR	5	Specifies that the line ends are anchored with a diamond.
LINE_CAP_ARROW_ANCHOR	6	Specifies that the line ends are anchored with arrowheads.

On the screenshot below you can see the different types of line caps with the corresponding value displayed:

nPositionLineLowCap

Type of cap for the low end of the position line.

Supported values are the same as seen for the nPositionLineHighCap field above.

nPositionLineDashCap

Type of dash/dot cap for the position line.

Supported values are the following:

Mnemonic constant	Value	Meaning
LINE_DASH_CAP_FLAT	0	Specifies a square cap that squares off both ends of each dash.
LINE_DASH_CAP_ROUND	1	Specifies a circular cap that rounds off both ends of each dash.
LINE_DASH_CAP_TRIANGLE	2	Specifies a triangular cap that points both ends of each dash.

On the screenshot below you can see the different types of line dash caps with the corresponding value displayed:

nPositionLineTranspFactor

Transparent factor applied to the position line.

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.

nPlaybackLineHighCap

Type of cap for the high end of the playback line.

Supported values are the same as seen for the nPositionLineHighCap field above.

nPlaybackLineLowCap

Type of cap for the low end of the playback line.

Supported values are the same as seen for the nPositionLineHighCap field above.

nPlaybackLineDashCap

Type of dash/dot cap for the playback line.

Supported values are the same as seen for the nPositionLineDashCap field above.

nPlaybackLineTranspFactor

Transparent factor applied to the playback line.

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.

bVerticalLinesOnTimeRuler

Boolean value that specifies if caps of vertical lines must be rendered over time rulers.

Supported values are the following:

Mnemonic constant	Meaning
False (default)	Caps of vertical lines must be rendered over time rulers.
True	Caps of vertical lines must be rendered over the waveform are without exceeding over time rulers..

bAutoRefresh

Boolean value that specifies if the waveform is refreshed automatically during the analysis phase.

Supported values are the following:

Mnemonic constant	Meaning
False (default)	Auto-refresh is disabled.
True	Auto-refresh is enabled. This setting doesn't apply when the WaveformAnalyzer.ViewModeSet method has been invoked with the nMode parameter set to WANALYZER_VIEW_MODE_SPECTRAL.