Table of Contents

Property FontSize

Namespace
BitMiracle.Docotic.Pdf
Assembly
BitMiracle.Docotic.Pdf.dll

FontSize

Gets the scale factor of the font used to draw this chunk.

public double FontSize { get; }

Property Value

double

The scale factor of the font used to draw this chunk.

Remarks

A font defines the glyphs for one standard size. This standard is arranged so that the nominal height of tightly spaced lines of text is 1 unit. In the default user coordinate system, this means the standard glyph size is 1 point (or 1 ⁄ 72 inch). The standard-size font must then be scaled to be usable.

This property retrieves the scale factor used to draw the text chunk. Usually, the FontSize property retrieves values like 10, 12, 14. But the FontSize might have an arbitrary value like 1, 1000, -1, -10. It's just a scale factor.

The final height of the text chunk depends on both FontSize and TransformationMatrix properties.

For a non-transformed text the TransformationMatrix is the identity matrix (the IsIdentity() property is equal to true). In such a case the absolute text height is equal to Math.Abs(FontSize).

For a scaled text the TransformationMatrix looks like { M11; 0; 0; M22; 0; 0 }. In such a case the absolute text height is equal to Math.Abs(TransformationMatrix.M22 * FontSize).

For an arbitrarily transformed text the TransformationMatrix looks like { M11; M12; M21; M22; X; Y }. In such a case the absolute text height is equal to (Math.Abs(FontSize) * Math.Sqrt(Math.Pow(TransformationMatrix.M21, 2) + Math.Pow(TransformationMatrix.M22, 2))).

Let's try to understand the nature of this formula. At first, the matrix { FontSize, 0, 0, FontSize, 0, 0 } is multiplied by the current TransformationMatrix (current matrix being the right multiplier). The resulting matrix is { M11 * FontSize; M12 * FontSize; M21 * FontSize; M22 * FontSize; X; Y }. Then we calculate the text height in the new transformed space. We map points (0; 0) and (0; 1) from default space to the transformed space. The result is (X; Y) and (M21 * FontSize + X; M22 * FontSize + Y), respectively. And finally we calculate the length of this vector, that is exactly the absolute text height in the transformed space: Math.Sqrt(Math.Pow(M21 * FontSize, 2) + Math.Pow(M22 * FontSize, 2)) = Math.Abs(FontSize) * Math.Sqrt(Math.Pow(M21, 2) + Math.Pow(M22, 2)).

Below is an example of rotated text for which the FontSize is equal to 1.

PdfTextData properties explained

Read the Extract detailed text information for an example of using text data.

See Also