abstracttimelinemodel.h 4.91 KB
Newer Older
Christiaan Janssen's avatar
Christiaan Janssen committed
1
2
/****************************************************************************
**
3
** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
Christiaan Janssen's avatar
Christiaan Janssen committed
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
** Contact: http://www.qt-project.org/legal
**
** This file is part of Qt Creator.
**
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
****************************************************************************/

#ifndef ABSTRACTTIMELINEMODEL_H
#define ABSTRACTTIMELINEMODEL_H


#include "qmlprofiler_global.h"
#include "qmlprofilermodelmanager.h"
36
#include "qmlprofilerdatamodel.h"
Christiaan Janssen's avatar
Christiaan Janssen committed
37
38
39
40
41
42
43
44
45
46
47
#include <QObject>
#include <QVariant>
#include <QColor>

namespace QmlProfiler {

class QMLPROFILER_EXPORT AbstractTimelineModel : public QObject
{
    Q_OBJECT

public:
48
    class AbstractTimelineModelPrivate;
Christiaan Janssen's avatar
Christiaan Janssen committed
49
50
    ~AbstractTimelineModel();

51
    // Trivial methods implemented by the abstract model itself
Christiaan Janssen's avatar
Christiaan Janssen committed
52
    void setModelManager(QmlProfilerModelManager *modelManager);
53
    QString name() const;
54
    bool isEmpty() const;
Christiaan Janssen's avatar
Christiaan Janssen committed
55

56
57
    // Methods are directly passed on to the private model and relying on its virtual methods.
    Q_INVOKABLE qint64 lastTimeMark() const;
Christiaan Janssen's avatar
Christiaan Janssen committed
58
59
60
61
    Q_INVOKABLE qint64 traceStartTime() const;
    Q_INVOKABLE qint64 traceEndTime() const;
    Q_INVOKABLE qint64 traceDuration() const;
    Q_INVOKABLE int getState() const;
62
63
64
65
66
67
68
    Q_INVOKABLE qint64 getDuration(int index) const;
    Q_INVOKABLE qint64 getStartTime(int index) const;
    Q_INVOKABLE qint64 getEndTime(int index) const;
    int findFirstIndex(qint64 startTime) const;
    int findFirstIndexNoParents(qint64 startTime) const;
    int findLastIndex(qint64 endTime) const;
    int count() const;
69
70
71
72
    bool eventAccepted(const QmlProfilerDataModel::QmlEventData &event) const;
    bool expanded() const;
    void setExpanded(bool expanded);
    const QString title() const;
73
74

    // Methods that have to be implemented by child models
75
    virtual int rowCount() const = 0;
76
77
    Q_INVOKABLE virtual int getEventId(int index) const = 0;
    Q_INVOKABLE virtual QColor getColor(int index) const = 0;
78
    virtual const QVariantList getLabels() const = 0;
79
    Q_INVOKABLE virtual const QVariantList getEventDetails(int index) const = 0;
Christiaan Janssen's avatar
Christiaan Janssen committed
80
    virtual int getEventRow(int index) const = 0;
81
82
83
    virtual void loadData() = 0;
    virtual void clear() = 0;

84
    // Methods which can optionally be implemented by child models.
Christiaan Janssen's avatar
Christiaan Janssen committed
85
    // returned map should contain "file", "line", "column" properties, or be empty
86
87
88
89
90
    Q_INVOKABLE virtual const QVariantMap getEventLocation(int index) const;
    Q_INVOKABLE virtual int getEventIdForHash(const QString &eventHash) const;
    Q_INVOKABLE virtual int getEventIdForLocation(const QString &filename, int line, int column) const;
    Q_INVOKABLE virtual int getBindingLoopDest(int index) const;
    Q_INVOKABLE virtual float getHeight(int index) const;
Christiaan Janssen's avatar
Christiaan Janssen committed
91
92
93
94
95
96
97
98

signals:
    void dataAvailable();
    void stateChanged();
    void emptyChanged();
    void expandedChanged();

protected:
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
    enum BoxColorProperties {
        EventHueMultiplier = 25,
        FractionHueMultiplier = 96,
        FractionHueMininimum = 10,
        Saturation = 150,
        Lightness = 166
    };

    QColor getEventColor(int index) const
    {
        return getColorByHue(getEventId(index) * EventHueMultiplier);
    }

    QColor getFractionColor(double fraction) const
    {
        return getColorByHue(fraction * FractionHueMultiplier + FractionHueMininimum);
    }

    QColor getColorByHue(int hue) const
    {
        return QColor::fromHsl(hue % 360, Saturation, Lightness);
    }

122
    explicit AbstractTimelineModel(AbstractTimelineModelPrivate *dd, const QString &name,
123
124
                                   const QString &label, QmlDebug::Message message,
                                   QmlDebug::RangeType rangeType, QObject *parent);
125
    AbstractTimelineModelPrivate *d_ptr;
126
127
128

protected slots:
    void dataChanged();
129
130
131

private:
    Q_DECLARE_PRIVATE(AbstractTimelineModel)
Christiaan Janssen's avatar
Christiaan Janssen committed
132
133
134
135
136
};

}

#endif // ABSTRACTTIMELINEMODEL_H