KoCssTextUtils Class Reference

The KoCssTextUtils class. More...

#include <KoCssTextUtils.h>

Static Public Member Functions
static bool	characterCanHang (QChar c, KoSvgText::HangingPunctuations hangType)
	characterCanHang The function returns whether the character qualifies for 'hanging-punctuation', using the given hang-type.
static bool	collapseLastSpace (QChar c, KoSvgText::TextSpaceCollapse collapseMethod)
	collapseLastSpace Some versions of CSS-Text 'white-space' or 'text-space-collapse' will collapse the last spaces while others don't. This function returns whether that's the case.
static QVector< bool >	collapseSpaces (QString *text, QMap< int, KoSvgText::TextSpaceCollapse > collapseMethods)
	collapseSpaces Some versions of CSS-Text 'white-space' or 'text-space-collapse' will collapse or transform white space characters while others don't. This function returns whether that's the case.
static qreal	cssSelectFontStyleValue (const QVector< qreal > &values, const qreal targetValue, const qreal defaultValue, const qreal defaultValueUpper, const bool shouldNotReturnDefault)
	cssSelectFontStyleValue Select the closest font style value from the list, following the CSS Fonts selection algorithm. Note that for slant, this needs to be inverted.
static QString	getBidiClosing (KoSvgText::UnicodeBidi bidi)
	getBidiClosing Returns the bidi closing string associated with the given Css unicode-bidi value.
static QString	getBidiOpening (bool ltr, KoSvgText::UnicodeBidi bidi)
	getBidiOpening Get the bidi opening string associated with the given Css unicode-bidi value and direction https://www.w3.org/TR/css-writing-modes-3/#unicode-bidi
static bool	hangLastSpace (const QChar c, KoSvgText::TextSpaceCollapse collapseMethod, KoSvgText::TextWrap wrapMethod, bool &force, bool nextCharIsHardBreak)
	hangLastSpace Some versions of CSS-Text 'white-space' or 'text-space-collapse' will hang the final space depending on the situation.
static bool	IsCssWordSeparator (QString grapheme)
	IsCssWordSeparator CSS has a number of characters it considers word-separators, which are used in justification and for word-spacing.
static QVector< QPair< bool, bool > >	justificationOpportunities (QString text, QString langCode)
	justificationOpportunities mark justification opportunities in the text. Opportunities are between characters, so this returns a pair of before and after. As of currently, this only implements the bare minimum for CSS-Text-3 auto justification.
static void	removeText (QString &text, int &start, int length)
	removeText Special removal of text that takes a text, start and length and will modify these values so that...
static QStringList	textToUnicodeGraphemeClusters (const QString &text, const QString &langCode)
	textToUnicodeGraphemes In letters like Å, the amount of unicode codpoints can be 1, but it can also be 2, one for 'A', and one for 'Combining Mark Ring Above". In some letters used by Vietnamese, such as ỗ there can be even 3. Such codepoint sequences are considered 'grapheme-clusters'. For editing text, matching fonts or capitalizing the first letter, it's wisest to do so on the grapheme clusters instead of the individual codepoints.
static QString	transformTextCapitalize (const QString &text, QString langCode, QVector< QPair< int, int > > &positions)
	transformTextToUpperCase This function splits the text into graphemes, and then uses QLocale::toUpper for each letter following a whitespace character or CSS Wordseparator. It has a small codepath for transforming the Dutch IJ correctly, as this is more readable. Note: When building Qt without ICU, this uses platform dependant functions.
static QString	transformTextFullSizeKana (const QString &text)
	transformTextFullSizeKana This function will take 'small' Kana (Japanese phonetic script) and transform it to their 'full-size' equivalents, following the list in the CSS-Text-3 spec.
static QString	transformTextFullWidth (const QString &text)
	transformTextFullWidth This function will transform 'narrow' or 'halfwidth' characters to their normal counterparts, and will transform ascii characters to their 'fullwidth'/'ideographic' counterparts.
static QString	transformTextToLowerCase (const QString &text, const QString &langCode, QVector< QPair< int, int > > &positions)
	transformTextToUpperCase convenience function that creates a QLocale and uses it's 'toLower' function. Note: When building Qt without ICU, this uses platform dependant functions.
static QString	transformTextToUpperCase (const QString &text, const QString &langCode, QVector< QPair< int, int > > &positions)
	transformTextToUpperCase convenience function that creates a QLocale and uses it's 'toUpper' function. Note: When building Qt without ICU, this uses platform dependant functions.

Detailed Description

The KoCssTextUtils class.

This class keeps a number of utility functions related to CSS Text, in particular CSS-Text-3 and CSS-Text-4.

Definition at line 21 of file KoCssTextUtils.h.

Member Function Documentation

characterCanHang()

bool KoCssTextUtils::characterCanHang ( QChar c, KoSvgText::HangingPunctuations hangType )

static

characterCanHang The function returns whether the character qualifies for 'hanging-punctuation', using the given hang-type.

Parameters

c	the character to check.
hangType	how to hang.

Returns

whether the character can hang.

Definition at line 329 of file KoCssTextUtils.cpp.

{
    if (hangType.testFlag(KoSvgText::HangFirst)) {
        if (c.category() == QChar::Punctuation_InitialQuote || // Pi
            c.category() == QChar::Punctuation_Open || // Ps
            c.category() == QChar::Punctuation_FinalQuote || // Pf
            c == "\u0027" || // Apostrophe
            c == "\uFF07" || // Fullwidth Apostrophe
            c == "\u0022" || // Quotation Mark
            c == "\uFF02") { // Fullwidth Quotation Mark
            return true;
        }
    }
    if (hangType.testFlag(KoSvgText::HangLast)) {
        if (c.category() == QChar::Punctuation_InitialQuote || // Pi
            c.category() == QChar::Punctuation_FinalQuote || // Pf
            c.category() == QChar::Punctuation_Close || // Pe
            c == "\u0027" || // Apostrophe
            c == "\uFF07" || // Fullwidth Apostrophe
            c == "\u0022" || // Quotation Mark
            c == "\uFF02") { // Fullwidth Quotation Mark
            return true;
        }
    }
    if (hangType.testFlag(KoSvgText::HangEnd)) {
        if (c == "\u002c" || // Comma
            c == "\u002e" || // Full Stop
            c == "\u060c" || // Arabic Comma
            c == "\u06d4" || // Arabic Full Stop
            c == "\u3001" || // Ideographic Comma
            c == "\u3002" || // Ideographic Full Stop
            c == "\uff0c" || // Fullwidth Comma
            c == "\uff0e" || // Fullwidth full stop
            c == "\ufe50" || // Small comma
            c == "\ufe51" || // Small ideographic comma
            c == "\ufe52" || // Small full stop
            c == "\uff61" || // Halfwidth ideographic full stop
            c == "\uff64" // halfwidth ideographic comma
        ) {
            return true;
        }
    }
    return false;
}

References KoSvgText::HangEnd, KoSvgText::HangFirst, and KoSvgText::HangLast.

collapseLastSpace()

bool KoCssTextUtils::collapseLastSpace ( QChar c, KoSvgText::TextSpaceCollapse collapseMethod )

static

collapseLastSpace Some versions of CSS-Text 'white-space' or 'text-space-collapse' will collapse the last spaces while others don't. This function returns whether that's the case.

Parameters

c	the character to check.
collapseMethod	the text-space collapse type.

Returns

whether the character should collapse if it's the last space in a line.

Definition at line 272 of file KoCssTextUtils.cpp.

{
    bool collapse = false;
    if (c == QChar::LineFeed) {
        collapse = true;
    } else if (c.isSpace()) {
        switch (collapseMethod) {
        case KoSvgText::Collapse:
        case KoSvgText::Discard:
            collapse = true;
            break;
        case KoSvgText::Preserve:
        case KoSvgText::BreakSpaces:
            collapse = false;
            break;
        case KoSvgText::PreserveBreaks:
            collapse = true;
            break;
        case KoSvgText::PreserveSpaces:
            collapse = false;
            break;
        }
    }
    return collapse;
}

References KoSvgText::BreakSpaces, KoSvgText::Collapse, KoSvgText::Discard, KoSvgText::Preserve, KoSvgText::PreserveBreaks, and KoSvgText::PreserveSpaces.

collapseSpaces()

QVector< bool > KoCssTextUtils::collapseSpaces ( QString * text, QMap< int, KoSvgText::TextSpaceCollapse > collapseMethods )

static

collapseSpaces Some versions of CSS-Text 'white-space' or 'text-space-collapse' will collapse or transform white space characters while others don't. This function returns whether that's the case.

Parameters

text	the text to check against, this text will be transformed if the collapse method requires that.
collapseMethod	the white-space/text-space-collapse method, with the key indicating the position in the string at which it starts.

Returns

A vector of booleans the size of the input text that marks whether the character should be collapsed.

Definition at line 199 of file KoCssTextUtils.cpp.

{
 
    QString modifiedText = *text;
    QVector<bool> collapseList(modifiedText.size());
    collapseList.fill(false);
    int spaceSequenceCount = 0;
    KoSvgText::TextSpaceCollapse collapseMethod = collapseMethods.first();
    for (int i = 0; i < modifiedText.size(); i++) {
        bool firstOrLast = (i == 0 || i == modifiedText.size() - 1);
        bool collapse = false;
        if (collapseMethods.contains(i)) {
            // If a whitespace:collapse sequence is inside a pre-wrap sequence, the first space needs to be left alone.
            if (collapseMethods.value(i) != collapseMethod) spaceSequenceCount = 0;
            collapseMethod = collapseMethods.value(i);
        }
        const QChar c = modifiedText.at(i);
        if (c == QChar::LineFeed || c == QChar::Tabulation) {
            if (collapseMethod == KoSvgText::Collapse ||
                    collapseMethod == KoSvgText::PreserveSpaces) {
                modifiedText[i] = QChar::Space;
                spaceSequenceCount += 1;
                collapseList[i] = spaceSequenceCount > 1 || firstOrLast? true: false;
                continue;
            }
        }
        if (c.isSpace()) {
            bool isSegmentBreak = c == QChar::LineFeed;
            bool isTab = c == QChar::Tabulation;
            spaceSequenceCount += 1;
            if (spaceSequenceCount > 1 || firstOrLast) {
                switch (collapseMethod) {
                case KoSvgText::Collapse:
                case KoSvgText::Discard:
                    collapse = true;
                    break;
                case KoSvgText::Preserve:
                case KoSvgText::BreakSpaces:
                case KoSvgText::PreserveSpaces:
                    collapse = false;
                    break;
                case KoSvgText::PreserveBreaks:
                    collapse = !isSegmentBreak;
                    if (isTab) {
                        modifiedText[i] = QChar::Space;
                    }
                    break;
                }
            }
        } else {
            spaceSequenceCount = 0;
        }
        collapseList[i] = collapse;
    }
    // go backward to ensure any dangling space characters are marked as collapsed.
    for (int i = modifiedText.size()-1; i>=0; i--) {
        if (collapseMethods.contains(i)) {
            int pos = collapseMethods.keys().indexOf(i);
            collapseMethod = collapseMethods.value(collapseMethods.keys().value(pos-1, 0), KoSvgText::Collapse);
            if (collapseMethod != KoSvgText::Collapse) break;
        }
        if (modifiedText.at(i).isSpace()) {
            if (collapseMethod == KoSvgText::Collapse) {
                collapseList[i] = true;
            }
        } else {
            break;
        }
    }
    *text = modifiedText;
    return collapseList;
}

References KoSvgText::BreakSpaces, KoSvgText::Collapse, KoSvgText::Discard, KoSvgText::Preserve, KoSvgText::PreserveBreaks, and KoSvgText::PreserveSpaces.

cssSelectFontStyleValue()

qreal KoCssTextUtils::cssSelectFontStyleValue ( const QVector< qreal > & values, const qreal targetValue, const qreal defaultValue, const qreal defaultValueUpper, const bool shouldNotReturnDefault )

static

cssSelectFontStyleValue Select the closest font style value from the list, following the CSS Fonts selection algorithm. Note that for slant, this needs to be inverted.

Parameters

values	– values list to search in.
targetValue	– the target value to search for.
defaultValue	– the (lower-end) default value for the given axis.
defaultValueUpper	– the upper-end of the default value, for example, for weight this is 100 larger than default, for the others it is exactly the same.
shouldNotReturnDefault	– used for the slants, as they need to fall back on one another.

Returns

closest value on this list.

Definition at line 592 of file KoCssTextUtils.cpp.

{
    if(values.isEmpty()) {
        return targetValue;
    }
    // follow the CSS Fonts selection mechanism.
    // See https://drafts.csswg.org/css-fonts-4/#font-style-matching
    QVector<qreal> sortedValues = values;
    std::sort(sortedValues.begin(), sortedValues.end());
    qreal selectedValue = defaultValue;
    auto upper = std::lower_bound(sortedValues.begin(), sortedValues.end(), targetValue);
    if (upper == sortedValues.end()) {
        upper--;
    }
    auto lower = upper;
    if (lower != sortedValues.begin() && *lower > targetValue) {
        lower--;
    }
 
    // ... Which wants to select the lower possible selection when the value is below the default.
    if (targetValue < defaultValue) {
        selectedValue = *lower;
    // ... the higher closest value when the value is higher than the default (upper bound)
    } else if (targetValue > defaultValueUpper) {
        selectedValue = *upper;
    } else {
        // ... and if the value is between the lower and upper default bounds, first higher (within bounds)
        // then lower, then higher.
        if (*upper <= defaultValueUpper && *lower != targetValue) {
            selectedValue = *upper;
        } else {
            selectedValue = *lower;
        }
    }
    if (qFuzzyCompare(selectedValue, defaultValue) && shouldNotReturnDefault) {
        return targetValue;
    }
    return selectedValue;
}

References qFuzzyCompare().

getBidiClosing()

QString KoCssTextUtils::getBidiClosing ( KoSvgText::UnicodeBidi bidi )

static

getBidiClosing Returns the bidi closing string associated with the given Css unicode-bidi value.

Parameters

bidi	– the unicode-bidi value

Returns

string with bidi closing marks.

Definition at line 488 of file KoCssTextUtils.cpp.

{
    using namespace KoSvgText;
 
    QString result;
 
    if (bidi == BidiEmbed || bidi == BidiOverride) {
        result = BIDI_CONTROL_PDF;
    } else if (bidi == BidiIsolate || bidi == BidiPlainText) {
        result = BIDI_CONTROL_PDI;
    } else if (bidi == BidiIsolateOverride) {
        result = UNICODE_BIDI_ISOLATE_OVERRIDE_END;
    }
 
    return result;
}

References BIDI_CONTROL_PDF, BIDI_CONTROL_PDI, and UNICODE_BIDI_ISOLATE_OVERRIDE_END.

getBidiOpening()

QString KoCssTextUtils::getBidiOpening ( bool ltr, KoSvgText::UnicodeBidi bidi )

static

getBidiOpening Get the bidi opening string associated with the given Css unicode-bidi value and direction https://www.w3.org/TR/css-writing-modes-3/#unicode-bidi

Parameters

ltr	– whether the direction is left-to-right
bidi	– the unicodee-bidi value.

Returns

string with bidi opening marks.

Definition at line 453 of file KoCssTextUtils.cpp.

{
    using namespace KoSvgText;
 
    QString result;
 
    if (ltr) {
        if (bidi == BidiEmbed) {
            result = BIDI_CONTROL_LRE;
        } else if (bidi == BidiOverride) {
            result = BIDI_CONTROL_LRO;
        } else if (bidi == BidiIsolate) {
            result = BIDI_CONTROL_LRI;
        } else if (bidi == BidiIsolateOverride) {
            result = UNICODE_BIDI_ISOLATE_OVERRIDE_LR_START;
        } else if (bidi == BidiPlainText) {
            result = BIDI_CONTROL_FSI;
        }
    } else {
        if (bidi == BidiEmbed) {
            result = BIDI_CONTROL_RLE;
        } else if (bidi == BidiOverride) {
            result = BIDI_CONTROL_RLO;
        } else if (bidi == BidiIsolate) {
            result = BIDI_CONTROL_RLI;
        } else if (bidi == BidiIsolateOverride) {
            result = UNICODE_BIDI_ISOLATE_OVERRIDE_RL_START;
        } else if (bidi == BidiPlainText) {
            result = BIDI_CONTROL_FSI;
        }
    }
 
    return result;
}

References BIDI_CONTROL_FSI, BIDI_CONTROL_LRE, BIDI_CONTROL_LRI, BIDI_CONTROL_LRO, BIDI_CONTROL_RLE, BIDI_CONTROL_RLI, BIDI_CONTROL_RLO, UNICODE_BIDI_ISOLATE_OVERRIDE_LR_START, and UNICODE_BIDI_ISOLATE_OVERRIDE_RL_START.

hangLastSpace()

bool KoCssTextUtils::hangLastSpace ( const QChar c, KoSvgText::TextSpaceCollapse collapseMethod, KoSvgText::TextWrap wrapMethod, bool & force, bool nextCharIsHardBreak )

static

hangLastSpace Some versions of CSS-Text 'white-space' or 'text-space-collapse' will hang the final space depending on the situation.

Parameters

c	the character in question.
collapseMethod	the collapse method
wrapMethod	the wrap method.
force	whether said hang is a forced hang or not.
nextCharIsHardBreak	whether the next char is a line break.

Returns

Definition at line 298 of file KoCssTextUtils.cpp.

{
    if (c.isSpace()) {
        if (collapseMethod == KoSvgText::Collapse || collapseMethod == KoSvgText::PreserveBreaks) {
            // [css-text-3] white-space is set to normal, nowrap, or pre-line; or
            // [css-text-4] white-space-collapse is collapse or preserve-breaks:
            // hang unconditionally.
            force = true;
            return true;
        } else if (collapseMethod == KoSvgText::Preserve && wrapMethod != KoSvgText::NoWrap) {
            // [css-text-3] white-space is set to pre-wrap; or
            // [css-text-4] white-space-collapse is preserve and text-wrap is not nowrap:
            // hang unconditionally, unless followed by a force line break,
            // in which case conditionally hang.
 
            if (nextCharIsHardBreak) {
                force = false;
            } else {
                force = true;
            }
            return true;
        }
    }
 
    return false;
}

References KoSvgText::Collapse, KoSvgText::NoWrap, KoSvgText::Preserve, and KoSvgText::PreserveBreaks.

IsCssWordSeparator()

bool KoCssTextUtils::IsCssWordSeparator ( QString grapheme )

static

IsCssWordSeparator CSS has a number of characters it considers word-separators, which are used in justification and for word-spacing.

Parameters

grapheme

a grapheme to check. Using graphemes here, because some of the word-separators are not in the unicode basic plane.

Returns

true if it is a word-separator

Definition at line 374 of file KoCssTextUtils.cpp.

{
    return (grapheme == "\u0020" || // Space
        grapheme == "\u00A0" || // No Break Space
        grapheme == "\u1361" || // Ethiopic Word Space
        grapheme == "\u10100" || // Aegean Word Sepator Line
        grapheme == "\u10101" || // Aegean Word Sepator Dot
        grapheme == "\u1039F");
}

justificationOpportunities()

QVector< QPair< bool, bool > > KoCssTextUtils::justificationOpportunities ( QString text, QString langCode )

static

justificationOpportunities mark justification opportunities in the text. Opportunities are between characters, so this returns a pair of before and after. As of currently, this only implements the bare minimum for CSS-Text-3 auto justification.

Parameters

text	the text to check against.
langCode	language, used for the grapheme breaking.

Returns

a list of booleans for whether the current codePoint represents a justificaton opportunity.

Definition at line 424 of file KoCssTextUtils.cpp.

{
    QVector<QPair<bool, bool>> opportunities(text.size());
    opportunities.fill(QPair<bool, bool>(false, false));
    QStringList graphemes = textToUnicodeGraphemeClusters(text, langCode);
    for (int i = 0; i < graphemes.size(); i++) {
        QString grapheme = graphemes.at(i);
        if (IsCssWordSeparator(grapheme) || blockScript.contains(grapheme.at(0).script())
                || clusterScript.contains(grapheme.at(0).script())) {
            opportunities[i] = QPair<bool, bool>(true, true);
        }
    }
    return opportunities;
}

References blockScript, clusterScript, IsCssWordSeparator(), and textToUnicodeGraphemeClusters().

removeText()

void KoCssTextUtils::removeText ( QString & text, int & start, int length )

static

removeText Special removal of text that takes a text, start and length and will modify these values so that...

• Whole code points are deleted at any time, avoiding no dangling surrogates.
• Graphemes don't end with Zero-width-joiners, as that can lead to the grapheme merging with the next.
• Variation selectors are deleted along their base.
• regional sequences are deleted in pairs.

  Parameters

  text	text to remove text from.
  start	the start index, will be modified.
  length	the length.

Definition at line 532 of file KoCssTextUtils.cpp.

{
    int end = start+length;
    int j = 0;
    int v = 0;
    int lastCharZWJ = 0;
    int lastVS = 0;
    int vsClusterStart = 0;
    int regionalIndicatorCount = 0;
    bool startFound = false;
    bool addToEnd = true;
    Q_FOREACH(const uint i, text.toUcs4()) {
        v = QChar::requiresSurrogates(i)? 2: 1;
        int index = (j+v) -1;
        bool ZWJ = text.at(index) == ZERO_WIDTH_JOINER;
        if (isVariationSelector(i)) {
            lastVS += v;
        } else {
            lastVS = 0;
            vsClusterStart = j;
        }
        if (index >= start && !startFound) {
            startFound = true;
            if (v > 1) {
                start = j;
            }
            if (regionalIndicatorCount > 0 && regionalIndicator(i)) {
                start -= regionalIndicatorCount;
                regionalIndicatorCount = 0;
            }
            // Always delete any zero-width-joiners as well.
            if (ZWJ && index > start) {
                start = -1;
            }
            if (lastCharZWJ > 0) {
                start -= lastCharZWJ;
                lastCharZWJ = 0;
            }
            // remove any clusters too.
            if (lastVS > 0) {
                start = vsClusterStart;
            }
        }
 
 
        if (j >= end && addToEnd) {
            end = j;
            addToEnd =  ZWJ || isVariationSelector(i)
                    || (regionalIndicatorCount < 3 && regionalIndicator(i));
            if (addToEnd) {
                end += v;
            }
        }
        j += v;
        lastCharZWJ = ZWJ? lastCharZWJ + v: 0;
        regionalIndicatorCount = regionalIndicator(i)? regionalIndicatorCount + v: 0;
    }
    text.remove(start, end-start);
}

References isVariationSelector(), length(), regionalIndicator(), v, and ZERO_WIDTH_JOINER.

textToUnicodeGraphemeClusters()

QStringList KoCssTextUtils::textToUnicodeGraphemeClusters ( const QString & text, const QString & langCode )

static

textToUnicodeGraphemes In letters like Å, the amount of unicode codpoints can be 1, but it can also be 2, one for 'A', and one for 'Combining Mark Ring Above". In some letters used by Vietnamese, such as ỗ there can be even 3. Such codepoint sequences are considered 'grapheme-clusters'. For editing text, matching fonts or capitalizing the first letter, it's wisest to do so on the grapheme clusters instead of the individual codepoints.

Parameters

text	the text to break.
langCode	the language code of the text, BCP style.

Returns

a QStringList of the graphemes as separate strings.

Definition at line 384 of file KoCssTextUtils.cpp.

{
    QVector<char> graphemeBreaks(text.size());
    set_graphemebreaks_utf16(text.utf16(), static_cast<size_t>(text.size()), langCode.toUtf8().data(), graphemeBreaks.data());
    QStringList graphemes;
    int graphemeLength = 0;
    int lastGrapheme = 0;
    for (int i = 0; i < text.size(); i++) {
        graphemeLength += 1;
        bool breakGrapheme = lastGrapheme + graphemeLength < text.size() ? graphemeBreaks[i] == GRAPHEMEBREAK_BREAK : false;
        if (breakGrapheme) {
            graphemes.append(text.mid(lastGrapheme, graphemeLength));
            lastGrapheme += graphemeLength;
            graphemeLength = 0;
        }
    }
    graphemes.append(text.mid(lastGrapheme, text.size() - lastGrapheme));
    return graphemes;
}

transformTextCapitalize()

QString KoCssTextUtils::transformTextCapitalize ( const QString & text, QString langCode, QVector< QPair< int, int > > & positions )

static

transformTextToUpperCase This function splits the text into graphemes, and then uses QLocale::toUpper for each letter following a whitespace character or CSS Wordseparator. It has a small codepath for transforming the Dutch IJ correctly, as this is more readable. Note: When building Qt without ICU, this uses platform dependant functions.

Parameters

text	the text to transform.
langCode	the language code in BCP format, it gets transformed to qLocale's format.

Returns

the transformed string.

While this is the only case I know of, make no mistake, "IJsbeer" (Polar bear) is much more readable than "Ijsbeer".

Definition at line 56 of file KoCssTextUtils.cpp.

{
    if (text.isEmpty()) return text;
    QLocale locale(langCode);
 
    QStringList graphemes = textToUnicodeGraphemeClusters(text, langCode);
    QStringList oldGraphemes = graphemes;
    bool capitalizeGrapheme = true;
    for (int i = 0; i < graphemes.size(); i++) {
        QString grapheme = graphemes.at(i);
        if (grapheme.isEmpty() || IsCssWordSeparator(grapheme)) {
            capitalizeGrapheme = true;
 
        } else if (capitalizeGrapheme) {
            graphemes[i] = locale.toUpper(grapheme);
            if (i + 1 < graphemes.size()) {
                if (locale == QLocale::Dutch && grapheme.toLower().startsWith("i") && graphemes.at(i + 1).toLower().startsWith("j")) {
                    capitalizeGrapheme = true;
                    continue;
                }
            }
            capitalizeGrapheme = false;
        }
    }
 
    positions = positionDifference(oldGraphemes, graphemes);
    return graphemes.join("");
}

References IsCssWordSeparator(), positionDifference(), and textToUnicodeGraphemeClusters().

transformTextFullSizeKana()

QString KoCssTextUtils::transformTextFullSizeKana ( const QString & text )

static

transformTextFullSizeKana This function will take 'small' Kana (Japanese phonetic script) and transform it to their 'full-size' equivalents, following the list in the CSS-Text-3 spec.

Parameters

text	the text to transform.

Returns

the transformed text.

Definition at line 189 of file KoCssTextUtils.cpp.

{
    QString transformedText;
    Q_FOREACH (const QChar &c, text) {
        transformedText.append(findSmallKanaToBigKana(c, c));
    }
 
    return transformedText;
}

References findSmallKanaToBigKana().

transformTextFullWidth()

QString KoCssTextUtils::transformTextFullWidth ( const QString & text )

static

transformTextFullWidth This function will transform 'narrow' or 'halfwidth' characters to their normal counterparts, and will transform ascii characters to their 'fullwidth'/'ideographic' counterparts.

Parameters

text	the text to transform.

Returns

the transformed text.

Definition at line 103 of file KoCssTextUtils.cpp.

{
    if (text.isEmpty()) return text;
    QString transformedText;
    Q_FOREACH (const QChar &c, text) {
        if (c.decompositionTag() == QChar::Narrow) {
            transformedText.append(c.decomposition());
        } else {
            transformedText.append(findProportionalToFullWidth(c, c));
        }
    }
 
    return transformedText;
}

References findProportionalToFullWidth().

transformTextToLowerCase()

QString KoCssTextUtils::transformTextToLowerCase ( const QString & text, const QString & langCode, QVector< QPair< int, int > > & positions )

static

transformTextToUpperCase convenience function that creates a QLocale and uses it's 'toLower' function. Note: When building Qt without ICU, this uses platform dependant functions.

Parameters

text	the text to transform.
langCode	the language code in BCP format, it gets transformed to qLocale's format.

Returns

the transformed string.

Definition at line 47 of file KoCssTextUtils.cpp.

{
    if (text.isEmpty()) return text;
    QLocale locale(langCode.split("-").join("_"));
    QString transformedText = locale.toLower(text);
    positions = positionDifference(textToUnicodeGraphemeClusters(text, langCode), textToUnicodeGraphemeClusters(transformedText, langCode));
    return transformedText;
}

References positionDifference(), and textToUnicodeGraphemeClusters().

transformTextToUpperCase()

QString KoCssTextUtils::transformTextToUpperCase ( const QString & text, const QString & langCode, QVector< QPair< int, int > > & positions )

static

transformTextToUpperCase convenience function that creates a QLocale and uses it's 'toUpper' function. Note: When building Qt without ICU, this uses platform dependant functions.

Parameters

text	the text to transform.
langCode	the language code in BCP format, it gets transformed to qLocale's format.

Returns

the transformed string.

Definition at line 38 of file KoCssTextUtils.cpp.

{
    if (text.isEmpty()) return text;
    QLocale locale(langCode.split("-").join("_"));
    QString transformedText = locale.toUpper(text);
    positions = positionDifference(textToUnicodeGraphemeClusters(text, langCode), textToUnicodeGraphemeClusters(transformedText, langCode));
    return transformedText;
}

References positionDifference(), and textToUnicodeGraphemeClusters().

---

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

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