Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QWindowsFontEngine Class Reference

Standard Windows font engine. More...

#include <qwindowsfontengine_p.h>

Inheritance diagram for QWindowsFontEngine:
Collaboration diagram for QWindowsFontEngine:

Public Member Functions

 QWindowsFontEngine (const QString &namename, LOGFONT lf, const QSharedPointer< QWindowsFontEngineData > &fontEngineData)
 ~QWindowsFontEngine () override
void initFontInfo (const QFontDef &request, int dpi)
QFixed lineThickness () const override
Properties properties () const override
void getUnscaledGlyph (glyph_t glyph, QPainterPath *pathpath, glyph_metrics_t *metricsmetrics) override
FaceId faceId () const override
bool getSfntTableData (uint tag, uchar *bufferbuffer, uint *lengthlength) const override
int synthesized () const override
QFixed emSquareSize () const override
glyph_t glyphIndex (uint ucs4) const override
int stringToCMap (const QChar *str, int lenlen, QGlyphLayout *glyphs, int *nglyphs, ShaperFlags flagsflags) const override
void recalcAdvances (QGlyphLayout *glyphs, ShaperFlags) const override
void addOutlineToPath (qreal xx, qreal yy, const QGlyphLayout &glyphs, QPainterPath *pathpath, QTextItem::RenderFlags flagsflags) override
void addGlyphsToPath (glyph_t *glyphs, QFixedPoint *positions, int nglyphs, QPainterPath *pathpath, QTextItem::RenderFlags flagsflags) override
HGDIOBJ selectDesignFont () const
glyph_metrics_t boundingBox (glyph_t gg) override
glyph_metrics_t boundingBox (glyph_t gg, const QTransform &tt) override
QFixed xHeight () const override
QFixed capHeight () const override
QFixed averageCharWidth () const override
qreal maxCharWidth () const override
qreal minLeftBearing () const override
qreal minRightBearing () const override
QImage alphaMapForGlyph (glyph_t t) override
QImage alphaMapForGlyph (glyph_t, const QTransform &xform) override
QImage alphaRGBMapForGlyph (glyph_t tt, const QFixedPoint &subPixelPosition, const QTransform &xform) override
glyph_metrics_t alphaMapBoundingBox (glyph_t glyph, const QFixedPoint &, const QTransform &matrixmatrix, GlyphFormat) override
QFontEngine * cloneWithSize (qreal pixelSize) const override
Qt::HANDLE handle () const override
bool supportsTransformation (const QTransform &transformtransform) const override
void getGlyphBearings (glyph_t glyph, qreal *leftBearing=nullptr, qreal *rightBearing=nullptr) override
bool hasUnreliableGlyphOutline () const override
int getGlyphIndexes (const QChar *ch, int numChars, QGlyphLayout *glyphs, int *mappedGlyphs) const
void getCMap ()
bool getOutlineMetrics (glyph_t glyph, const QTransform &tt, glyph_metrics_t *metricsmetrics) const
const QSharedPointer< QWindowsFontEngineData > & fontEngineData () const
void setUniqueFamilyName (const QString &newName)
Public Member Functions inherited from QFontEngine
virtual ~QFontEngine ()
Type type () const
QByteArray getSfntTable (uint tag) const
bool supportsSubPixelPositions () const
virtual bool supportsHorizontalSubPixelPositions () const
virtual bool supportsVerticalSubPixelPositions () const
virtual QFixedPoint subPixelPositionFor (const QFixedPoint &position) const
QFixed subPixelPositionForX (QFixed xx) const
bool preferTypoLineMetrics () const
bool isColorFont () const
virtual void doKerning (QGlyphLayout *, ShaperFlags) const
void getGlyphPositions (const QGlyphLayout &glyphs, const QTransform &matrixmatrix, QTextItem::RenderFlags flagsflags, QVarLengthArray< glyph_t > &glyphs_out, QVarLengthArray< QFixedPoint > &positions)
void addBitmapFontToPath (qreal xx, qreal yy, const QGlyphLayout &, QPainterPath *, QTextItem::RenderFlags)
virtual QImage alphaMapForGlyph (glyph_t glyph, const QFixedPoint &subPixelPosition)
virtual QImage alphaMapForGlyph (glyph_t, const QFixedPoint &subPixelPosition, const QTransform &tt)
virtual QImage bitmapForGlyph (glyph_t, const QFixedPoint &subPixelPosition, const QTransform &tt, const QColor &colorcolor=QColor())
QImage renderedPathForGlyph (glyph_t glyph, const QColor &colorcolor)
qreal effectivePixelSizeSquared (const QTransform &transformtransform) const
bool glyphTransformExceedsLimit (glyph_t glyph, const QTransform &transformtransform)
virtual Glyph * glyphData (glyph_t glyph, const QFixedPoint &subPixelPosition, GlyphFormat neededFormat, const QTransform &tt)
virtual bool hasInternalCaching () const
virtual void removeGlyphFromCache (glyph_t)
virtual glyph_metrics_t boundingBox (const QGlyphLayout &glyphs)
glyph_metrics_t tightBoundingBox (const QGlyphLayout &glyphs, QTextItem::RenderFlags flagsflags)
virtual QFixed ascent () const
virtual QFixed descent () const
virtual QFixed leading () const
virtual QFixed underlinePosition () const
bool canRender (uint ucs4) const
virtual bool canRender (const QChar *str, int lenlen) const
virtual int glyphCount () const
virtual int glyphMargin (GlyphFormat formatformat)
bool hasHinting () const
virtual QList< QFontVariableAxis > variableAxes () const
virtual QString glyphName (glyph_t indexindex) const
virtual glyph_t findGlyph (QLatin1StringView namename) const
void * harfbuzzFont () const
void * harfbuzzFace () const
bool supportsScript (QChar::Script script) const
virtual int getPointInOutline (glyph_t glyph, int flagsflags, quint32 point, QFixed *xpos, QFixed *ypos, quint32 *nPoints)
void clearGlyphCache (const void *keykey)
void setGlyphCache (const void *keykey, QFontEngineGlyphCache *datadata)
QFontEngineGlyphCache * glyphCache (const void *keykey, GlyphFormat formatformat, const QTransform &transformtransform, const QColor &colorcolor=QColor()) const
virtual bool expectsGammaCorrectedBlending (QFontEngine::GlyphFormat formatformat) const
virtual void setDefaultHintStyle (HintStyle)
void loadKerningPairs (QFixed scalingFactor)

