KisTofuGlyph Namespace Reference

Tasty tofu for Kiki. More...

Functions
static void	addHexChar (QPainterPath &p, unsigned value, int row, int col)
	Adds a hex char at the specified row/column to the QPainterPath.
QPainterPath	create (char32_t codepoint, double height)
	Creates a tofu missing glyph indicator representing the provided Unicode codepoint.
static QPainterPath	getHexChar (unsigned value)
static QPainterPath	hexChar0 ()
static QPainterPath	hexChar1 ()
static QPainterPath	hexChar2 ()
static QPainterPath	hexChar3 ()
static QPainterPath	hexChar4 ()
static QPainterPath	hexChar5 ()
static QPainterPath	hexChar6 ()
static QPainterPath	hexChar7 ()
static QPainterPath	hexChar8 ()
static QPainterPath	hexChar9 ()
static QPainterPath	hexCharA ()
static QPainterPath	hexCharB ()
static QPainterPath	hexCharC ()
static QPainterPath	hexCharD ()
static QPainterPath	hexCharE ()
static QPainterPath	hexCharF ()
static QPolygon	lowerHole ()
static QPainterPath	makeFrame (const int width)
	Creates the frame of a tofu glyph.
static QPolygon	upperHole ()
static constexpr unsigned	valueAt (const char32_t codepoint, const unsigned place)
	Gets the hex digit at a place.

Detailed Description

Tasty tofu for Kiki.

Whenever we try to render a piece of text and it contains Unicode codepoints that have no suitable glyphs in any of the matched fonts, a default glyph, typically a small rectangle that resembles a block of "tofu" is rendered in its place.

Some applications (Firefox for example) take it further and, instead of showing a hollow rectangle, actually print the hex representation of the Unicode codepoint inside the rectangle, as a missing glyph indicator. KisTofuGlyph does exactly this for Krita.

Function Documentation

addHexChar()

static void KisTofuGlyph::addHexChar ( QPainterPath & p, unsigned value, int row, int col )

static

Adds a hex char at the specified row/column to the QPainterPath.

Definition at line 371 of file KisTofuGlyph.cpp.

{
    QPainterPath glyph = getHexChar(value);
    glyph.translate(2 + col * 4, 2 + row * 6);
    p.addPath(glyph);
}

References getHexChar(), p, and value().

create()

QPainterPath KisTofuGlyph::create	(	char32_t	codepoint,
		double	height )

Creates a tofu missing glyph indicator representing the provided Unicode codepoint.

Parameters

codepoint

Unicode codepoint to display

Returns

QPainterPath the glyph scaled to the specified height.

Definition at line 404 of file KisTofuGlyph.cpp.

{
    // We build the glyph as a 15x15 or 11x15 grid of squares.
    QPainterPath p;
    if (codepoint > 0xFFFF) {
        // Codepoints outside the BMP need more than 4 digits to display, so we show 6.
        // +---+
        // |01F|
        // |389| => U+1F389
        // +---+
        static const QPainterPath s_outline15 = makeFrame(15);
        p.addPath(s_outline15);
        addHexChar(p, valueAt(codepoint, 5), 0, 0);
        addHexChar(p, valueAt(codepoint, 4), 0, 1);
        addHexChar(p, valueAt(codepoint, 3), 0, 2);
        addHexChar(p, valueAt(codepoint, 2), 1, 0);
        addHexChar(p, valueAt(codepoint, 1), 1, 1);
        addHexChar(p, valueAt(codepoint, 0), 1, 2);
    } else {
        // +--+
        // |27|
        // |64| => U+2764
        // +--+
        static const QPainterPath s_outline11 = makeFrame(11);
        p.addPath(s_outline11);
        addHexChar(p, valueAt(codepoint, 3), 0, 0);
        addHexChar(p, valueAt(codepoint, 2), 0, 1);
        addHexChar(p, valueAt(codepoint, 1), 1, 0);
        addHexChar(p, valueAt(codepoint, 0), 1, 1);
    }
    const auto scale = (1. / 15.) * height;
    return QTransform::fromScale(scale, scale).map(p);
}

References addHexChar(), makeFrame(), p, and valueAt().

getHexChar()

static QPainterPath KisTofuGlyph::getHexChar ( unsigned value )

static

Definition at line 329 of file KisTofuGlyph.cpp.

{
    switch (value) {
    case 0x0:
        return hexChar0();
    case 0x1:
        return hexChar1();
    case 0x2:
        return hexChar2();
    case 0x3:
        return hexChar3();
    case 0x4:
        return hexChar4();
    case 0x5:
        return hexChar5();
    case 0x6:
        return hexChar6();
    case 0x7:
        return hexChar7();
    case 0x8:
        return hexChar8();
    case 0x9:
        return hexChar9();
    case 0xA:
        return hexCharA();
    case 0xB:
        return hexCharB();
    case 0xC:
        return hexCharC();
    case 0xD:
        return hexCharD();
    case 0xE:
        return hexCharE();
    case 0xF:
        return hexCharF();
    }
    return {};
}

References hexChar0(), hexChar1(), hexChar2(), hexChar3(), hexChar4(), hexChar5(), hexChar6(), hexChar7(), hexChar8(), hexChar9(), hexCharA(), hexCharB(), hexCharC(), hexCharD(), hexCharE(), hexCharF(), and value().

hexChar0()

static QPainterPath KisTofuGlyph::hexChar0 ( )

inlinestatic

Definition at line 31 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path0 = []() {
        const QPolygon b{QVector<QPoint>{{1, 1}, {1, 4}, {2, 4}, {2, 1}}};
        QPainterPath p;
        p.addRect(0, 0, 3, 5);
        p.addPolygon(b);
        return p;
    }();
    return s_path0;
}

References p.

hexChar1()

static QPainterPath KisTofuGlyph::hexChar1 ( )

inlinestatic

Definition at line 43 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path1 = []() {
        QPainterPath p;
        p.addRect(1, 0, 1, 5);
        return p;
    }();
    return s_path1;
}

References p.

hexChar2()

static QPainterPath KisTofuGlyph::hexChar2 ( )

inlinestatic

Definition at line 53 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path2 = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 3},
            {1, 3},
            {1, 4},
            {3, 4},
            {3, 5},
            {0, 5},
            {0, 2},
            {2, 2},
            {2, 1},
            {0, 1},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_path2;
}

References p.

hexChar3()

static QPainterPath KisTofuGlyph::hexChar3 ( )

inlinestatic

Definition at line 77 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path3 = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 5},
            {0, 5},
            {0, 4},
            {2, 4},
            {2, 3},
            {0, 3},
            {0, 2},
            {2, 2},
            {2, 1},
            {0, 1},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_path3;
}

References p.

hexChar4()

static QPainterPath KisTofuGlyph::hexChar4 ( )

inlinestatic

Definition at line 101 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path4 = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {1, 0},
            {1, 2},
            {2, 2},
            {2, 0},
            {3, 0},
            {3, 5},
            {2, 5},
            {2, 3},
            {0, 3},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_path4;
}

References p.

hexChar5()

static QPainterPath KisTofuGlyph::hexChar5 ( )

inlinestatic

Definition at line 123 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path5 = []() {
        // Just mirror a "2".
        QPainterPath p = hexChar2();
        return QTransform::fromScale(-1, 1).map(p).toReversed().translated(3, 0);
    }();
    return s_path5;
}

References hexChar2(), and p.

hexChar6()

static QPainterPath KisTofuGlyph::hexChar6 ( )

inlinestatic

Definition at line 133 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path6 = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 1},
            {1, 1},
            {1, 2},
            {3, 2},
            {3, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        p.addPolygon(lowerHole());
        return p;
    }();
    return s_path6;
}

References lowerHole(), and p.

hexChar7()

static QPainterPath KisTofuGlyph::hexChar7 ( )

inlinestatic

Definition at line 154 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path7 = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 5},
            {2, 5},
            {2, 1},
            {0, 1},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_path7;
}

References p.

hexChar8()

static QPainterPath KisTofuGlyph::hexChar8 ( )

inlinestatic

Definition at line 172 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path8 = []() {
        QPainterPath p;
        p.addRect(0, 0, 3, 5);
        p.addPolygon(upperHole());
        p.addPolygon(lowerHole());
        return p;
    }();
    return s_path8;
}

References lowerHole(), p, and upperHole().

hexChar9()

static QPainterPath KisTofuGlyph::hexChar9 ( )

inlinestatic

Definition at line 184 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_path9 = []() {
        // Just rotate a "6" upside-down
        QPainterPath p = hexChar6();
        return QTransform::fromScale(-1, -1).map(p).translated(3, 5);
    }();
    return s_path9;
}

References hexChar6(), and p.

hexCharA()

static QPainterPath KisTofuGlyph::hexCharA ( )

inlinestatic

Definition at line 194 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathA = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 5},
            {2, 5},
            {2, 3},
            {1, 3},
            {1, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        p.addPolygon(upperHole());
        return p;
    }();
    return s_pathA;
}

References p, and upperHole().

hexCharB()

static QPainterPath KisTofuGlyph::hexCharB ( )

inlinestatic

Definition at line 215 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathB = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {2, 0},
            {2, 1},
            {3, 1},
            {3, 2},
            {2, 2},
            {2, 3},
            {3, 3},
            {3, 4},
            {2, 4},
            {2, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        p.addPolygon(upperHole());
        p.addPolygon(lowerHole());
        return p;
    }();
    return s_pathB;
}

References lowerHole(), p, and upperHole().

hexCharC()

static QPainterPath KisTofuGlyph::hexCharC ( )

inlinestatic

Definition at line 241 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathC = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 1},
            {1, 1},
            {1, 4},
            {3, 4},
            {3, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_pathC;
}

References p.

hexCharD()

static QPainterPath KisTofuGlyph::hexCharD ( )

inlinestatic

Definition at line 261 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathD = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {2, 0},
            {2, 1},
            {1, 1},
            {1, 4},
            {2, 4},
            {2, 5},
            {0, 5},
        }};
        const QPolygon b{QVector<QPoint>{{2, 1}, {3, 1}, {3, 4}, {2, 4}}};
        QPainterPath p;
        p.addPolygon(a);
        p.addPolygon(b);
        return p;
    }();
    return s_pathD;
}

References p.

hexCharE()

static QPainterPath KisTofuGlyph::hexCharE ( )

inlinestatic

Definition at line 283 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathE = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 1},
            {1, 1},
            {1, 2},
            {3, 2},
            {3, 3},
            {1, 3},
            {1, 4},
            {3, 4},
            {3, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_pathE;
}

References p.

hexCharF()

static QPainterPath KisTofuGlyph::hexCharF ( )

inlinestatic

Definition at line 307 of file KisTofuGlyph.cpp.

{
    static const QPainterPath s_pathF = []() {
        const QPolygon a{QVector<QPoint>{
            {0, 0},
            {3, 0},
            {3, 1},
            {1, 1},
            {1, 2},
            {3, 2},
            {3, 3},
            {1, 3},
            {1, 5},
            {0, 5},
        }};
        QPainterPath p;
        p.addPolygon(a);
        return p;
    }();
    return s_pathF;
}

References p.

lowerHole()

static QPolygon KisTofuGlyph::lowerHole ( )

inlinestatic

Definition at line 26 of file KisTofuGlyph.cpp.

{
    return {QVector<QPoint>{{1, 3}, {1, 4}, {2, 4}, {2, 3}}};
}

makeFrame()

static QPainterPath KisTofuGlyph::makeFrame ( const int width )

inlinestatic

Creates the frame of a tofu glyph.

Definition at line 393 of file KisTofuGlyph.cpp.

{
    const int inner = width - 1;
    const QPolygon a{QVector<QPoint>{{0, 0}, {width, 0}, {width, 15}, {0, 15}}};
    const QPolygon b{QVector<QPoint>{{1, 1}, {1, 14}, {inner, 14}, {inner, 1}}};
    QPainterPath p;
    p.addPolygon(a);
    p.addPolygon(b);
    return p;
}

References p.

upperHole()

static QPolygon KisTofuGlyph::upperHole ( )

inlinestatic

Definition at line 21 of file KisTofuGlyph.cpp.

{
    return {QVector<QPoint>{{1, 1}, {1, 2}, {2, 2}, {2, 1}}};
}

valueAt()

static constexpr unsigned KisTofuGlyph::valueAt ( const char32_t codepoint, const unsigned place )

staticconstexpr

Gets the hex digit at a place.

Parameters

codepoint
place	0-base digit index

Returns

the digit

Definition at line 385 of file KisTofuGlyph.cpp.

{
    return (codepoint >> (place * 4)) & 0xF;
}