File: qimage-h.html

package info (click to toggle)
qt1g 1%3A1.45-1.1
  • links: PTS
  • area: non-free
  • in suites: potato
  • size: 17,436 kB
  • ctags: 20,174
  • sloc: cpp: 89,153; yacc: 1,273; ansic: 692; makefile: 479; lex: 326; sh: 150; perl: 94
file content (319 lines) | stat: -rw-r--r-- 10,703 bytes parent folder | download
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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta name="robots" content="noindex,noarchive"><title>
Qt Toolkit - qimage.h include file
</title><style type="text/css"><!--
h3.fn,span.fn { margin-left: 15%; text-indent: -15%; }
a:link { text-decoration: none; }
--></style>
</head><body bgcolor="#ffffff">

<a href=index.html><img width=122 height=65 src=qtlogo.jpg alt="Qt logo" align=left border=0></a>
<center><img src=dochead.gif width=472 height=27></center>
<br clear=all>

<h1 align=center>qimage.h</h1><br clear="all">
This is the verbatim text of the qimage.h include file.  It is is
provided only for illustration; the copyright
remains with Troll Tech.
<hr>
<pre>
/****************************************************************************
** &#36;Id&#58; qimage.h,v 2.29.2.5 1998/11/02 15:49:12 hanord Exp $
**
** Definition of QImage and QImageIO classes
**
** Created : 950207
**
** Copyright (C) 1992-1999 Troll Tech AS.  All rights reserved.
**
** This file is part of Qt Free Edition, version 1.45.
**
** See the file LICENSE included in the distribution for the usage
** and distribution terms, or http://www.troll.no/free-license.html.
**
** IMPORTANT NOTE: You may NOT copy this file or any part of it into
** your own programs or libraries.
**
** Please see http://www.troll.no/pricing.html for information about 
** Qt Professional Edition, which is this same library but with a
** license which allows creation of commercial/proprietary software.
**
*****************************************************************************/

#ifndef QIMAGE_H
#define QIMAGE_H

#ifndef QT_H
#include "qpixmap.h"
#include "qstrlist.h"
#endif // QT_H


class Q_EXPORT QImage
{
public:
    enum Endian { IgnoreEndian, BigEndian, LittleEndian };

    QImage();
    QImage( int width, int height, int depth, int numColors=0,
            Endian bitOrder=IgnoreEndian );
    QImage( const QSize&amp;, int depth, int numColors=0,
            Endian bitOrder=IgnoreEndian );
    QImage( const char *fileName, const char *format=0 );
    QImage( const char *xpm[] );
    QImage( const QImage &amp; );
   ~QImage();

    QImage     &amp;operator=( const QImage &amp; );
    QImage     &amp;operator=( const QPixmap &amp; );
    bool        operator==( const QImage &amp; ) const;
    bool        operator!=( const QImage &amp; ) const;
    void        detach();
    QImage      copy()          const;
    QImage      copy(int x, int y, int w, int h, int conversion_flags=0) const;
    QImage      copy(QRect&amp;)    const;

    bool        isNull()        const   { return data-&gt;bits == 0; }

    int         width()         const   { return data-&gt;w; }
    int         height()        const   { return data-&gt;h; }
    QSize       size()          const   { return QSize(data-&gt;w,data-&gt;h); }
    QRect       rect()          const   { return QRect(0,0,data-&gt;w,data-&gt;h); }
    int         depth()         const   { return data-&gt;d; }
    int         numColors()     const   { return data-&gt;ncols; }
    Endian      bitOrder()      const   { return (Endian) data-&gt;bitordr; }

    QRgb        color( int i )  const;
    void        setColor( int i, QRgb c );
    void        setNumColors( int );

    bool        hasAlphaBuffer() const;
    void        setAlphaBuffer( bool );

    bool        allGray() const;
    bool        isGrayscale() const;

    uchar      *bits()          const;
    uchar      *scanLine( int ) const;
    uchar     **jumpTable()     const;
    QRgb       *colorTable()    const;
    int         numBytes()      const;
    int         bytesPerLine()  const;

    bool        create( int width, int height, int depth, int numColors=0,
                        Endian bitOrder=IgnoreEndian );
    bool        create( const QSize&amp;, int depth, int numColors=0,
                        Endian bitOrder=IgnoreEndian );
    void        reset();

    void        fill( uint pixel );

    QImage      convertDepth( int ) const;
    QImage      convertDepthWithPalette( int, QRgb* p, int pc, int cf=0 ) const;
    QImage      convertDepth( int, int conversion_flags ) const;
    QImage      convertBitOrder( Endian ) const;
    QImage      smoothScale(int width, int height) const;

#if defined(HAS_BOOL_TYPE)
    // Needed for binary compatibility - calls createAlphaMask(int)
    QImage      createAlphaMask( bool dither=FALSE ) const;
#else
    // Needed for source compatibility - calls createAlphaMask(FALSE)
    QImage      createAlphaMask() const;
#endif

    QImage      createAlphaMask( int conversion_flags ) const;
    QImage      createHeuristicMask( bool clipTight=TRUE ) const;

    static Endian systemBitOrder();
    static Endian systemByteOrder();

    static const char *imageFormat( const char *fileName );
    static QStrList inputFormats();
    static QStrList outputFormats();

    bool        load( const char *fileName, const char *format=0 );
    bool        loadFromData( const uchar *buf, uint len,
                              const char *format=0 );
    bool        loadFromData( QByteArray data, const char *format=0 );
    bool        save( const char *fileName, const char *format ) const;

    bool        valid( int x, int y ) const;
    int         pixelIndex( int x, int y ) const;
    QRgb        pixel( int x, int y ) const;
    void        setPixel( int x, int y, uint index_or_rgb );

private:
    void        init();
    void        freeBits();
    static void warningIndexRange( const char *, int );

    struct QImageData : public QShared {        // internal image data
        int     w;                              // image width
        int     h;                              // image height
        int     d;                              // image depth
        int     ncols;                          // number of colors
        int     nbytes;                         // number of bytes data
        int     bitordr;                        // bit order (1 bit depth)
        QRgb   *ctbl;                           // color table
        uchar **bits;                           // image data
        bool    alpha;                          // alpha buffer
    } *data;

    friend Q_EXPORT void bitBlt( QImage* dst, int dx, int dy,
                                 const QImage* src, int sx, int sy,
                                 int sw, int sh, int conversion_flags );
};


// QImage stream functions

Q_EXPORT QDataStream &amp;operator&lt;&lt;( QDataStream &amp;, const QImage &amp; );
Q_EXPORT QDataStream &amp;operator&gt;&gt;( QDataStream &amp;, QImage &amp; );


class QIODevice;
typedef void (*image_io_handler)( QImageIO * ); // image IO handler


class Q_EXPORT QImageIO
{
public:
    QImageIO();
    QImageIO( QIODevice  *ioDevice, const char *format );
    QImageIO( const char *fileName, const char *format );
   ~QImageIO();


    const QImage &amp;image()       const   { return im; }
    int         status()        const   { return iostat; }
    const char *format()        const   { return frmt; }
    QIODevice  *ioDevice()      const   { return iodev; }
    const char *fileName()      const   { return fname; }
    const char *parameters()    const   { return params; }
    const char *description()   const   { return descr; }

    void        setImage( const QImage &amp; );
    void        setStatus( int );
    void        setFormat( const char * );
    void        setIODevice( QIODevice * );
    void        setFileName( const char * );
    void        setParameters( const char * );
    void        setDescription( const char * );

    bool        read();
    bool        write();

    static const char *imageFormat( const char *fileName );
    static const char *imageFormat( QIODevice * );
    static QStrList inputFormats();
    static QStrList outputFormats();

    static void defineIOHandler( const char *format,
                                 const char *header,
                                 const char *flags,
                                 image_io_handler read_image,
                                 image_io_handler write_image );

private:
    QImage      im;                             // image
    int         iostat;                         // IO status
    QString     frmt;                           // image format
    QIODevice  *iodev;                          // IO device
    QString     fname;                          // file name
    char       *params;                         // image parameters
    char       *descr;                          // image description

private:        // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
    QImageIO( const QImageIO &amp; );
    QImageIO &amp;operator=( const QImageIO &amp; );
#endif
};


Q_EXPORT void bitBlt( QImage* dst, int dx, int dy, const QImage* src,
                      int sx=0, int sy=0, int sw=-1, int sh=-1,
                      int conversion_flags=0 );


/*****************************************************************************
  QImage member functions
 *****************************************************************************/

inline bool QImage::hasAlphaBuffer() const
{
    return data-&gt;alpha;
}

inline uchar *QImage::bits() const
{
    return data-&gt;bits ? data-&gt;bits[0] : 0;
}

inline uchar **QImage::jumpTable() const
{
    return data-&gt;bits;
}

inline QRgb *QImage::colorTable() const
{
    return data-&gt;ctbl;
}

inline int QImage::numBytes() const
{
    return data-&gt;nbytes;
}

inline int QImage::bytesPerLine() const
{
    return data-&gt;h ? data-&gt;nbytes/data-&gt;h : 0;
}

inline QImage QImage::copy(QRect&amp; r) const
{
    return copy(r.x(), r.y(), r.width(), r.height());
}

#if defined(_OS_WIN32_) || !(defined(QIMAGE_C) || defined(CHECK_RANGE))

inline QRgb QImage::color( int i ) const
{
#if defined(CHECK_RANGE)
    if ( i &gt;= data-&gt;ncols )
        warningIndexRange( "color", i );
#endif
    return data-&gt;ctbl ? data-&gt;ctbl[i] : (QRgb)-1;
}

inline void QImage::setColor( int i, QRgb c )
{
#if defined(CHECK_RANGE)
    if ( i &gt;= data-&gt;ncols )
        warningIndexRange( "setColor", i );
#endif
    if ( data-&gt;ctbl )
        data-&gt;ctbl[i] = c;
}

inline uchar *QImage::scanLine( int i ) const
{
#if defined(CHECK_RANGE)
    if ( i &gt;= data-&gt;h )
        warningIndexRange( "scanLine", i );
#endif
    return data-&gt;bits ? data-&gt;bits[i] : 0;
}

#endif


#endif // QIMAGE_H

</pre>
<p><address><hr><div align="center">
<table width="100%" cellspacing="0" border="0"><tr>
<td>Copyright  1999 Troll Tech<td><a href="trademarks.html">Trademarks</a>
<td align="right"><div align="right">Qt version 1.45</div>
</table></div></address></body></html>