Protected Member Functions

void initializeHeightMetrics () const override
Protected Member Functions inherited from QFontEngine
 QFontEngine (Type typetype)
QFixed firstLeftBearing (const QGlyphLayout &glyphs)
QFixed lastRightBearing (const QGlyphLayout &glyphs)
QFixed calculatedCapHeight () const
bool processHheaTable () const
bool processOS2Table () const

Additional Inherited Members

Public Types inherited from QFontEngine
enum  Type {
  Box , Multi , Win , Mac ,
  Freetype , QPF1 , QPF2 , Proxy ,
  DirectWrite , TestFontEngine = 0x1000
}
enum  GlyphFormat {
  Format_None , Format_Render = Format_None , Format_Mono , Format_A8 ,
  Format_A32 , Format_ARGB
}
enum  ShaperFlag { DesignMetrics = 0x0002 , GlyphIndicesOnly = 0x0004 , FullStringFallback = 0x008 }
enum  SynthesizedFlags { SynthesizedItalic = 0x1 , SynthesizedBold = 0x2 , SynthesizedStretch = 0x4 }
enum  HintStyle {
  HintUnset = -1 , HintNone , HintLight , HintMedium ,
  HintFull
}
enum  SubpixelAntialiasingType {
  Subpixel_Unset = -1 , Subpixel_None , Subpixel_RGB , Subpixel_BGR ,
  Subpixel_VRGB , Subpixel_VBGR
}
Static Public Member Functions inherited from QFontEngine
static bool isIgnorableChar (char32_t ucs4)
static int maxCachedGlyphSize ()
static constexpr int maxColrv1NestingDepth ()
static bool glyphBoundingBoxExceedsLimit (qreal glyphWidth, qreal glyphHeight, qreal effectivePixelSizeSquared)
static bool scriptRequiresOpenType (QChar::Script script)
static const uchar * getCMap (const uchar *tabletable, uint tableSize, bool *isSymbolFont, int *cmapSize)
static quint32 getTrueTypeGlyphIndex (const uchar *cmap, int cmapSize, uint unicode)
static QByteArray convertToPostscriptFontFamilyName (const QByteArray &fontFamily)
static bool disableEmojiSegmenter ()
static constexpr qsizetype maximumEngineCount ()
Public Attributes inherited from QFontEngine
QAtomicInt ref
QFontDef fontDef
Holder font_
Holder face_
struct QFontEngine::FaceData faceData
uint cache_cost
uint fsType: 16
bool symbol
bool isSmoothlyScalable
QList< KernPair > kerning_pairs
GlyphFormat glyphFormat
int m_subPixelPositionCount
Protected Attributes inherited from QFontEngine
QFixed m_ascent
QFixed m_descent
QFixed m_leading
bool m_heightMetricsQueried

