summaryrefslogtreecommitdiffstats
path: root/doc/man/man3/tqbitmap.3qt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/man3/tqbitmap.3qt')
-rw-r--r--doc/man/man3/tqbitmap.3qt159
1 files changed, 159 insertions, 0 deletions
diff --git a/doc/man/man3/tqbitmap.3qt b/doc/man/man3/tqbitmap.3qt
new file mode 100644
index 000000000..a4c067a3a
--- /dev/null
+++ b/doc/man/man3/tqbitmap.3qt
@@ -0,0 +1,159 @@
+'\" t
+.TH QBitmap 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
+.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
+.\" license file included in the distribution for a complete license
+.\" statement.
+.\"
+.ad l
+.nh
+.SH NAME
+QBitmap \- Monochrome (1-bit depth) pixmaps
+.SH SYNOPSIS
+\fC#include <ntqbitmap.h>\fR
+.PP
+Inherits QPixmap.
+.PP
+.SS "Public Members"
+.in +1c
+.ti -1c
+.BI "\fBQBitmap\fR ()"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( int w, int h, bool clear = FALSE, QPixmap::Optimization optimization = QPixmap::DefaultOptim )"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( const QSize & size, bool clear = FALSE, QPixmap::Optimization optimization = QPixmap::DefaultOptim )"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( int w, int h, const uchar * bits, bool isXbitmap = FALSE )"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( const QSize & size, const uchar * bits, bool isXbitmap = FALSE )"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( const QBitmap & bitmap )"
+.br
+.ti -1c
+.BI "\fBQBitmap\fR ( const QString & fileName, const char * format = 0 )"
+.br
+.ti -1c
+.BI "QBitmap & \fBoperator=\fR ( const QBitmap & bitmap )"
+.br
+.ti -1c
+.BI "QBitmap & \fBoperator=\fR ( const QPixmap & pixmap )"
+.br
+.ti -1c
+.BI "QBitmap & \fBoperator=\fR ( const QImage & image )"
+.br
+.ti -1c
+.BI "QBitmap \fBxForm\fR ( const QWMatrix & matrix ) const"
+.br
+.in -1c
+.SH DESCRIPTION
+The QBitmap class provides monochrome (1-bit depth) pixmaps.
+.PP
+The QBitmap class is a monochrome off-screen paint device used mainly for creating custom QCursor and QBrush objects, in QPixmap::setMask() and for QRegion.
+.PP
+A QBitmap is a QPixmap with a depth of 1. If a pixmap with a depth greater than 1 is assigned to a bitmap, the bitmap will be dithered automatically. A QBitmap is guaranteed to always have the depth 1, unless it is QPixmap::isNull() which has depth 0.
+.PP
+When drawing in a QBitmap (or QPixmap with depth 1), we recommend using the QColor objects \fCQt::color0\fR and \fCQt::color1\fR. Painting with \fCcolor0\fR sets the bitmap bits to 0, and painting with \fCcolor1\fR sets the bits to 1. For a bitmap, 0-bits indicate background (or transparent) and 1-bits indicate foreground (or opaque). Using the \fCblack\fR and \fCwhite\fR QColor objects make no sense because the QColor::pixel() value is not necessarily 0 for black and 1 for white.
+.PP
+The QBitmap can be transformed (translated, scaled, sheared or rotated) using xForm().
+.PP
+Just like the QPixmap class, QBitmap is optimized by the use of implicit sharing, so it is very efficient to pass QBitmap objects as arguments.
+.PP
+See also QPixmap, QPainter::drawPixmap(), bitBlt(), Shared Classes, Graphics Classes, Image Processing Classes, and Implicitly and Explicitly Shared Classes.
+.SH MEMBER FUNCTION DOCUMENTATION
+.SH "QBitmap::QBitmap ()"
+Constructs a null bitmap.
+.PP
+See also QPixmap::isNull().
+.SH "QBitmap::QBitmap ( int w, int h, bool clear = FALSE, QPixmap::Optimization optimization = QPixmap::DefaultOptim )"
+Constructs a bitmap with width \fIw\fR and height \fIh\fR.
+.PP
+The contents of the bitmap is uninitialized if \fIclear\fR is FALSE; otherwise it is filled with pixel value 0 (the QColor \fCQt::color0\fR).
+.PP
+The optional \fIoptimization\fR argument specifies the optimization setting for the bitmap. The default optimization should be used in most cases. Games and other pixmap-intensive applications may benefit from setting this argument; see QPixmap::Optimization.
+.PP
+See also QPixmap::setOptimization() and QPixmap::setDefaultOptimization().
+.SH "QBitmap::QBitmap ( const QSize & size, bool clear = FALSE, QPixmap::Optimization optimization = QPixmap::DefaultOptim )"
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+.PP
+Constructs a bitmap with the size \fIsize\fR.
+.PP
+The contents of the bitmap is uninitialized if \fIclear\fR is FALSE; otherwise it is filled with pixel value 0 (the QColor \fCQt::color0\fR).
+.PP
+The optional \fIoptimization\fR argument specifies the optimization setting for the bitmap. The default optimization should be used in most cases. Games and other pixmap-intensive applications may benefit from setting this argument; see QPixmap::Optimization.
+.SH "QBitmap::QBitmap ( int w, int h, const uchar * bits, bool isXbitmap = FALSE )"
+Constructs a bitmap with width \fIw\fR and height \fIh\fR and sets the contents to \fIbits\fR.
+.PP
+The \fIisXbitmap\fR flag should be TRUE if \fIbits\fR was generated by the X11 bitmap program. The X bitmap bit order is little endian. The QImage documentation discusses bit order of monochrome images.
+.PP
+Example (creates an arrow bitmap):
+.PP
+.nf
+.br
+ uchar arrow_bits[] = { 0x3f, 0x1f, 0x0f, 0x1f, 0x3b, 0x71, 0xe0, 0xc0 };
+.br
+ QBitmap bm( 8, 8, arrow_bits, TRUE );
+.br
+.fi
+.SH "QBitmap::QBitmap ( const QSize & size, const uchar * bits, bool isXbitmap = FALSE )"
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+.PP
+Constructs a bitmap with the size \fIsize\fR and sets the contents to \fIbits\fR.
+.PP
+The \fIisXbitmap\fR flag should be TRUE if \fIbits\fR was generated by the X11 bitmap program. The X bitmap bit order is little endian. The QImage documentation discusses bit order of monochrome images.
+.SH "QBitmap::QBitmap ( const QBitmap & bitmap )"
+Constructs a bitmap that is a copy of \fIbitmap\fR.
+.SH "QBitmap::QBitmap ( const QString & fileName, const char * format = 0 )"
+Constructs a bitmap from the file \fIfileName\fR. If the file does not exist or is of an unknown format, the bitmap becomes a null bitmap.
+.PP
+The parameters \fIfileName\fR and \fIformat\fR are passed on to QPixmap::load(). Dithering will be performed if the file format uses more than 1 bit per pixel.
+.PP
+See also QPixmap::isNull(), QPixmap::load(), QPixmap::loadFromData(), QPixmap::save(), and QPixmap::imageFormat().
+.SH "QBitmap & QBitmap::operator= ( const QBitmap & bitmap )"
+Assigns the bitmap \fIbitmap\fR to this bitmap and returns a reference to this bitmap.
+.SH "QBitmap & QBitmap::operator= ( const QPixmap & pixmap )"
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+.PP
+Assigns the pixmap \fIpixmap\fR to this bitmap and returns a reference to this bitmap.
+.PP
+Dithering will be performed if the pixmap has a QPixmap::depth() greater than 1.
+.SH "QBitmap & QBitmap::operator= ( const QImage & image )"
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+.PP
+Converts the image \fIimage\fR to a bitmap and assigns the result to this bitmap. Returns a reference to the bitmap.
+.PP
+Dithering will be performed if the image has a QImage::depth() greater than 1.
+.SH "QBitmap QBitmap::xForm ( const QWMatrix & matrix ) const"
+Returns a transformed copy of this bitmap by using \fImatrix\fR.
+.PP
+This function does exactly the same as QPixmap::xForm(), except that it returns a QBitmap instead of a QPixmap.
+.PP
+See also QPixmap::xForm().
+
+.SH "SEE ALSO"
+.BR http://doc.trolltech.com/ntqbitmap.html
+.BR http://www.trolltech.com/faq/tech.html
+.SH COPYRIGHT
+Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
+license file included in the distribution for a complete license
+statement.
+.SH AUTHOR
+Generated automatically from the source code.
+.SH BUGS
+If you find a bug in Qt, please report it as described in
+.BR http://doc.trolltech.com/bughowto.html .
+Good bug reports help us to help you. Thank you.
+.P
+The definitive Qt documentation is provided in HTML format; it is
+located at $QTDIR/doc/html and can be read using Qt Assistant or with
+a web browser. This man page is provided as a convenience for those
+users who prefer man pages, although this format is not officially
+supported by Trolltech.
+.P
+If you find errors in this manual page, please report them to
+Please include the name of the manual page (tqbitmap.3qt) and the Qt
+version (3.3.8).