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
|
/* ============================================================
*
* This file is a part of the rekonq project
*
* Copyright (C) 2009 Nokia Corporation <qt-info@nokia.com>
* Copyright (C) 2009-2010 by Andrea Diamantini <adjam7 at gmail dot com>
* Copyright (C) 2010 by Matthieu Gicquel <matgic78 at gmail dot 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; either version 2 of
* the License or (at your option) version 3 or any later version
* accepted by the membership of KDE e.V. (or its successor approved
* by the membership of KDE e.V.), which shall act as a proxy
* defined in Section 14 of version 3 of the license.
*
* 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 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 WEB_SNAP_H
#define WEB_SNAP_H
// Rekonq Includes
#include "rekonq_defines.h"
// KDE Includes
#include <KUrl>
// Qt Includes
#include <QtCore/QObject>
#include <QtGui/QPixmap>
#include <QtWebKit/QWebPage>
// Defines
#define WIDTH 200
#define HEIGHT 150
/**
* This class is used in many classes of rekonq to produce an image
* based on the site corresponding to the url passed as argument.
* It also cached the images to not retrieve them every time :)
*
* Heavily based on Graphics-Dojo WebSnap example (thanks!)
*
* We use this in the following rekonq classes:
*
* - TabBar class: to show a tab preview (given a page, you show AND save an image)
* - PreviewSelector class: to save new favorite selection (given a page, you show AND save an image)
*
* - NewTabPage class: to show the favorites page "preview" (given an url, you show AND save an image)
*
*/
class REKONQ_TESTS_EXPORT WebSnap : public QObject
{
Q_OBJECT
public:
/**
* Creates a WebSnap object. It will load the url in one WebPage
* and snap an image from it.
*
* @param url the url to load
* @param parent the object parent
*/
explicit WebSnap(const KUrl &url, QObject *parent = 0);
~WebSnap();
/**
* Snaps a pixmap of size w * h from a page
*
* @param page the page to snap
* @param w the image width
* @param h the image height
*
* @return the pixmap snapped from the page
*/
static QPixmap renderPagePreview(const QWebPage &page, int w = WIDTH, int h = HEIGHT);
// static QPixmap renderVisiblePagePreview(const QWebPage &page, int w = WIDTH, int h = HEIGHT); TODO: try to make this method work => more previews for the urlbar
/**
* Snaps a pixmap of size w * h from a page of a tab that is currently closing
*
* @param page the page to snap
* @param w the image width
* @param h the image height
*
* @return the pixmap snapped from the page
*/
static QPixmap renderClosingPagePreview(const QWebPage &page, int w = WIDTH, int h = HEIGHT);
/**
* Snaps a pixmap of size w * h from a page for tab preview
*
* @param page the page to snap
* @param w the image width
* @param h the image height
*
* @return the pixmap snapped from the page
*/
static QPixmap renderTabPreview(const QWebPage &page, int w, int h);
/**
* Guess the local path where the image for the url provided
* should be
*
* @param url the url to guess snap path
*
* @return the local path of the url snap
*/
static QString imagePathFromUrl(const KUrl &url);
/**
* Determines if a snap exists for that url
*
*/
static bool existsImage(const KUrl &url);
private slots:
void saveResult(bool ok = true);
void load();
signals:
void snapDone(bool ok);
private:
QWebPage m_page;
KUrl m_url;
//render a preview: common part of renderPagePreview() and renderTabPreview()
static QPixmap render(const QWebPage &page, int w, int h);
};
#endif // WEB_SNAP_H
|
