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.
Read the Extract detailed text information for an example of using text data.
- See Also