summaryrefslogtreecommitdiff
path: root/src/fontpack.h
blob: f6d4d483a10028f511986820be09dd7f9f7344f6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
/* Copyright 2021 Jaakko Keränen <jaakko.keranen@iki.fi>

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */

#pragma once

#include <the_Foundation/archive.h>
#include <the_Foundation/ptrarray.h>
#include "stb_truetype.h"

#if defined (LAGRANGE_ENABLE_HARFBUZZ)
#   include <hb.h>
#endif

extern const char *mimeType_FontPack;

/* Fontpacks are ZIP archives that contain a configuration file and one of more font
files. The fontpack format is used instead of plain TTF/OTF because the text renderer
uses additional metadata about each font.

All the available fontpacks are loaded and used for looking up glyphs for rendering.
The user may install new fontpacks via the GUI. The user's fontpacks are stored inside
the config directory. There may also be fontpacks available from system-wide locations. */

enum iFontSize {
    uiNormal_FontSize, /* 1.000 -- keep at index 0 for convenience */
    uiMedium_FontSize, /* 1.125 */
    uiBig_FontSize,    /* 1.333 */
    uiLarge_FontSize,  /* 1.666 */
    uiTiny_FontSize,   /* 0.800 */
    uiSmall_FontSize,  /* 0.900 */
    contentRegular_FontSize,
    contentMedium_FontSize,
    contentBig_FontSize,
    contentLarge_FontSize,
    contentHuge_FontSize,
    contentTiny_FontSize,
    contentSmall_FontSize, /* e.g., preformatted block scaled smaller to fit */
    max_FontSize
};

enum iFontStyle {
    regular_FontStyle,
    italic_FontStyle,
    light_FontStyle,
    semiBold_FontStyle,
    bold_FontStyle,
    max_FontStyle,
    /* all permutations: */
    maxVariants_Fonts = max_FontStyle * max_FontSize
};

float   scale_FontSize  (enum iFontSize size);

/*----------------------------------------------------------------------------------------------*/

iDeclareClass(FontFile)
iDeclareObjectConstruction(FontFile)
    
struct Impl_FontFile {
    iObject         object; /* reference-counted */
    iString         id; /* for detecting when the same file is used in many places */
    int             colIndex;
    enum iFontStyle style;
    iBlock          sourceData;
    stbtt_fontinfo  stbInfo;
#if defined (LAGRANGE_ENABLE_HARFBUZZ)
    hb_blob_t *hbBlob;
    hb_face_t *hbFace;
    hb_font_t *hbFont;
#endif
    /* Metrics: */
    int ascent, descent, emAdvance;
};

float   scaleForPixelHeight_FontFile    (const iFontFile *, int pixelHeight);

iLocalDef uint32_t findGlyphIndex_FontFile(const iFontFile *d, iChar ch) {
    return stbtt_FindGlyphIndex(&d->stbInfo, ch);
}

uint8_t *   rasterizeGlyph_FontFile(const iFontFile *, float xScale, float yScale, float xShift,
                                    uint32_t glyphIndex, int *w, int *h); /* caller must free() the returned bitmap */
void        measureGlyph_FontFile  (const iFontFile *, uint32_t glyphIndex,
                                    float xScale, float yScale, float xShift,
                                    int *x0, int *y0, int *x1, int *y1);

/*----------------------------------------------------------------------------------------------*/

/* FontSpec describes a typeface, combining multiple fonts into a group.
   The user will be choosing FontSpecs instead of individual font files. */
iDeclareType(FontSpec)
iDeclareTypeConstruction(FontSpec)

enum iFontSpecFlags {
    user_FontSpecFlag             = iBit(1),  /* user's standalone font, can be used for anything */
    override_FontSpecFlag         = iBit(2),
    monospace_FontSpecFlag        = iBit(3),  /* can be used in preformatted content */
    auxiliary_FontSpecFlag        = iBit(4),  /* only used for looking up glyphs missing from other fonts */
    allowSpacePunct_FontSpecFlag  = iBit(5),  /* space/punctuation glyphs from this auxiliary font can be used */
    fixNunitoKerning_FontSpecFlag = iBit(31), /* manual hardcoded kerning tweaks for Nunito */
};

struct Impl_FontSpec {
    iString          id;         /* unique ID */
    iString          name;       /* human-readable label */
    iString          sourcePath; /* file where the path was loaded, could be a .fontpack */
    int              flags;
    int              priority;
    float            heightScale[2];     /* overall height scaling; ui, document */
    float            glyphScale[2];      /* ui, document */
    float            vertOffsetScale[2]; /* ui, document */
    const iFontFile *styles[max_FontStyle];
};

iLocalDef int scaleType_FontSpec(enum iFontSize sizeId) {
    iAssert(sizeId >= 0 && sizeId < max_FontSize);
    return sizeId < contentRegular_FontSize ? 0 : 1;
}

/*----------------------------------------------------------------------------------------------*/

iDeclareType(FontPack)
iDeclareTypeConstruction(FontPack)

iDeclareType(FontPackId)

struct Impl_FontPackId {
    const iString *id;
    int version;
};

void                setReadOnly_FontPack    (iFontPack *, iBool readOnly);
void                setStandalone_FontPack  (iFontPack *, iBool standalone);
void                setLoadPath_FontPack    (iFontPack *, const iString *path);
void                setUrl_FontPack         (iFontPack *, const iString *url);
iBool               loadArchive_FontPack    (iFontPack *, const iArchive *zip);
iBool               detect_FontPack         (const iBlock *data);

iFontPackId         id_FontPack             (const iFontPack *);
const iString *     loadPath_FontPack       (const iFontPack *); /* may return NULL */
iBool               isDisabled_FontPack     (const iFontPack *);
iBool               isReadOnly_FontPack     (const iFontPack *);
const iPtrArray *   listSpecs_FontPack      (const iFontPack *);
iString *           infoText_FontPack       (const iFontPack *, iBool isFull);
const iArray *      actions_FontPack        (const iFontPack *, iBool showInstalled);

const iString *     idFromUrl_FontPack      (const iString *url);

/*----------------------------------------------------------------------------------------------*/

void    init_Fonts      (const char *userDir);
void    deinit_Fonts    (void);

void                enablePack_Fonts            (const iString *packId, iBool enable);
void                updateActive_Fonts          (void);
const iFontPack *   pack_Fonts                  (const char *packId);
const iFontPack *   packByPath_Fonts            (const iString *path);
const iFontSpec *   findSpec_Fonts              (const char *fontId);
const iPtrArray *   listPacks_Fonts             (void);
const iPtrArray *   listSpecs_Fonts             (iBool (*filterFunc)(const iFontSpec *));
const iPtrArray *   listSpecsByPriority_Fonts   (void);
const iString *     infoPage_Fonts              (iRangecc query);
void                install_Fonts               (const iString *fontId, const iBlock *data);
void                installFontFile_Fonts       (const iString *fileName, const iBlock *data);
void                reload_Fonts                (void);

iLocalDef iBool isInstalled_Fonts(const char *packId) {
    return pack_Fonts(packId) != NULL;
}

void                searchOnlineLibraryForCharacters_Fonts  (const iString *chars);