Qt 4.8
Public Functions | Friends | List of all members
QPixmapBlurFilter Class Reference

The QPixmapBlurFilter class provides blur filtering for pixmaps. More...

#include <qpixmapfilter_p.h>

Inheritance diagram for QPixmapBlurFilter:
QPixmapFilter QObject QGLPixmapFilter< QPixmapBlurFilter > QVGPixmapBlurFilter QGLPixmapBlurFilter

Public Functions

QGraphicsBlurEffect::BlurHints blurHints () const
 Gets the blur hints of the blur filter. More...
 
QRectF boundingRectFor (const QRectF &rect) const
 
void draw (QPainter *painter, const QPointF &dest, const QPixmap &src, const QRectF &srcRect=QRectF()) const
 
 QPixmapBlurFilter (QObject *parent=0)
 Constructs a pixmap blur filter. More...
 
qreal radius () const
 Gets the radius of the blur filter. More...
 
void setBlurHints (QGraphicsBlurEffect::BlurHints hints)
 Setting the blur hints to PerformanceHint causes the implementation to trade off visual quality to blur the image faster. More...
 
void setRadius (qreal radius)
 Sets the radius of the blur filter. More...
 
 ~QPixmapBlurFilter ()
 Destructor of pixmap blur filter. More...
 
- Public Functions inherited from QPixmapFilter
FilterType type () const
 Returns the type of the filter. More...
 
virtual ~QPixmapFilter ()=0
 Destroys the pixmap filter. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool event (QEvent *)
 This virtual function receives events to an object and should return true if the event e was recognized and processed. More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 

Friends

class QGLPixmapBlurFilter
 

Additional Inherited Members

- Public Types inherited from QPixmapFilter
enum  FilterType {
  ConvolutionFilter, ColorizeFilter, DropShadowFilter, BlurFilter,
  UserFilter = 1024
}
 This enum describes the types of filter that can be applied to pixmaps. More...
 
- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Functions inherited from QPixmapFilter
 QPixmapFilter (QPixmapFilterPrivate &d, FilterType type, QObject *parent)
 
 QPixmapFilter (FilterType type, QObject *parent)
 Constructs a default QPixmapFilter with the given type. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QPixmapBlurFilter class provides blur filtering for pixmaps.

Since
4.6

QPixmapBlurFilter implements a blur pixmap filter, which is applied when QPixmapFilter::draw() is called.

The filter lets you specialize the radius of the blur as well as hints as to whether to prefer performance or quality.

By default, the blur effect is produced by applying an exponential filter generated from the specified blurRadius(). Paint engines may override this with a custom blur that is faster on the underlying hardware.

See also
{Pixmap Filters Example}, QPixmapConvolutionFilter, QPixmapDropShadowFilter
Warning
This function is not part of the public interface.

Definition at line 125 of file qpixmapfilter_p.h.

Constructors and Destructors

◆ QPixmapBlurFilter()

QPixmapBlurFilter::QPixmapBlurFilter ( QObject parent = 0)

Constructs a pixmap blur filter.

Warning
This function is not part of the public interface.

Definition at line 539 of file qpixmapfilter.cpp.

541 {
542 }
QPixmapFilter(QPixmapFilterPrivate &d, FilterType type, QObject *parent)

◆ ~QPixmapBlurFilter()

QPixmapBlurFilter::~QPixmapBlurFilter ( )

Destructor of pixmap blur filter.

Warning
This function is not part of the public interface.

Definition at line 549 of file qpixmapfilter.cpp.

550 {
551 }

Functions

◆ blurHints()

QGraphicsBlurEffect::BlurHints QPixmapBlurFilter::blurHints ( ) const

Gets the blur hints of the blur filter.

Warning
This function is not part of the public interface.

Definition at line 601 of file qpixmapfilter.cpp.

