sdrangel/sdrbase/dsp/spectrumsettings.h

///////////////////////////////////////////////////////////////////////////////////
// Copyright (C) 2012 maintech GmbH, Otto-Hahn-Str. 15, 97204 Hoechberg, Germany //
// written by Christian Daniel                                                   //
// Copyright (C) 2015-2022 Edouard Griffiths, F4EXB <f4exb06@gmail.com>          //
// Copyright (C) 2022-2026 Jon Beniston, M7RCE <jon@beniston.com>                //
//                                                                               //
// This program is free software; you can redistribute it and/or modify          //
// it under the terms of the GNU General Public License as published by          //
// the Free Software Foundation as version 3 of the License, or                  //
// (at your option) any later version.                                           //
//                                                                               //
// This program is distributed in the hope that it will be useful,               //
// but WITHOUT ANY WARRANTY; without even the implied warranty of                //
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                  //
// GNU General Public License V3 for more details.                               //
//                                                                               //
// You should have received a copy of the GNU General Public License             //
// along with this program. If not, see <http://www.gnu.org/licenses/>.          //
///////////////////////////////////////////////////////////////////////////////////

#ifndef SDRBASE_DSP_SPECTRUMSETTNGS_H
#define SDRBASE_DSP_SPECTRUMSETTNGS_H

#include <QByteArray>
#include <QString>

#include "export.h"
#include "dsp/dsptypes.h"
#include "dsp/fftwindow.h"
#include "dsp/spectrummarkers.h"
#include "dsp/spectrumcalibrationpoint.h"
#include "settings/serializable.h"

class SDRBASE_API SpectrumSettings : public Serializable
{
public:

    enum AveragingMode
    {
        AvgModeNone,
        AvgModeMoving,
        AvgModeFixed,
        AvgModeMax,
        AvgModeMin
    };

    enum MathMode
    {
        MathModeNone,
        MathModeXMinusAvg,
        MathModeXMinusAvgDB,
        MathModeXMinusAvgPlusMinAvgDB,
        MathModeAbsXMinusAvgDB,
        MathModeXMinusM1,
        MathModeXMinusM1DB,
        MathModeAbsXMinusM1DB,
        MathModeXMinusM2,
        MathModeXMinusM2DB,
        MathModeAbsXMinusM2DB
    };

    // Bitmask for which selection of markers to display
    enum MarkersDisplay
    {
        MarkersDisplayNone = 0,
        MarkersDisplaySpectrum = 0x1,
        MarkersDisplayAnnotations = 0x2,
        MarkersDisplayAll = 0x3
    };

	enum CalibrationInterpolationMode
	{
		CalibInterpLinear, //!< linear power
		CalibInterpLog     //!< log power (dB linear)
	};

    enum SpectrogramStyle
    {
        Points,
        Lines,
        Solid,
        Outline,
        Shaded
    };

    enum SpectrumStyle
    {
        Line,
        Fill,
        Gradient
    };

    enum Measurement
    {
        MeasurementNone,
        MeasurementPeaks,
        MeasurementChannelPower,
        MeasurementAdjacentChannelPower,
        MeasurementOccupiedBandwidth,
        Measurement3dBBandwidth,
        MeasurementSNR,
        MeasurementMask
    };

    enum MeasurementsPosition {
        PositionAbove,
        PositionBelow,
        PositionLeft,
        PositionRight
    };

    enum WaterfallTimeUnits {
        TimeOffset,
        LocalTime,
        UTCTime
    };

    enum ShowControls {
        ShowMinimum,
        ShowStandard,
        ShowAll
    };

    struct SpectrumMemory {
        QList<Real> m_spectrum;
        bool m_display;
        QRgb m_color;
        QString m_label;

        QByteArray serialize() const;
        bool deserialize(const QByteArray& data);
    };

	int m_fftSize;
	int m_fftOverlap;
	FFTWindow::Function m_fftWindow;
	Real m_refLevel;
	Real m_powerRange;
	int m_fpsPeriodMs; //!< FPS capping period in ms FPS = 1000/m_fpsPeriodMs. If zero: no limit.
	int m_decay;
	int m_decayDivisor;
	int m_histogramStroke;
	int m_displayGridIntensity;
	int m_displayTraceIntensity;
	bool m_displayWaterfall;
	bool m_invertedWaterfall;
    Real m_waterfallShare;
    bool m_display3DSpectrogram;
	bool m_displayMaxHold;
	bool m_displayCurrent;
	bool m_displayHistogram;
	bool m_displayGrid;
    bool m_truncateFreqScale;
	AveragingMode m_averagingMode;
	int m_averagingIndex;
	unsigned int m_averagingValue;
	bool m_linear; //!< linear else logarithmic scale
    bool m_ssb;    //!< SSB display with spectrum center at start of array or display - else spectrum center is on center
    bool m_usb;    //!< USB display with increasing frequencies towads the right - else decreasing frequencies
	bool m_wsSpectrum;           //!< Start or stop websocket spectrum server
    QString m_wsSpectrumAddress; //!< websocket spectrum server address
    uint16_t m_wsSpectrumPort;   //!< websocket spectrum server port
	QList<SpectrumHistogramMarker> m_histogramMarkers;
	QList<SpectrumWaterfallMarker> m_waterfallMarkers;
	QList<SpectrumAnnotationMarker> m_annoationMarkers;
    bool m_findHistogramPeaks;
	MarkersDisplay m_markersDisplay;
	QList<SpectrumCalibrationPoint> m_calibrationPoints;
	bool m_useCalibration;
	CalibrationInterpolationMode m_calibrationInterpMode; //!< How is power interpolated between calibration points
    SpectrogramStyle m_3DSpectrogramStyle;
    QString m_colorMap;
    SpectrumStyle m_spectrumStyle;
    Measurement m_measurement;
    int m_measurementCenterFrequencyOffset;
    int m_measurementBandwidth;
    int m_measurementChSpacing;
    int m_measurementAdjChBandwidth;
    int m_measurementHarmonics;
    int m_measurementPeaks;
    bool m_measurementHighlight;
    MeasurementsPosition m_measurementsPosition;
    int m_measurementPrecision;
    enum ShowControls m_showControls;
    float m_frequencyZoomFactor;
    float m_frequencyZoomPos;
    WaterfallTimeUnits m_waterfallTimeUnits;
    QString m_waterfallTimeFormat; //!< E.g: "hh:mm:ss.zzz"
    bool m_scrollBar;
    int m_scrollLength;
    MathMode m_mathMode;
    unsigned int m_mathAvgCount;
    unsigned int m_measurementMemMasks; // Bitmask for each memory to be used as a mask
    bool m_displayRBW;
    bool m_displayCursorStats;
    bool m_displayPeakStats;
    QList<SpectrumMemory> m_spectrumMemory;
    QRgb m_spectrumColor;

    static const int m_maxSpectrumMemories = 2; // As we only have two buttons in GUI

	static const int m_log2FFTSizeMin = 6;   // 64
	static const int m_log2FFTSizeMax = 15;  // 32k

    SpectrumSettings();
	virtual ~SpectrumSettings();
    void resetToDefaults();
    void validateSpectrumMemories();

    virtual QByteArray serialize() const;
    virtual bool deserialize(const QByteArray& data);
    virtual void formatTo(SWGSDRangel::SWGObject *swgObject) const;
    virtual void updateFrom(const QStringList& keys, const SWGSDRangel::SWGObject *swgObject);

	QList<SpectrumHistogramMarker>& getHistogramMarkers() { return m_histogramMarkers; }
	QList<SpectrumWaterfallMarker>& getWaterfallMarkers() { return m_waterfallMarkers; }
    bool getHistogramFindPeaks() { return m_findHistogramPeaks; }
    bool mathAverageUsed() const;
    bool mathUsesDB() const;

    static int getAveragingMaxScale(AveragingMode averagingMode); //!< Max power of 10 multiplier to 2,5,10 base ex: 2 -> 2,5,10,20,50,100,200,500,1000
    static int getAveragingValue(int averagingIndex, AveragingMode averagingMode);
    static int getAveragingIndex(int averagingValue, AveragingMode averagingMode);
	static uint64_t getMaxAveragingValue(int fftSize, AveragingMode averagingMode);

private:
	static int qColorToInt(const QColor& color);
	static QColor intToQColor(int intColor);
};

#endif // SDRBASE_DSP_SPECTRUMSETTNGS_H