qbitmap.cpp

Absolute File Name:

/home/qt/qt5_coco/qt5/qtbase/src/gui/image/qbitmap.cpp

Source code

Switch to Preprocessed file

Line Source Count

1 /**************************************************************************** -

2 ** -

4 ** Contact: https://www.qt.io/licensing/ -

5 ** -

6 ** This file is part of the QtGui module of the Qt Toolkit. -

7 ** -

8 ** $QT_BEGIN_LICENSE:LGPL$ -

9 ** Commercial License Usage -

10 ** Licensees holding valid commercial Qt licenses may use this file in -

11 ** accordance with the commercial license agreement provided with the -

12 ** Software or, alternatively, in accordance with the terms contained in -

13 ** a written agreement between you and The Qt Company. For licensing terms -

14 ** and conditions see https://www.qt.io/terms-conditions. For further -

15 ** information use the contact form at https://www.qt.io/contact-us. -

16 ** -

17 ** GNU Lesser General Public License Usage -

18 ** Alternatively, this file may be used under the terms of the GNU Lesser -

19 ** General Public License version 3 as published by the Free Software -

20 ** Foundation and appearing in the file LICENSE.LGPL3 included in the -

21 ** packaging of this file. Please review the following information to -

22 ** ensure the GNU Lesser General Public License version 3 requirements -

23 ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. -

24 ** -

25 ** GNU General Public License Usage -

26 ** Alternatively, this file may be used under the terms of the GNU -

27 ** General Public License version 2.0 or (at your option) the GNU General -

28 ** Public license version 3 or any later version approved by the KDE Free -

29 ** Qt Foundation. The licenses are as published by the Free Software -

30 ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 -

31 ** included in the packaging of this file. Please review the following -

32 ** information to ensure the GNU General Public License requirements will -

33 ** be met: https://www.gnu.org/licenses/gpl-2.0.html and -

34 ** https://www.gnu.org/licenses/gpl-3.0.html. -

35 ** -

36 ** $QT_END_LICENSE$ -

37 ** -

38 ****************************************************************************/ -

39 -

40 #include "qbitmap.h" -

41 #include <qpa/qplatformpixmap.h> -

42 #include <qpa/qplatformintegration.h> -

43 #include "qimage.h" -

44 #include "qscreen.h" -

45 #include "qvariant.h" -

46 #include <qpainter.h> -

47 #include <private/qguiapplication_p.h> -

48 -

49 QT_BEGIN_NAMESPACE -

50 -

51 /*! -

52 \class QBitmap -

53 \inmodule QtGui -

54 \brief The QBitmap class provides monochrome (1-bit depth) pixmaps. -

55 -

56 \ingroup painting -

57 \ingroup shared -

58 -

59 The QBitmap class is a monochrome off-screen paint device used -

60 mainly for creating custom QCursor and QBrush objects, -

61 constructing QRegion objects, and for setting masks for pixmaps -

62 and widgets. -

63 -

64 QBitmap is a QPixmap subclass ensuring a depth of 1, except for -

65 null objects which have a depth of 0. If a pixmap with a depth -

66 greater than 1 is assigned to a bitmap, the bitmap will be -

67 dithered automatically. -

68 -

69 Use the QColor objects Qt::color0 and Qt::color1 when drawing on a -

70 QBitmap object (or a QPixmap object with depth 1). -

71 -

72 Painting with Qt::color0 sets the bitmap bits to 0, and painting -

73 with Qt::color1 sets the bits to 1. For a bitmap, 0-bits indicate -

74 background (or transparent pixels) and 1-bits indicate foreground -

75 (or opaque pixels). Use the clear() function to set all the bits -

76 to Qt::color0. Note that using the Qt::black and Qt::white colors -

77 make no sense because the QColor::pixel() value is not necessarily -

78 0 for black and 1 for white. -

79 -

80 The QBitmap class provides the transformed() function returning a -

81 transformed copy of the bitmap; use the QTransform argument to -

82 translate, scale, shear, and rotate the bitmap. In addition, -

83 QBitmap provides the static fromData() function which returns a -

84 bitmap constructed from the given \c uchar data, and the static -

85 fromImage() function returning a converted copy of a QImage -

86 object. -

87 -

88 Just like the QPixmap class, QBitmap is optimized by the use of -

89 implicit data sharing. For more information, see the \l {Implicit -

90 Data Sharing} documentation. -

91 -

92 \sa QPixmap, QImage, QImageReader, QImageWriter -

93 */ -

