1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the examples of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:BSD$

    10 ** You may use this file under the terms of the BSD license as follows:

    11 **

    12 ** Redistribution and use in source and binary forms, with or without

    13 ** modification, are permitted provided that the following conditions are met:

    14 ** - Redistributions of source code must retain the above copyright notice,

    15 **   this list of conditions and the following disclaimer.

    16 ** - Redistributions in binary form must reproduce the above copyright notice,

    17 **   this list of conditions and the following disclaimer in the documentation

    18 **   and/or other materials provided with the distribution.

    19 ** - Neither the name of Nokia Corporation and its Subsidiary(-ies) nor the

    20 **   names of its contributors may be used to endorse or promote products

    21 **   derived from this software without specific prior written permission.

    22 **

    23 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

    24 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

    25 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

    26 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE

    27 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

    28 ** CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

    29 ** SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

    30 ** INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

    31 ** CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

    32 ** ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

    33 ** POSSIBILITY OF SUCH DAMAGE.

    34 ** $QT_END_LICENSE$

    35 **

    36 *****************************************************************************/

    37 

    38 #ifndef SPECTROGRAPH_H

    39 #define SPECTROGRAPH_H

    40 

    41 #include <QWidget>

    42 #include "frequencyspectrum.h"

    43 

    44 class QMouseEvent;

    45 

    46 /**

    47  * Widget which displays a spectrograph showing the frequency spectrum

    48  * of the window of audio samples most recently analysed by the Engine.

    49  */

    50 class Spectrograph : public QWidget {

    51     Q_OBJECT

    52 public:

    53     Spectrograph(QWidget *parent = 0);

    54     ~Spectrograph();

    55 

    56     void setParams(int numBars, qreal lowFreq, qreal highFreq);

    57 

    58     // QObject

    59     void timerEvent(QTimerEvent *event);

    60 

    61     // QWidget

    62     void paintEvent(QPaintEvent *event);

    63     void mousePressEvent(QMouseEvent *event);

    64 

    65 signals:

    66     void infoMessage(const QString &message, int intervalMs);

    67 

    68 public slots:

    69     void reset();

    70     void spectrumChanged(const FrequencySpectrum &spectrum);

    71 

    72 private:

    73     int barIndex(qreal frequency) const;

    74     QPair<qreal, qreal> barRange(int barIndex) const;

    75     void updateBars();

    76 

    77     void selectBar(int index);

    78 

    79 private:

    80     struct Bar {

    81         Bar() : value(0.0), clipped(false) { }

    82         qreal   value;

    83         bool    clipped;

    84     };

    85 

    86     QVector<Bar>        m_bars;

    87     int                 m_barSelected;

    88     int                 m_timerId;

    89     qreal               m_lowFreq;

    90     qreal               m_highFreq;

    91     FrequencySpectrum   m_spectrum;

    92 

    93 

    94 };

    95 

    96 #endif // SPECTROGRAPH_H