summaryrefslogtreecommitdiff
path: root/src/extras/qquickpicture.cpp
blob: 0a145b5323171618c17f936ecff85beee51d3f08 (plain)
1
2
3
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Quick Extras module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** 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 The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/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 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/

#include "qquickpicture_p.h"

#include <QQmlFile>
#include <QDebug>

/*!
    \qmltype Picture
    \inherits QQuickPaintedItem
    \inqmlmodule QtQuick.Extras
    \since QtQuick.Extras 1.4
    \ingroup extras
    \ingroup extras-non-interactive
    \brief An indicator that displays a colorized QPicture icon

    Picture displays icons in a scalable vector format. It can also colorize
    the icons via the \l color property.

    The icon to display is set with the \l source property.

    For example, if you have access to the ISO 7000 icons that come with Qt
    Enterprise, you can specify the following URL:

    \code
    "qrc:/iso-icons/iso_grs_7000_4_0001.dat"
    \endcode

    Due to the
    \l {http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=65977}
    {large selection of icons} available in this package, it is advisable to
    use Qt Creator's Qt Quick Designer tool to browse and select icons, as this
    property will then be set automatically.
*/

QQuickPicture::QQuickPicture(QQuickItem *parent)
    : QQuickPaintedItem(parent)
{
    const qreal defaultFontHeight = QFontMetricsF(QFont()).height();
    setImplicitWidth(defaultFontHeight * 4);
    setImplicitHeight(defaultFontHeight * 4);
}

QQuickPicture::~QQuickPicture()
{
}

void QQuickPicture::paint(QPainter *painter)
{
    const QSize size = boundingRect().size().toSize();
    // Don't want the scale to apply to the fill.
    painter->save();
    painter->scale(qreal(size.width()) / mPicture.boundingRect().width(),
        qreal(size.height()) / mPicture.boundingRect().height());
    painter->drawPicture(0, 0, mPicture);
    painter->restore();

    if (mColor.isValid()) {
        painter->setCompositionMode(QPainter::CompositionMode_SourceIn);
        painter->fillRect(0, 0, size.width(), size.height(), mColor);
    }
}

/*!
    \qmlproperty url Picture::source

    This property specifies the URL of the icon to use. The URL must point to a
    local file that contains \l QPicture data. For example:

    \code
    "mypicture.dat"
    \endcode
*/
QUrl QQuickPicture::source() const
{
    return mSource;
}

void QQuickPicture::setSource(const QUrl &source)
{
    if (mSource != source) {
        mSource = source;
        const QString fileName = QQmlFile::urlToLocalFileOrQrc(source);
        if (!mPicture.load(fileName)) {
            qWarning().nospace() << "Failed to load " << fileName << "; does it exist?";
            mPicture = QPicture();
        }

        setImplicitWidth(mPicture.boundingRect().width());
        setImplicitHeight(mPicture.boundingRect().height());

        update();
        emit sourceChanged();
    }
}

/*!
    \qmlproperty color Picture::color

    This property specifies the color of the indicator.

    The default value is \c "black".
*/
QColor QQuickPicture::color() const
{
    return mColor;
}

void QQuickPicture::setColor(const QColor &color)
{
    if (mColor != color) {
        mColor = color;
        update();
        emit colorChanged();
    }
}

void QQuickPicture::resetColor()
{
    setColor(QColor());
}