Contains pre-calculated metrics of a QgsTextDocument. More...

#include <qgstextdocumentmetrics.h>

Public Member Functions
double	ascentOffset () const
	Returns the ascent offset of the first block in the document. More...

double	baselineOffset (int blockIndex, Qgis::TextLayoutMode mode) const
	Returns the offset from the top of the document to the text baseline for the given block index. More...

double	blockHeight (int blockIndex) const
	Returns the height of the block at the specified index. More...

double	blockMaximumCharacterWidth (int blockIndex) const
	Returns the maximum character width for the specified block. More...

double	blockMaximumDescent (int blockIndex) const
	Returns the maximum descent encountered in the specified block. More...

double	blockWidth (int blockIndex) const
	Returns the width of the block at the specified index. More...

QSizeF	documentSize (Qgis::TextLayoutMode mode, Qgis::TextOrientation orientation) const
	Returns the overall size of the document. More...

QFont	fragmentFont (int blockIndex, int fragmentIndex) const
	Returns the calculated font for the fragment at the specified block and fragment indices. More...

double	verticalOrientationXOffset (int blockIndex) const
	Returns the vertical orientation x offset for the specified block. More...

Static Public Member Functions
static QgsTextDocumentMetrics	calculateMetrics (const QgsTextDocument &document, const QgsTextFormat &format, const QgsRenderContext &context, double scaleFactor=1.0)
	Returns precalculated text metrics for a text document, when rendered using the given base format and render context. More...

Detailed Description

Contains pre-calculated metrics of a QgsTextDocument.

Warning: This API is not considered stable and may change in future QGIS versions.

Since: QGIS 3.28

Definition at line 40 of file qgstextdocumentmetrics.h.

Member Function Documentation

◆ ascentOffset()

double QgsTextDocumentMetrics::ascentOffset ( ) const

inline

Returns the ascent offset of the first block in the document.

Definition at line 98 of file qgstextdocumentmetrics.h.

◆ baselineOffset()

double QgsTextDocumentMetrics::baselineOffset	(	int	blockIndex,
		Qgis::TextLayoutMode	mode
	)		const

Returns the offset from the top of the document to the text baseline for the given block index.

Definition at line 239 of file qgstextdocumentmetrics.cpp.

◆ blockHeight()

double QgsTextDocumentMetrics::blockHeight ( int blockIndex ) const

Returns the height of the block at the specified index.

Definition at line 234 of file qgstextdocumentmetrics.cpp.

◆ blockMaximumCharacterWidth()

double QgsTextDocumentMetrics::blockMaximumCharacterWidth ( int blockIndex ) const

Returns the maximum character width for the specified block.

Definition at line 258 of file qgstextdocumentmetrics.cpp.

◆ blockMaximumDescent()

double QgsTextDocumentMetrics::blockMaximumDescent ( int blockIndex ) const

Returns the maximum descent encountered in the specified block.

Definition at line 263 of file qgstextdocumentmetrics.cpp.

◆ blockWidth()

double QgsTextDocumentMetrics::blockWidth ( int blockIndex ) const

Returns the width of the block at the specified index.

Definition at line 229 of file qgstextdocumentmetrics.cpp.

◆ calculateMetrics()

QgsTextDocumentMetrics QgsTextDocumentMetrics::calculateMetrics	(	const QgsTextDocument &	document,
		const QgsTextFormat &	format,
		const QgsRenderContext &	context,
		double	scaleFactor = `1.0`
	)

static

Returns precalculated text metrics for a text document, when rendered using the given base format and render context.

The optional scaleFactor parameter can specify a font size scaling factor. It is recommended to set this to QgsTextRenderer::FONT_WORKAROUND_SCALE and then manually calculations based on the resultant font metrics. Failure to do so will result in poor quality text rendering at small font sizes.

Definition at line 26 of file qgstextdocumentmetrics.cpp.

◆ documentSize()

QSizeF QgsTextDocumentMetrics::documentSize	(	Qgis::TextLayoutMode	mode,
		Qgis::TextOrientation	orientation
	)		const

Returns the overall size of the document.

Definition at line 204 of file qgstextdocumentmetrics.cpp.

◆ fragmentFont()

QFont QgsTextDocumentMetrics::fragmentFont	(	int	blockIndex,
		int	fragmentIndex
	)		const

Returns the calculated font for the fragment at the specified block and fragment indices.

Definition at line 268 of file qgstextdocumentmetrics.cpp.

◆ verticalOrientationXOffset()

double QgsTextDocumentMetrics::verticalOrientationXOffset ( int blockIndex ) const

Returns the vertical orientation x offset for the specified block.

Definition at line 253 of file qgstextdocumentmetrics.cpp.

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

/build/qgis-3.28.0+99sid/src/core/textrenderer/qgstextdocumentmetrics.h
/build/qgis-3.28.0+99sid/src/core/textrenderer/qgstextdocumentmetrics.cpp

Public Member Functions

Static Public Member Functions