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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
|
/* See LICENSE file for copyright and license details. */
#ifndef LIBSKRIFT_H
#define LIBSKRIFT_H 1
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#if defined(__GNUC__)
# define _LIBSKRIFT_GCC_ONLY(...) __VA_ARGS__
#else
# define _LIBSKRIFT_GCC_ONLY(...)
#endif
#define LIBSKRIFT_RENDERING_STRUCT_VERSION 0
#define LIBSKRIFT_NONE 0
typedef struct libskrift_context LIBSKRIFT_CONTEXT;
typedef struct libskrift_font LIBSKRIFT_FONT;
typedef uint_least32_t libskrift_codepoint_t;
enum libskrift_format {
LIBSKRIFT_RAW,
LIBSKRIFT_R8G8B8,
LIBSKRIFT_X8R8G8B8,
LIBSKRIFT_A8R8G8B8,
LIBSKRIFT_R8G8B8A8,
LIBSKRIFT_R16G16B16,
LIBSKRIFT_X16R16G16B16,
LIBSKRIFT_A16R16G16B16,
LIBSKRIFT_R16G16B16A16,
LIBSKRIFT_R32G32B32,
LIBSKRIFT_X32R32G32B32,
LIBSKRIFT_A32R32G32B32,
LIBSKRIFT_R32G32B32A32,
LIBSKRIFT_R64G64B64,
LIBSKRIFT_X64R64G64B64,
LIBSKRIFT_A64R64G64B64,
LIBSKRIFT_R64G64B64A64,
LIBSKRIFT_RGB_FLOAT,
LIBSKRIFT_ARGB_FLOAT,
LIBSKRIFT_RGBA_FLOAT,
LIBSKRIFT_RGB_DOUBLE,
LIBSKRIFT_ARGB_DOUBLE,
LIBSKRIFT_RGBA_DOUBLE,
LIBSKRIFT_RGB_LONG_DOUBLE,
LIBSKRIFT_ARGB_LONG_DOUBLE,
LIBSKRIFT_RGBA_LONG_DOUBLE
};
enum libskrift_endian {
LIBSKRIFT_HOST_PIXEL,
LIBSKRIFT_NETWORK_PIXEL,
LIBSKRIFT_REVERSE_NETWORK_PIXEL,
LIBSKRIFT_HOST_SUBPIXEL,
LIBSKRIFT_NETWORK_SUBPIXEL,
LIBSKRIFT_REVERSE_NETWORK_SUBPIXEL
#define LIBSKRIFT_BE_PIXEL LIBSKRIFT_NETWORK_PIXEL
#define LIBSKRIFT_BE_SUBPIXEL LIBSKRIFT_NETWORK_SUBPIXEL
#define LIBSKRIFT_LE_PIXEL LIBSKRIFT_REVERSE_NETWORK_PIXEL
#define LIBSKRIFT_LE_SUBPIXEL LIBSKRIFT_REVERSE_NETWORK_SUBPIXEL
};
enum libskrift_subpixel_order {
LIBSKRIFT_OTHER, /* LIBSKRIFT_NONE */
LIBSKRIFT_RGB,
LIBSKRIFT_BGR,
LIBSKRIFT_VRGB,
LIBSKRIFT_VBGR
};
enum libskrift_smoothing {
LIBSKRIFT_MONOCHROME, /* LIBSKRIFT_NONE */
LIBSKRIFT_GREYSCALE,
LIBSKRIFT_SUBPIXEL
};
enum libskrift_hinting {
LIBSKRIFT_UNHINTED = 0, /* LIBSKRIFT_NONE */
LIBSKRIFT_SLIGHT = 25,
LIBSKRIFT_MEDIUM = 50,
LIBSKRIFT_FULL = 100
};
#define LIBSKRIFT_REMOVE_GAMMA 0x00000001L
#define LIBSKRIFT_Y_INCREASES_UPWARDS 0x00000002L /* SFT_DOWNWARD_Y otherwise */
#define LIBSKRIFT_FLIP_TEXT 0x00000004L
#define LIBSKRIFT_MIRROR_TEXT 0x00000008L
#define LIBSKRIFT_MIRROR_CHARS 0x00000010L
#define LIBSKRIFT_TRANSPOSE_TEXT 0x00000020L
#define LIBSKRIFT_TRANSPOSE_CHARS 0x00000040L
#define LIBSKRIFT_NO_LIGATURES 0x00000080L
#define LIBSKRIFT_ADVANCE_CHAR_TO_GRID 0x00000100L
#define LIBSKRIFT_REGRESS_CHAR_TO_GRID 0x00000200L /* Combine with LIBSKRIFT_ADVANCE_CHAR_TO_GRID for closest alternative */
#define LIBSKRIFT_ADVANCE_WORD_TO_GRID 0x00000400L
#define LIBSKRIFT_REGRESS_WORD_TO_GRID 0x00000800L /* Combine with LIBSKRIFT_ADVANCE_WORD_TO_GRID for closest alternative */
#define LIBSKRIFT_USE_SUBPIXEL_GRID 0x00001000L
#define LIBSKRIFT_VERTICAL_TEXT 0x00002000L
#define LIBSKRIFT_AUTOHINTING 0x00004000L /* Use autohinter even if hint information exists */
#define LIBSKRIFT_NO_AUTOHINTING 0x00008000L /* Use autohinter if no hint information exist */
#define LIBSKRIFT_AUTOKERNING 0x00010000L /* Use autokerner even if kerning information exists */
#define LIBSKRIFT_NO_AUTOKERNING 0x00020000L /* Use autokerner if no kerning information exist */
struct libskrift_rendering {
int struct_version;
enum libskrift_subpixel_order subpixel_order;
enum libskrift_smoothing smoothing;
enum libskrift_hinting hinting;
uint32_t flags;
int grid_fineness;
double horizontal_dpi;
double vertical_dpi;
double kerning;
double interletter_spacing;
double prestroke_transformation_rotation[4];
double left_transformation[6];
double right_transformation[6];
double top_transformation[6];
double bottom_transformation[6];
double poststroke_transformation_rotation[4];
double char_transformation[6];
double text_transformation[6];
};
struct libskrift_glyph {
double advance;
int16_t x;
int16_t y;
uint16_t width;
uint16_t height;
size_t size;
uint8_t image[];
};
struct libskrift_saved_grapheme {
libskrift_codepoint_t cp;
size_t len;
};
struct libskrift_image {
enum libskrift_format format;
enum libskrift_endian endian;
int premultiplied;
uint16_t width;
uint16_t height;
void (*preprocess)(struct libskrift_image *image, size_t x, size_t y, size_t width, size_t height);
void (*postprocess)(struct libskrift_image *image, size_t x, size_t y, size_t width, size_t height);
void *image;
};
struct libskrift_colour {
double opacity; /* [0, 1] */
double alpha; /* [0, .opacity] */
double red; /* [0, .alpha] */
double green; /* [0, .alpha] */
double blue; /* [0, .alpha] */
};
#define LIBSKRIFT_DEFAULT_RENDERING {\
.struct_version = LIBSKRIFT_RENDERING_STRUCT_VERSION,\
.subpixel_order = LIBSKRIFT_NONE,\
.smoothing = LIBSKRIFT_GREYSCALE,\
.hinting = LIBSKRIFT_FULL,\
.flags = 0,\
.grid_fineness = 1,\
.horizontal_dpi = (double)1920 * 254 / 5180,\
.vertical_dpi = (double)1200 * 254 / 3240,\
.kerning = 1,\
.interletter_spacing = 0,\
.prestroke_transformation_rotation = {1, 0, 0, 1},\
.left_transformation = {1, 0, 0, 0, 1, 0},\
.right_transformation = {1, 0, 0, 0, 1, 0},\
.top_transformation = {1, 0, 0, 0, 1, 0},\
.bottom_transformation = {1, 0, 0, 0, 1, 0},\
.poststroke_transformation_rotation = {1, 0, 0, 1},\
.char_transformation = {1, 0, 0, 0, 1, 0},\
.text_transformation = {1, 0, 0, 0, 1, 0},\
}
#define LIBSKRIFT_NO_SAVED_GRAPHEME {0, 0}
#define LIBSKRIFT_PREMULTIPLY(OPACITY, ALPHA, RED, GREEN, BLUE)\
{(OPACITY),\
(ALPHA) * (OPACITY),\
(RED) * (ALPHA) * (OPACITY),\
(GREEN) * (ALPHA) * (OPACITY),\
(BLUE) * (ALPHA) * (OPACITY)}
_LIBSKRIFT_GCC_ONLY(__attribute__((__const__, __warn_unused_result__)))
inline double
libskrift_calculate_dpi(double pixels, double millimeters)
{
return pixels * 254 / 10 / millimeters;
}
_LIBSKRIFT_GCC_ONLY(__attribute__((__const__, __warn_unused_result__)))
inline double
libskrift_inches_to_pixels(double inches, const struct libskrift_rendering *rendering)
{
return inches * rendering->vertical_dpi;
}
_LIBSKRIFT_GCC_ONLY(__attribute__((__const__, __warn_unused_result__)))
inline double
libskrift_millimeters_to_pixels(double millimeters, const struct libskrift_rendering *rendering)
{
return millimeters * 10 / 254 * rendering->vertical_dpi;
}
_LIBSKRIFT_GCC_ONLY(__attribute__((__const__, __warn_unused_result__)))
inline double
libskrift_points_to_pixels(double points, const struct libskrift_rendering *rendering)
{
return points / 72 * rendering->vertical_dpi;
}
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_open_font_file(LIBSKRIFT_FONT **, const char *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_open_font_mem(LIBSKRIFT_FONT **, const void *, size_t);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_open_font_fd(LIBSKRIFT_FONT **, int);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_open_font(LIBSKRIFT_FONT **, FILE *);
void libskrift_close_font(LIBSKRIFT_FONT *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__(1, 2))))
int libskrift_create_context(LIBSKRIFT_CONTEXT **, LIBSKRIFT_FONT **, size_t, double, const struct libskrift_rendering *, void *);
void libskrift_free_context(LIBSKRIFT_CONTEXT *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__, __returns_nonnull__, __warn_unused_result__, __const__)))
const struct libskrift_rendering *libskrift_get_rendering_settings(LIBSKRIFT_CONTEXT *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_get_grapheme_glyph(LIBSKRIFT_CONTEXT *, libskrift_codepoint_t, double, double, struct libskrift_glyph **);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__(1, 2, 6))))
ssize_t libskrift_get_cluster_glyph(LIBSKRIFT_CONTEXT *, const char *, struct libskrift_saved_grapheme *,
double, double, struct libskrift_glyph **);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
int libskrift_merge_glyphs(LIBSKRIFT_CONTEXT *, const struct libskrift_glyph *, const struct libskrift_glyph *,
struct libskrift_glyph **);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__(1, 2, 6))))
int libskrift_apply_glyph(LIBSKRIFT_CONTEXT *, const struct libskrift_glyph *, const struct libskrift_colour *,
int16_t, int16_t, struct libskrift_image *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__(1, 2, 6))))
int libskrift_draw_text(LIBSKRIFT_CONTEXT *, const char *, const struct libskrift_colour *,
int16_t, int16_t, struct libskrift_image *);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
void libskrift_srgb_preprocess(struct libskrift_image *, size_t, size_t, size_t, size_t);
_LIBSKRIFT_GCC_ONLY(__attribute__((__nonnull__)))
void libskrift_srgb_postprocess(struct libskrift_image *, size_t, size_t, size_t, size_t);
#endif
|