602 {
603  Q_D(const QPixmapBlurFilter);
604  return d->hints;
605 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QPixmapBlurFilter class provides blur filtering for pixmaps.

◆ boundingRectFor()

QRectF QPixmapBlurFilter::boundingRectFor ( const QRectF rect) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from QPixmapFilter.

Definition at line 612 of file qpixmapfilter.cpp.

613 {
614  Q_D(const QPixmapBlurFilter);
615  const qreal delta = radiusScale * d->radius + 1;
616  return rect.adjusted(-delta, -delta, delta, delta);
617 }
double d
Definition: qnumeric_p.h:62
double qreal
Definition: qglobal.h:1193
#define Q_D(Class)
Definition: qglobal.h:2482
The QPixmapBlurFilter class provides blur filtering for pixmaps.
QRectF adjusted(qreal x1, qreal y1, qreal x2, qreal y2) const
Returns a new rectangle with dx1, dy1, dx2 and dy2 added respectively to the existing coordinates of ...
Definition: qrect.h:781
const qreal radiusScale

◆ draw()

void QPixmapBlurFilter::draw ( QPainter painter,
const QPointF p,
const QPixmap src,
const QRectF rect = QRectF() 
) const
virtual
Warning
This function is not part of the public interface.

Implements QPixmapFilter.

Reimplemented in QVGPixmapBlurFilter, and QGLPixmapFilter< QPixmapBlurFilter >.

Definition at line 925 of file qpixmapfilter.cpp.

Referenced by QVGPixmapBlurFilter::draw(), and draw().

926 {
927  Q_D(const QPixmapBlurFilter);
928  if (!painter->isActive())
929  return;
930 
931  if (src.isNull())
932  return;
933 
934  QRectF srcRect = rect;
935  if (srcRect.isNull())
936  srcRect = src.rect();
937 
938  if (d->radius <= 1) {
939  painter->drawPixmap(srcRect.translated(p), src, srcRect);
940  return;
941  }
942 
943  qreal scaledRadius = radiusScale * d->radius;
944  qreal scale;
945  if (qt_scaleForTransform(painter->transform(), &scale))
946  scaledRadius /= scale;
947 
948  QPixmapFilter *filter = painter->paintEngine() && painter->paintEngine()->isExtended() ?
949  static_cast<QPaintEngineEx *>(painter->paintEngine())->pixmapFilter(type(), this) : 0;
950  QPixmapBlurFilter *blurFilter = static_cast<QPixmapBlurFilter*>(filter);
951  if (blurFilter) {
952  blurFilter->setRadius(scaledRadius);
953  blurFilter->setBlurHints(d->hints);
954  blurFilter->draw(painter, p, src, srcRect);
955  return;
956  }
957 
958  QImage srcImage;
959  QImage destImage;
960 
961  if (srcRect == src.rect()) {
962  srcImage = src.toImage();
963  } else {
964  QRect rect = srcRect.toAlignedRect().intersected(src.rect());
965  srcImage = src.copy(rect).toImage();
966  }
967 
968  QTransform transform = painter->worldTransform();
969  painter->translate(p);
970  qt_blurImage(painter, srcImage, scaledRadius, (d->hints & QGraphicsBlurEffect::QualityHint), false);
971  painter->setWorldTransform(transform);
972 }
double d
Definition: qnumeric_p.h:62
QRect toAlignedRect() const
Returns a QRect based on the values of this rectangle that is the smallest possible integer rectangle...
Definition: qrect.cpp:2817
QImage toImage() const
Converts the pixmap to a QImage.
Definition: qpixmap.cpp:542
double qreal
Definition: qglobal.h:1193
const QTransform & transform() const
Returns the world transformation matrix.
Definition: qpainter.cpp:9558
Q_GUI_EXPORT void qt_blurImage(QPainter *p, QImage &blurImage, qreal radius, bool quality, bool alphaOnly, int transposed=0)
Q_GUI_EXPORT bool qt_scaleForTransform(const QTransform &transform, qreal *scale)
FilterType type() const
Returns the type of the filter.
QRect intersected(const QRect &other) const
Returns the intersection of this rectangle and the given rectangle.
Definition: qrect.h:481
bool isExtended() const
Returns true if the paint engine is a QPaintEngineEx derivative.
Definition: qpaintengine.h:234
#define Q_D(Class)
Definition: qglobal.h:2482
void setBlurHints(QGraphicsBlurEffect::BlurHints hints)
Setting the blur hints to PerformanceHint causes the implementation to trade off visual quality to bl...
The QRectF class defines a rectangle in the plane using floating point precision. ...
Definition: qrect.h:511
bool isActive() const
Returns true if begin() has been called and end() has not yet been called; otherwise returns false...
Definition: qpainter.cpp:1545
The QPixmapBlurFilter class provides blur filtering for pixmaps.
The QImage class provides a hardware-independent image representation that allows direct access to th...
Definition: qimage.h:87
QPaintEngine * paintEngine() const
Returns the paint engine that the painter is currently operating on if the painter is active; otherwi...
Definition: qpainter.cpp:1991
const QTransform & worldTransform() const
Returns the world transformation matrix.
Definition: qpainter.cpp:9652
The QPixmapFilter class provides the basic functionality for pixmap filter classes.
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
QFuture< void > filter(Sequence &sequence, FilterFunction filterFunction)
void setWorldTransform(const QTransform &matrix, bool combine=false)
Sets the world transformation matrix.
Definition: qpainter.cpp:9630
QRect rect() const
Returns the pixmap&#39;s enclosing rectangle.
Definition: qpixmap.cpp:676
void drawPixmap(const QRectF &targetRect, const QPixmap &pixmap, const QRectF &sourceRect)
Draws the rectangular portion source of the given pixmap into the given target in the paint device...
Definition: qpainter.cpp:5619
void setRadius(qreal radius)
Sets the radius of the blur filter.
bool isNull() const
Returns true if this is a null pixmap; otherwise returns false.
Definition: qpixmap.cpp:615
QRectF translated(qreal dx, qreal dy) const
Returns a copy of the rectangle that is translated dx along the x axis and dy along the y axis...
Definition: qrect.h:740
QPixmap copy(int x, int y, int width, int height) const
Returns a deep copy of the subset of the pixmap that is specified by the rectangle QRect( x...
Definition: qpixmap.h:302
bool isNull() const
Returns true if the rectangle is a null rectangle, otherwise returns false.
Definition: qrect.h:655
void draw(QPainter *painter, const QPointF &dest, const QPixmap &src, const QRectF &srcRect=QRectF()) const
The QTransform class specifies 2D transformations of a coordinate system.
Definition: qtransform.h:65
const qreal radiusScale
void translate(const QPointF &offset)
Translates the coordinate system by the given offset; i.e.
Definition: qpainter.cpp:3311

◆ radius()

qreal QPixmapBlurFilter::radius ( ) const

Gets the radius of the blur filter.

Warning
This function is not part of the public interface.

Definition at line 569 of file qpixmapfilter.cpp.

Referenced by QVGPixmapBlurFilter::draw(), qt_blurImage(), and setRadius().

570 {
571  Q_D(const QPixmapBlurFilter);
572  return d->radius;
573 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QPixmapBlurFilter class provides blur filtering for pixmaps.

◆ setBlurHints()

void QPixmapBlurFilter::setBlurHints ( QGraphicsBlurEffect::BlurHints  hints)

Setting the blur hints to PerformanceHint causes the implementation to trade off visual quality to blur the image faster.

Setting the blur hints to QualityHint causes the implementation to improve visual quality at the expense of speed.

AnimationHint causes the implementation to optimize for animating the blur radius, possibly by caching blurred versions of the source pixmap.

The implementation is free to ignore this value if it only has a single blur algorithm.

Warning
This function is not part of the public interface.

Definition at line 590 of file qpixmapfilter.cpp.

Referenced by draw().

591 {
593  d->hints = hints;
594 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QPixmapBlurFilter class provides blur filtering for pixmaps.

◆ setRadius()

void QPixmapBlurFilter::setRadius ( qreal  radius)

Sets the radius of the blur filter.

Higher radius produces increased blurriness.

Warning
This function is not part of the public interface.

Definition at line 558 of file qpixmapfilter.cpp.

Referenced by draw().

559 {
561  d->radius = radius;
562 }
qreal radius() const
Gets the radius of the blur filter.
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QPixmapBlurFilter class provides blur filtering for pixmaps.

Friends and Related Functions

◆ QGLPixmapBlurFilter

friend class QGLPixmapBlurFilter
friend

Definition at line 144 of file qpixmapfilter_p.h.


The documentation for this class was generated from the following files: