KoSvgText::CssLengthPercentage Struct Reference

#include <KoSvgText.h>

Inheritance diagram for KoSvgText::CssLengthPercentage:

Public Types
enum	UnitType {   Absolute , Percentage , Em , Ex ,   Cap , Ch , Ic , Lh }

Public Member Functions
void	convertToAbsolute (const KoSvgText::FontMetrics metrics, const qreal fontSize, const UnitType percentageUnit=Em)
	CssLengthPercentage ()
	CssLengthPercentage (qreal value, UnitType unit=Absolute)
bool	operator== (const CssLengthPercentage &other) const

Public Attributes
UnitType	unit = Absolute
qreal	value = 0.0

Detailed Description

CssLengthPercentage is a struct that represents the CSS length-percentage, which is Css' way of saying that an attribute can be either a length (which are unit-based, including font-relative units) or a percentage (which is relative to a value on a case-by-case basis).

Most percentages in SVG are viewport based, which we just resolve during parsing, because KoShapes do not know anything about the doc they're in. A handful are font-size based, which we resolve to em, and this is also what this struct defaults to. A very small subset (text-indent and text path start-offset) are relative to other things, and these are solved during text-layout.

We currently use this for both Lengths and LengthPercentages (always saving as EM when it is a Length, in the case of TabSize). Whether and how a percentage should be resolved is defined in the CSS specs in the section a given property is specified.

Definition at line 406 of file KoSvgText.h.

Member Enumeration Documentation

UnitType

enum KoSvgText::CssLengthPercentage::UnitType

Enumerator
Absolute	Pt, everything needs to be converted to pt for this to work.
Percentage
Em	0 to 1.0
Ex	multiply by Font-size
Cap	multiply by font-x-height.
Ch	multiply by font cap height
Ic	multiply by width of "0", represents average proportional script advance.
Lh	multiply by width of "U+6C34", represents average full width script advance.

Definition at line 407 of file KoSvgText.h.

                  {
        Absolute, 
        Percentage, 
        Em, 
        Ex, 
        Cap,
        Ch, 
        Ic, 
        Lh, 
    };

Constructor & Destructor Documentation

CssLengthPercentage() [1/2]

KoSvgText::CssLengthPercentage::CssLengthPercentage ( )

inline

Definition at line 418 of file KoSvgText.h.

{}

CssLengthPercentage() [2/2]

KoSvgText::CssLengthPercentage::CssLengthPercentage ( qreal value, UnitType unit = Absolute )

inline

Definition at line 419 of file KoSvgText.h.

: value(value), unit(unit) {}

Member Function Documentation

convertToAbsolute()

void KoSvgText::CssLengthPercentage::convertToAbsolute	(	const KoSvgText::FontMetrics	metrics,
		const qreal	fontSize,
		const UnitType	percentageUnit = Em )

Definition at line 949 of file KoSvgText.cpp.

                                                                                                                                                      {
    UnitType u = unit;
    if (u == Percentage) {
        u = percentageUnit;
    }
 
    const qreal ftMultiplier = fontSize / metrics.fontSize;
    if (u == Em) {
        value = value * fontSize;
    } else if (u == Ex) {
        value = value * metrics.xHeight * ftMultiplier;
    } else if (u == Cap) {
        value = value * metrics.capHeight * ftMultiplier;
    } else if (u == Ch) {
        value = value * metrics.zeroAdvance * ftMultiplier;
    } else if (u == Ic) {
        value = value * metrics.ideographicAdvance * ftMultiplier;
    } else if (u == Lh) {
        value = value * (metrics.ascender - metrics.descender + metrics.lineGap) * ftMultiplier;
    }
    unit = Absolute;
}

References Absolute, KoSvgText::FontMetrics::ascender, Cap, KoSvgText::FontMetrics::capHeight, Ch, KoSvgText::FontMetrics::descender, Em, Ex, KoSvgText::FontMetrics::fontSize, Ic, KoSvgText::FontMetrics::ideographicAdvance, Lh, KoSvgText::FontMetrics::lineGap, Percentage, u, unit, value, KoSvgText::FontMetrics::xHeight, and KoSvgText::FontMetrics::zeroAdvance.

operator==()

bool KoSvgText::CssLengthPercentage::operator== ( const CssLengthPercentage & other ) const

inline

Definition at line 426 of file KoSvgText.h.

                                                             {
        return qFuzzyCompare(value, other.value) && unit == other.unit;
    }

References qFuzzyCompare(), unit, and value.

Member Data Documentation

unit

UnitType KoSvgText::CssLengthPercentage::unit = Absolute

Definition at line 422 of file KoSvgText.h.

value

qreal KoSvgText::CssLengthPercentage::value = 0.0

Definition at line 421 of file KoSvgText.h.

---

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

• libs/flake/text/KoSvgText.h
• libs/flake/text/KoSvgText.cpp