Detailed Description

Standard Windows font engine.

Will probably be superseded by a common Free Type font engine in Qt 5.X.

Definition at line 31 of file qwindowsfontengine_p.h.

Constructor & Destructor Documentation

◆ QWindowsFontEngine()

QWindowsFontEngine::QWindowsFontEngine ( const QString & name,
LOGFONT lf,
const QSharedPointer< QWindowsFontEngineData > & fontEngineData )

Definition at line 194 of file qwindowsfontengine.cpp.

◆ ~QWindowsFontEngine()

QWindowsFontEngine::~QWindowsFontEngine ( )
override

Definition at line 228 of file qwindowsfontengine.cpp.

Member Function Documentation

◆ addGlyphsToPath()

void QWindowsFontEngine::addGlyphsToPath ( glyph_t * glyphs,
QFixedPoint * positions,
int nglyphs,
QPainterPath * path,
QTextItem::RenderFlags flags )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 765 of file qwindowsfontengine.cpp.

◆ addOutlineToPath()

void QWindowsFontEngine::addOutlineToPath ( qreal x,
qreal y,
const QGlyphLayout & glyphs,
QPainterPath * path,
QTextItem::RenderFlags flags )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 795 of file qwindowsfontengine.cpp.

◆ alphaMapBoundingBox()

glyph_metrics_t QWindowsFontEngine::alphaMapBoundingBox ( glyph_t glyph,
const QFixedPoint & ,
const QTransform & matrix,
GlyphFormat format )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1011 of file qwindowsfontengine.cpp.

◆ alphaMapForGlyph() [1/2]

QImage QWindowsFontEngine::alphaMapForGlyph ( glyph_t glyph)
inlineoverridevirtual

Create a qimage with the alpha values for the glyph. Returns an image indexed_8 with index values ranging from 0=fully transparent to 255=opaque

Reimplemented from QFontEngine.

Definition at line 71 of file qwindowsfontengine_p.h.

◆ alphaMapForGlyph() [2/2]

QImage QWindowsFontEngine::alphaMapForGlyph ( glyph_t glyph,
const QTransform & xform )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1025 of file qwindowsfontengine.cpp.

◆ alphaRGBMapForGlyph()

QImage QWindowsFontEngine::alphaRGBMapForGlyph ( glyph_t t,
const QFixedPoint & subPixelPosition,
const QTransform & xform )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1079 of file qwindowsfontengine.cpp.

◆ averageCharWidth()

QFixed QWindowsFontEngine::averageCharWidth ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 512 of file qwindowsfontengine.cpp.

◆ boundingBox() [1/2]

glyph_metrics_t QWindowsFontEngine::boundingBox ( glyph_t g)
inlineoverridevirtual

Implements QFontEngine.

Definition at line 60 of file qwindowsfontengine_p.h.

◆ boundingBox() [2/2]

glyph_metrics_t QWindowsFontEngine::boundingBox ( glyph_t g,
const QTransform & t )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 427 of file qwindowsfontengine.cpp.

◆ capHeight()

QFixed QWindowsFontEngine::capHeight ( ) const
overridevirtual

Implements QFontEngine.

Definition at line 491 of file qwindowsfontengine.cpp.

◆ cloneWithSize()

QFontEngine * QWindowsFontEngine::cloneWithSize ( qreal pixelSize) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1115 of file qwindowsfontengine.cpp.

◆ emSquareSize()

QFixed QWindowsFontEngine::emSquareSize ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 845 of file qwindowsfontengine.cpp.

◆ faceId()

QFontEngine::FaceId QWindowsFontEngine::faceId ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 811 of file qwindowsfontengine.cpp.

◆ fontEngineData()

const QSharedPointer< QWindowsFontEngineData > & QWindowsFontEngine::fontEngineData ( ) const
inline

Definition at line 96 of file qwindowsfontengine_p.h.

◆ getCMap()

void QWindowsFontEngine::getCMap ( )

Definition at line 105 of file qwindowsfontengine.cpp.

◆ getGlyphBearings()

void QWindowsFontEngine::getGlyphBearings ( glyph_t glyph,
qreal * leftBearing = nullptr,
qreal * rightBearing = nullptr )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 548 of file qwindowsfontengine.cpp.

◆ getGlyphIndexes()

int QWindowsFontEngine::getGlyphIndexes ( const QChar * ch,
int numChars,
QGlyphLayout * glyphs,
int * mappedGlyphs ) const