94 -

95 /*! \typedef QBitmap::DataPtr -

96 \internal -

97 */ -

98 -

99 /*! -

100 Constructs a null bitmap. -

101 -

102 \sa QPixmap::isNull() -

103 */ -

104 QBitmap::QBitmap() -

105 : QPixmap(QSize(0, 0), QPlatformPixmap::BitmapType) -

106 { -

107

}

never executed: end of block

108 -

109 /*! -

110 \fn QBitmap::QBitmap(int width, int height) -

111 -

112 Constructs a bitmap with the given \a width and \a height. The pixels -

113 inside are uninitialized. -

114 -

115 \sa clear() -

116 */ -

117 -

118 QBitmap::QBitmap(int w, int h) -

119 : QPixmap(QSize(w, h), QPlatformPixmap::BitmapType) -

120 { -

121

}

never executed: end of block

122 -

123 /*! -

124 Constructs a bitmap with the given \a size. The pixels in the -

125 bitmap are uninitialized. -

126 -

127 \sa clear() -

128 */ -

129 -

130 QBitmap::QBitmap(const QSize &size) -

131 : QPixmap(size, QPlatformPixmap::BitmapType) -

132 { -

133

}

never executed: end of block

134 -

135 /*! -

136 \fn QBitmap::clear() -

137 -

138 Clears the bitmap, setting all its bits to Qt::color0. -

139 */ -

140 -

141 /*! -

142 Constructs a bitmap that is a copy of the given \a pixmap. -

143 -

144 If the pixmap has a depth greater than 1, the resulting bitmap -

145 will be dithered automatically. -

146 -

147 \sa QPixmap::depth(), fromImage(), fromData() -

148 */ -

149 -

150 QBitmap::QBitmap(const QPixmap &pixmap) -

151 { -

152 QBitmap::operator=(pixmap); -

153

}

never executed: end of block

154 -

155 /*! -

156 Constructs a bitmap from the file specified by the given \a -

157 fileName. If the file does not exist, or has an unknown format, -

158 the bitmap becomes a null bitmap. -

159 -

160 The \a fileName and \a format parameters are passed on to the -

161 QPixmap::load() function. If the file format uses more than 1 bit -

162 per pixel, the resulting bitmap will be dithered automatically. -

163 -

164 \sa QPixmap::isNull(), QImageReader::imageFormat() -

165 */ -

166 -

167 QBitmap::QBitmap(const QString& fileName, const char *format) -

168 : QPixmap(QSize(0, 0), QPlatformPixmap::BitmapType) -

169 { -

170 load(fileName, format, Qt::MonoOnly); -

171

}

never executed: end of block

172 -

173 /*! -

174 \overload -

175 -

176 Assigns the given \a pixmap to this bitmap and returns a reference -

177 to this bitmap. -

178 -

179 If the pixmap has a depth greater than 1, the resulting bitmap -

180 will be dithered automatically. -

181 -

182 \sa QPixmap::depth() -

183 */ -

184 -

185 QBitmap &QBitmap::operator=(const QPixmap &pixmap) -

186 { -

187

if (pixmap.isNull()) { // a null pixmap

pixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

188 QBitmap(0, 0).swap(*this); -

189

} else if (pixmap.depth() == 1) { // 1-bit pixmap

never executed: end of block

pixmap.depth() == 1	Description
TRUE	never evaluated
FALSE	never evaluated

190 QPixmap::operator=(pixmap); // shallow assignment -

191

} else { // n-bit depth pixmap

never executed: end of block

192 QImage image; -

193 image = pixmap.toImage(); // convert pixmap to image -

194 *this = fromImage(image); // will dither image -

195

}

never executed: end of block

196

return *this;

never executed: return *this;

197 } -

198 -

199 #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) -

200 -

201 /*! -

202 Destroys the bitmap. -

203 */ -

204 QBitmap::~QBitmap() -

205 { -

206 } -

207 -

208 #endif -

209 -

210 /*! -

211 \fn void QBitmap::swap(QBitmap &other) -

212 \since 4.8 -

213 -

214 Swaps bitmap \a other with this bitmap. This operation is very -

215 fast and never fails. -

216 */ -

217 -

218 /*! -

219 Returns the bitmap as a QVariant. -

220 */ -

221 QBitmap::operator QVariant() const -

222 { -

223

return QVariant(QVariant::Bitmap, this);

never executed: return QVariant(QVariant::Bitmap, this);

224 } -

225 -

226 /*! -

227 Returns a copy of the given \a image converted to a bitmap using -

228 the specified image conversion \a flags. -

229 -

230 \sa fromData() -

231 */ -

232 QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags) -

233 { -

234

if (image.isNull())

image.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

235

return QBitmap();

never executed: return QBitmap();

236 -

237 QImage img = image.convertToFormat(QImage::Format_MonoLSB, flags); -

238 -

239 // make sure image.color(0) == Qt::color0 (white) -

240 // and image.color(1) == Qt::color1 (black) -

241 const QRgb c0 = QColor(Qt::black).rgb(); -

242 const QRgb c1 = QColor(Qt::white).rgb(); -

243

if (img.color(0) == c0 && img.color(1) == c1) {

img.color(0) == c0	Description
TRUE	never evaluated
FALSE	never evaluated

img.color(1) == c1	Description
TRUE	never evaluated
FALSE	never evaluated

244 img.invertPixels(); -

245 img.setColor(0, c1); -

246 img.setColor(1, c0); -

247

}

never executed: end of block

248 -

249 QScopedPointer<QPlatformPixmap> data(QGuiApplicationPrivate::platformIntegration()->createPlatformPixmap(QPlatformPixmap::BitmapType)); -

250 -

251 data->fromImage(img, flags | Qt::MonoOnly); -

252

return QPixmap(data.take());

never executed: return QPixmap(data.take());

253 } -

254 -

255 /*! -

256 Constructs a bitmap with the given \a size, and sets the contents to -

257 the \a bits supplied. -

258 -

259 The bitmap data has to be byte aligned and provided in in the bit -

260 order specified by \a monoFormat. The mono format must be either -

261 QImage::Format_Mono or QImage::Format_MonoLSB. Use -

262 QImage::Format_Mono to specify data on the XBM format. -

263 -

264 \sa fromImage() -

265 -

266 */ -

267 QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat) -

268 { -

269 Q_ASSERT(monoFormat == QImage::Format_Mono || monoFormat == QImage::Format_MonoLSB); -

270 -

271 QImage image(size, monoFormat); -

272 image.setColor(0, QColor(Qt::color0).rgb()); -

273 image.setColor(1, QColor(Qt::color1).rgb()); -

274 -

275 // Need to memcpy each line separatly since QImage is 32bit aligned and -

276 // this data is only byte aligned... -

277 int bytesPerLine = (size.width() + 7) / 8; -

278

for (int y = 0; y < size.height(); ++y)

y < size.height()	Description
TRUE	never evaluated
FALSE	never evaluated

279

memcpy(image.scanLine(y), bits + bytesPerLine * y, bytesPerLine);

never executed: memcpy(image.scanLine(y), bits + bytesPerLine * y, bytesPerLine);

280

return QBitmap::fromImage(image);

never executed: return QBitmap::fromImage(image);

281 } -

282 -

283 /*! -

284 Returns a copy of this bitmap, transformed according to the given -

285 \a matrix. -

286 -

287 \sa QPixmap::transformed() -

288 */ -

289 QBitmap QBitmap::transformed(const QTransform &matrix) const -

290 { -

291 QBitmap bm = QPixmap::transformed(matrix); -

292

return bm;

never executed: return bm;

293 } -

294 -

295 /*! -

296 \overload -

297 \obsolete -

298 -

299 This convenience function converts the \a matrix to a QTransform -

300 and calls the overloaded function. -

301 */ -

302 QBitmap QBitmap::transformed(const QMatrix &matrix) const -

303 { -

304

return transformed(QTransform(matrix));

never executed: return transformed(QTransform(matrix));

305 } -

306 -

307 QT_END_NAMESPACE -

Source code

Switch to Preprocessed file

Generated by Squish Coco Non-Commercial 4.3.0-BETA-master-30-08-2018-4cb69e9