abstracttimelinemodel.h 5.15 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
    // Methods are directly passed on to the private model and relying on its virtual methods.
57
58
59
60
61
    int rowHeight(int rowNumber) const;
    int rowOffset(int rowNumber) const;
    void setRowHeight(int rowNumber, int height);
    int height() const;

62
    Q_INVOKABLE qint64 lastTimeMark() const;
Christiaan Janssen's avatar
Christiaan Janssen committed
63
64
65
66
    Q_INVOKABLE qint64 traceStartTime() const;
    Q_INVOKABLE qint64 traceEndTime() const;
    Q_INVOKABLE qint64 traceDuration() const;
    Q_INVOKABLE int getState() const;
67
68
69
70
71
72
73
    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;
74
    bool eventAccepted(const QmlProfilerDataModel::QmlEventTypeData &event) const;
75
76
77
    bool expanded() const;
    void setExpanded(bool expanded);
    const QString title() const;
78
79

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

89
    // Methods which can optionally be implemented by child models.
Christiaan Janssen's avatar
Christiaan Janssen committed
90
    // returned map should contain "file", "line", "column" properties, or be empty
91
    Q_INVOKABLE virtual const QVariantMap getEventLocation(int index) const;
92
    Q_INVOKABLE virtual int getEventIdForTypeIndex(int typeIndex) const;
93
94
95
    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;
96
97
    virtual int rowMinValue(int rowNumber) const;
    virtual int rowMaxValue(int rowNumber) const;
Christiaan Janssen's avatar
Christiaan Janssen committed
98
99
100

signals:
    void expandedChanged();
101
    void rowHeightChanged();
Christiaan Janssen's avatar
Christiaan Janssen committed
102
103

protected:
104
105
    static const int DefaultRowHeight = 30;

106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
    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);
    }

129
    explicit AbstractTimelineModel(AbstractTimelineModelPrivate *dd, const QString &name,
130
131
                                   const QString &label, QmlDebug::Message message,
                                   QmlDebug::RangeType rangeType, QObject *parent);
132
    AbstractTimelineModelPrivate *d_ptr;
133
134
135

protected slots:
    void dataChanged();
136
137
138

private:
    Q_DECLARE_PRIVATE(AbstractTimelineModel)
Christiaan Janssen's avatar
Christiaan Janssen committed
139
140
141
142
143
};

}

#endif // ABSTRACTTIMELINEMODEL_H