Definition at line 143 of file qwindowsfontengine.cpp.

◆ getOutlineMetrics()

bool QWindowsFontEngine::getOutlineMetrics ( glyph_t glyph,
const QTransform & t,
glyph_metrics_t * metrics ) const

Definition at line 374 of file qwindowsfontengine.cpp.

◆ getSfntTableData()

bool QWindowsFontEngine::getSfntTableData ( uint tag,
uchar * buffer,
uint * length ) const
overridevirtual

Returns true if the font table idetified by tag exists in the font; returns false otherwise.

If buffer is \nullptr, stores the size of the buffer required for the font table data, in bytes, in length. If buffer is not \nullptr and the capacity of the buffer, passed in length, is sufficient to store the font table data, also copies the font table data to buffer.

Note: returning false when the font table exists could lead to an undefined behavior.

Reimplemented from QFontEngine.

Definition at line 899 of file qwindowsfontengine.cpp.

◆ getUnscaledGlyph()

void QWindowsFontEngine::getUnscaledGlyph ( glyph_t glyph,
QPainterPath * path,
glyph_metrics_t * metrics )
overridevirtual

Reimplemented from QFontEngine.

Definition at line 881 of file qwindowsfontengine.cpp.

References synthesized().

Here is the call graph for this function:

◆ glyphIndex()

glyph_t QWindowsFontEngine::glyphIndex ( uint ucs4) const
overridevirtual

Implements QFontEngine.

Definition at line 251 of file qwindowsfontengine.cpp.

◆ handle()

Qt::HANDLE QWindowsFontEngine::handle ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1141 of file qwindowsfontengine.cpp.

◆ hasUnreliableGlyphOutline()

bool QWindowsFontEngine::hasUnreliableGlyphOutline ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 575 of file qwindowsfontengine.cpp.

◆ initFontInfo()

void QWindowsFontEngine::initFontInfo ( const QFontDef & request,
int dpi )

Definition at line 1146 of file qwindowsfontengine.cpp.

◆ initializeHeightMetrics()

void QWindowsFontEngine::initializeHeightMetrics ( ) const
overrideprotectedvirtual

Reimplemented from QFontEngine.

Definition at line 566 of file qwindowsfontengine.cpp.

◆ lineThickness()

QFixed QWindowsFontEngine::lineThickness ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 62 of file qwindowsfontengine.cpp.

◆ maxCharWidth()

qreal QWindowsFontEngine::maxCharWidth ( ) const
overridevirtual

Implements QFontEngine.

Definition at line 517 of file qwindowsfontengine.cpp.

◆ minLeftBearing()

qreal QWindowsFontEngine::minLeftBearing ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 580 of file qwindowsfontengine.cpp.

◆ minRightBearing()

qreal QWindowsFontEngine::minRightBearing ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 588 of file qwindowsfontengine.cpp.

References char_table_entries.

◆ properties()

QFontEngine::Properties QWindowsFontEngine::properties ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 850 of file qwindowsfontengine.cpp.

◆ recalcAdvances()

void QWindowsFontEngine::recalcAdvances ( QGlyphLayout * glyphs,
ShaperFlags  ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 300 of file qwindowsfontengine.cpp.

◆ selectDesignFont()

HGDIOBJ QWindowsFontEngine::selectDesignFont ( ) const

Definition at line 268 of file qwindowsfontengine.cpp.

◆ setUniqueFamilyName()

void QWindowsFontEngine::setUniqueFamilyName ( const QString & newName)
inline

Definition at line 98 of file qwindowsfontengine_p.h.

◆ stringToCMap()

int QWindowsFontEngine::stringToCMap ( const QChar * str,
int len,
QGlyphLayout * glyphs,
int * nglyphs,
ShaperFlags flags ) const
overridevirtual

Implements QFontEngine.

Definition at line 277 of file qwindowsfontengine.cpp.

◆ supportsTransformation()

bool QWindowsFontEngine::supportsTransformation ( const QTransform & transform) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 1163 of file qwindowsfontengine.cpp.

◆ synthesized()

QT_BEGIN_INCLUDE_NAMESPACE QT_END_INCLUDE_NAMESPACE int QWindowsFontEngine::synthesized ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 820 of file qwindowsfontengine.cpp.

Referenced by getUnscaledGlyph().

Here is the caller graph for this function:

◆ xHeight()

QFixed QWindowsFontEngine::xHeight ( ) const
overridevirtual

Reimplemented from QFontEngine.

Definition at line 505 of file qwindowsfontengine.cpp.

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