Copyright © 2008-2023 MultiMedia Soft

SPECTR_ENH_GENERAL_SETTINGS structure

Previous pageReturn to chapter overviewNext page

The SPECTR_ENH_GENERAL_SETTINGS data structure describes the general graphical settings applied to a specific enhanced spectrum analyzer. The current settings can be obtained through the SpectrumEnh.SettingsGeneralGet method and modified through the SpectrumEnh.SettingsGeneralSet method.

 

For further details about using the Enhanced Spectrum Analyzer refer to the SpectrumEnh section.

For details about using the Enhanced Spectrum Analyzer refer to the How to use the Enhanced Spectrum Analyzer tutorial.

 

Visual C++ definition

 

typedef struct

{

 short     bAppearance3d;

 long       nResolution;

 long       nGraphType;

 long       nFFTWindowType;

 short     bFreqGridVisible;

 short     bDbGridVisible;

 short     bSubGridVisible;

 short     bBackBitmapVisible;

 short     bBackBitmapStretch;

 OLE_COLOR colorBackground;

 OLE_COLOR colorFreqGrid;

 OLE_COLOR colorDbGrid;

 OLE_COLOR colorSubGrid;

} SPECTR_ENH_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 Editor\include).

 

 

Visual Basic definition

 

Public Type SPECTR_ENH_GENERAL_SETTINGS

bAppearance3d As Boolean

nResolution As Long

nGraphType As enumSpectrumEnhTypes

nFFTWindowType As enumSpectrumEnhWindowTypes

bFreqGridVisible As Boolean

bDbGridVisible As Boolean

bSubGridVisible As Boolean

bBackBitmapVisible As Boolean

bBackBitmapStretch As Boolean

colorBackground As OLE_COLOR

colorFreqGrid As OLE_COLOR

colorDbGrid As OLE_COLOR

colorSubGrid As OLE_COLOR

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 Editor\include).

 

 

Member

Description

 

 

bAppearance3d

Boolean value that specifies if the spectrum analyzer is displayed with 3D borders.

Supported values are the following:

Value

Meaning

false

Doesn't display 3D borders

true (default)

Displays 3D borders

nResolution

Resolution in bytes of audio PCM data for FFT calculation (the value must be power of 2). Default is set to 2048 bytes.

nGraphType

Type of graphic representation.

Supported values are the following:

Mnemonic constant

Numeric value

Meaning

SPECTR_ENH_LINE_LEFT_TOP (default)

0

Line with left channel on top

SPECTR_ENH_LINE_RIGHT_TOP

1

Line with right channel on top

SPECTR_ENH_AREA_LEFT_TOP

2

Area with left channel on top

SPECTR_ENH_AREA_RIGHT_TOP

3

Area with right channel on top

SPECTR_ENH_BARS_LEFT_TOP

4

Bars with left channel on top

SPECTR_ENH_BARS_RIGHT_TOP

5

Bars with right channel on top

SPECTR_ENH_SPECTRAL_VIEW

6

Spectral view

nFFTWindowType

Type of window for FFT calculation.

Supported values are the following:

Mnemonic constant

Numeric value

Meaning

SPECTR_ENH_FFT_WINDOW_RECTANGULAR

0

Rectangular window

SPECTR_ENH_FFT_WINDOW_HAMMING

1

Hamming window

SPECTR_ENH_FFT_WINDOW_HANN

2

Hann window

SPECTR_ENH_FFT_WINDOW_COSINE

3

Cosine window

SPECTR_ENH_FFT_WINDOW_LANCZOS

4

Lanczos window

SPECTR_ENH_FFT_WINDOW_BARTLETT

5

Bartlett window

SPECTR_ENH_FFT_WINDOW_TRIANGULAR

6

Triangular window

SPECTR_ENH_FFT_WINDOW_GAUSS

7

Gauss window

SPECTR_ENH_FFT_WINDOW_BARTLETT_HANN

8

Bartlett-Hann window

SPECTR_ENH_FFT_WINDOW_BLACKMAN

9

Blackman window

SPECTR_ENH_FFT_WINDOW_NUTTALL

10

Nutall window

SPECTR_ENH_FFT_WINDOW_BLACKMAN_HARRIS

(default)

11

Harris window

SPECTR_ENH_FFT_WINDOW_BLACKMAN_NUTTALL

12

Blackman-Nutall window

SPECTR_ENH_FFT_WINDOW_FLAT_TOP

13

Flat top window

bFreqGridVisible

Boolean value that specifies if the frequency grid is visible.

Supported values are the following:

Value

Meaning

false

Doesn't display the frequency grid

true (default)

Displays the frequency grid

bDbGridVisible

Boolean value that specifies if the decibels grid is visible.

Supported values are the following:

Value

Meaning

false

Doesn't display the decibels grid

true (default)

Displays the decibels grid

bSubGridVisible

Boolean value that specifies if sub-grids are visible.

Supported values are the following:

Value

Meaning

false

Doesn't display sub-grids

true (default)

Displays sub-grids

bBackBitmapVisible

Boolean value that specifies if an eventual background image (bitmap) is visible.

Supported values are the following:

Value

Meaning

false

Doesn't display the background image

true (default)

Displays the background image

bBackBitmapStretch

Boolean value that specifies if an eventual background image (bitmap) should be stretched to fit the spectrum analyzer background area.

Supported values are the following:

Value

Meaning

false (default)

Doesn't stretch the background image

true

Stretches the background image

colorBackground

The color used for rendering the background of the spectrum analyzer.

colorFreqGrid

The color used for rendering the frequency grid

colorDbGrid

The color used for rendering the decibels grid

colorSubGrid

The color used for rendering sub-grids

 

Below you can see a zoomed image of the enhanced spectrum analyzer evidencing some of the configurable elements: