Copyright © 2011-2018 MultiMedia Soft

SPECTR_ENH_GENERAL_SETTINGS structure

Previous pageReturn to chapter overviewNext page

The SPECTR_ENH_GENERAL_SETTINGS structure (defined as SPECTR_ENH_GENERAL_SETTINGS_DLL when used for COM interoperability) 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 embedded Enhanced Spectrum Analyzer refer to the SpectrumEnh class section.

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

 

C# definition

 

public struct SPECTR_ENH_GENERAL_SETTINGS

{

 public bool                       bAppearance3d;

 public Int32                       nResolution;

 public enumSpectrumEnhTypes       nGraphType;

 public enumSpectrumEnhWindowTypes nFFTWindowType;

 public bool                       bFreqGridVisible;

 public bool                       bDbGridVisible;

 public bool                       bSubGridVisible;

 public bool                       bBackBitmapVisible;

 public bool                       bBackBitmapStretch;

 public Color                       colorBackground;

 public Color                       colorFreqGrid;

 public Color                       colorDbGrid;

 public Color                       colorSubGrid;

}

 

Definition for COM Interoperability

 

public struct SPECTR_ENH_GENERAL_SETTINGS_DLL

{

 public Int16                       bAppearance3d;

 public Int32                       nResolution;

 public Int32                     nGraphType;

 public Int32                     nFFTWindowType;

 public Int16                       bFreqGridVisible;

 public Int16                       bDbGridVisible;

 public Int16                       bSubGridVisible;

 public Int16                       bBackBitmapVisible;

 public Int16                       bBackBitmapStretch;

 public Int32                     colorBackground;

 public Int32                     colorFreqGrid;

 public Int32                     colorDbGrid;

 public Int32                     colorSubGrid;

}

 

 

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 with some of the configurable elements evidenced: