Qt ForkAwesome 0.2.0
Library that bundles ForkAwesome for use within Qt applications
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | List of all members
QtForkAwesome::Renderer Class Reference

Allows rendering a QtForkAwesome::Icon (or an arbitrary QChar using an arbitrary font file). More...

#include <renderer.h>

Public Member Functions

 Renderer (const QString &fontFileName=QString())
 Constructs a new renderer with the given fontFileName.
 
 Renderer (const QByteArray &fontData)
 Constructs a new renderer with the given fontData.
 
 ~Renderer ()
 Destructs the renderer.
 
 operator bool () const
 Returns whether the render could be initialized correctly.
 
void render (QChar character, QPainter *painter, const QRect &rect, const QColor &color) const
 Renders the specified icon using the specified painter.
 
void render (Icon icon, QPainter *painter, const QRect &rect, const QColor &color) const
 Renders the specified icon using the specified painter.
 
QPixmap pixmap (QChar icon, const QSize &size, const QColor &color, qreal scaleFactor) const
 Renders the specified character as pixmap of the specified size.
 
QPixmap pixmap (Icon icon, const QSize &size, const QColor &color, qreal scaleFactor) const
 Renders the specified icon as pixmap of the specified size.
 
QPixmap pixmap (QChar icon, const QSize &size, const QColor &color) const
 Renders the specified character as pixmap of the specified size.
 
QPixmap pixmap (Icon icon, const QSize &size, const QColor &color) const
 Renders the specified icon as pixmap of the specified size.
 
void addThemeOverride (QChar character, const QString &iconNameInTheme)
 Uses the icon from the current icon theme obtained via QIcon::fromTheme() for character if it exists.
 
void addThemeOverride (Icon icon, const QString &iconNameInTheme)
 Uses the icon from the current icon theme obtained via QIcon::fromTheme() for icon if it exists.
 
void addOverride (QChar character, const QIcon &override)
 Uses the specified override icon for character if it is not null.
 
void addOverride (Icon icon, const QIcon &override)
 Uses the specified override icon for icon if it is not null.
 
void setAssociatedPaintDevice (QPaintDevice *paintDevice)
 Sets the associated paintDevice.
 
void clearOverrides ()
 Clears all overrides added via addThemeOverride() or addOverride().
 

Static Public Member Functions

static Rendererglobal ()
 Returns the global instance (which is so far only used by the icon engine plugin).
 

Detailed Description

Allows rendering a QtForkAwesome::Icon (or an arbitrary QChar using an arbitrary font file).

Definition at line 22 of file renderer.h.

Constructor & Destructor Documentation

◆ Renderer() [1/2]

QtForkAwesome::Renderer::Renderer ( const QString & fontFileName = QString())
explicit

Constructs a new renderer with the given fontFileName.

Remarks
If fontFileName is empty, the bundled font file will be used.

Definition at line 84 of file renderer.cpp.

◆ Renderer() [2/2]

QtForkAwesome::Renderer::Renderer ( const QByteArray & fontData)
explicit

Constructs a new renderer with the given fontData.

Definition at line 93 of file renderer.cpp.

◆ ~Renderer()

QtForkAwesome::Renderer::~Renderer ( )

Destructs the renderer.

Definition at line 101 of file renderer.cpp.

Member Function Documentation

◆ addOverride() [1/2]

void QtForkAwesome::Renderer::addOverride ( Icon icon,
const QIcon & override )
inline

Uses the specified override icon for icon if it is not null.

Definition at line 71 of file renderer.h.

◆ addOverride() [2/2]

void QtForkAwesome::Renderer::addOverride ( QChar character,
const QIcon & override )

Uses the specified override icon for character if it is not null.

Definition at line 221 of file renderer.cpp.

◆ addThemeOverride() [1/2]

void QtForkAwesome::Renderer::addThemeOverride ( Icon icon,
const QString & iconNameInTheme )
inline

Uses the icon from the current icon theme obtained via QIcon::fromTheme() for icon if it exists.

Definition at line 63 of file renderer.h.

◆ addThemeOverride() [2/2]

void QtForkAwesome::Renderer::addThemeOverride ( QChar character,
const QString & iconNameInTheme )

Uses the icon from the current icon theme obtained via QIcon::fromTheme() for character if it exists.

Definition at line 213 of file renderer.cpp.

◆ clearOverrides()

void QtForkAwesome::Renderer::clearOverrides ( )

Clears all overrides added via addThemeOverride() or addOverride().

Definition at line 229 of file renderer.cpp.

◆ global()

Renderer & QtForkAwesome::Renderer::global ( )
static

Returns the global instance (which is so far only used by the icon engine plugin).

Definition at line 248 of file renderer.cpp.

◆ operator bool()

QtForkAwesome::Renderer::operator bool ( ) const

Returns whether the render could be initialized correctly.

Definition at line 111 of file renderer.cpp.

◆ pixmap() [1/4]

QPixmap QtForkAwesome::Renderer::pixmap ( Icon icon,
const QSize & size,
const QColor & color ) const

Renders the specified icon as pixmap of the specified size.

Remarks
  • The pixmap will be scaled for the associated paint device or use the global device-dixel-ratio if not paint device has been associated.
  • When rendering a QPixmap for a QIcon, better the other overloads with the actual size (and a scale factor of one).

Definition at line 205 of file renderer.cpp.

◆ pixmap() [2/4]

QPixmap QtForkAwesome::Renderer::pixmap ( Icon icon,
const QSize & size,
const QColor & color,
qreal scaleFactor ) const

Renders the specified icon as pixmap of the specified size.

Definition at line 179 of file renderer.cpp.

◆ pixmap() [3/4]

QPixmap QtForkAwesome::Renderer::pixmap ( QChar icon,
const QSize & size,
const QColor & color ) const

Renders the specified character as pixmap of the specified size.

Remarks
  • The pixmap will be scaled for the associated paint device or use the global device-dixel-ratio if not paint device has been associated.
  • When rendering a QPixmap for a QIcon, better the other overloads with the actual size (and a scale factor of one).

Definition at line 192 of file renderer.cpp.

◆ pixmap() [4/4]

QPixmap QtForkAwesome::Renderer::pixmap ( QChar icon,
const QSize & size,
const QColor & color,
qreal scaleFactor ) const

Renders the specified character as pixmap of the specified size.

Definition at line 147 of file renderer.cpp.

◆ render() [1/2]

void QtForkAwesome::Renderer::render ( Icon icon,
QPainter * painter,
const QRect & rect,
const QColor & color ) const
inline

Renders the specified icon using the specified painter.

Definition at line 55 of file renderer.h.

◆ render() [2/2]

void QtForkAwesome::Renderer::render ( QChar character,
QPainter * painter,
const QRect & rect,
const QColor & color ) const

Renders the specified icon using the specified painter.

Definition at line 131 of file renderer.cpp.

◆ setAssociatedPaintDevice()

void QtForkAwesome::Renderer::setAssociatedPaintDevice ( QPaintDevice * paintDevice)

Sets the associated paintDevice.

Remarks
The device-pixel-ratio of the specified device will be used when rendering pixmaps using the overloads that do not take a scale factor.

Definition at line 240 of file renderer.cpp.


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