Coverage Report

Created: 2026-11-10 07:41

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/harfbuzz/src/hb-ot-shaper-arabic-fallback.hh
Line
Count
Source
1
/*
2
 * Copyright © 2012  Google, Inc.
3
 *
4
 *  This is part of HarfBuzz, a text shaping library.
5
 *
6
 * Permission is hereby granted, without written agreement and without
7
 * license or royalty fees, to use, copy, modify, and distribute this
8
 * software and its documentation for any purpose, provided that the
9
 * above copyright notice and the following two paragraphs appear in
10
 * all copies of this software.
11
 *
12
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
13
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
14
 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
15
 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
16
 * DAMAGE.
17
 *
18
 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
19
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
20
 * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
21
 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
22
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
23
 *
24
 * Google Author(s): Behdad Esfahbod
25
 */
26
27
#ifndef HB_OT_SHAPER_ARABIC_FALLBACK_HH
28
#define HB_OT_SHAPER_ARABIC_FALLBACK_HH
29
30
#include "hb.hh"
31
32
#include "hb-ot-shape.hh"
33
#include "hb-ot-layout-gsub-table.hh"
34
35
36
/* Features ordered the same as the entries in shaping_table rows,
37
 * followed by rlig.  Don't change.
38
 *
39
 * We currently support one subtable per lookup, and one lookup
40
 * per feature.  But we allow duplicate features, so we use that!
41
 */
42
static const hb_tag_t arabic_fallback_features[] =
43
{
44
  HB_TAG('i','n','i','t'),
45
  HB_TAG('m','e','d','i'),
46
  HB_TAG('f','i','n','a'),
47
  HB_TAG('i','s','o','l'),
48
  HB_TAG('r','l','i','g'),
49
  HB_TAG('r','l','i','g'),
50
  HB_TAG('r','l','i','g'),
51
};
52
53
static OT::SubstLookup *
54
arabic_fallback_synthesize_lookup_single (const hb_ot_shape_plan_t *plan HB_UNUSED,
55
            hb_font_t *font,
56
            unsigned int feature_index)
57
0
{
58
0
  OT::HBGlyphID16 glyphs[SHAPING_TABLE_LAST - SHAPING_TABLE_FIRST + 1];
59
0
  OT::HBGlyphID16 substitutes[SHAPING_TABLE_LAST - SHAPING_TABLE_FIRST + 1];
60
0
  unsigned int num_glyphs = 0;
61
62
  /* Populate arrays */
63
0
  for (hb_codepoint_t u = SHAPING_TABLE_FIRST; u < SHAPING_TABLE_LAST + 1; u++)
64
0
  {
65
0
    hb_codepoint_t s = shaping_table[u - SHAPING_TABLE_FIRST][feature_index];
66
0
    hb_codepoint_t u_glyph, s_glyph;
67
68
0
    if (!s ||
69
0
  !hb_font_get_glyph (font, u, 0, &u_glyph) ||
70
0
  !hb_font_get_glyph (font, s, 0, &s_glyph) ||
71
0
  u_glyph == s_glyph ||
72
0
  u_glyph > 0xFFFFu || s_glyph > 0xFFFFu)
73
0
      continue;
74
75
0
    glyphs[num_glyphs] = u_glyph;
76
0
    substitutes[num_glyphs] = s_glyph;
77
78
0
    num_glyphs++;
79
0
  }
80
81
0
  if (!num_glyphs)
82
0
    return nullptr;
83
84
  /* Bubble-sort or something equally good!
85
   * May not be good-enough for presidential candidate interviews, but good-enough for us... */
86
0
  hb_stable_sort (&glyphs[0], num_glyphs,
87
0
      (int(*)(const OT::HBUINT16*, const OT::HBUINT16 *)) OT::HBGlyphID16::cmp,
88
0
      &substitutes[0]);
89
90
91
  /* Each glyph takes four bytes max, and there's some overhead. */
92
0
  char buf[(SHAPING_TABLE_LAST - SHAPING_TABLE_FIRST + 1) * 4 + 128];
93
0
  hb_serialize_context_t c (buf, sizeof (buf));
94
0
  OT::SubstLookup *lookup = c.start_serialize<OT::SubstLookup> ();
95
0
  bool ret = lookup->serialize_single (&c,
96
0
               OT::LookupFlag::IgnoreMarks,
97
0
               hb_sorted_array (glyphs, num_glyphs),
98
0
               hb_array (substitutes, num_glyphs));
99
0
  c.end_serialize ();
100
101
0
  return ret && !c.in_error () ? c.copy<OT::SubstLookup> () : nullptr;
102
0
}
103
104
template <typename T>
105
static OT::SubstLookup *
106
arabic_fallback_synthesize_lookup_ligature (const hb_ot_shape_plan_t *plan HB_UNUSED,
107
              hb_font_t *font,
108
              const T &ligature_table,
109
              unsigned lookup_flags)
110
0
{
111
0
  constexpr size_t table_length = ARRAY_LENGTH (ligature_table);
112
0
  constexpr size_t ligature_count = ARRAY_LENGTH (ligature_table[0].ligatures);
113
0
  constexpr size_t component_count = ARRAY_LENGTH (ligature_table[0].ligatures[0].components);
114
115
0
  OT::HBGlyphID16 first_glyphs[table_length];
116
0
  unsigned int first_glyphs_indirection[table_length];
117
0
  unsigned int ligature_per_first_glyph_count_list[table_length];
118
0
  unsigned int num_first_glyphs = 0;
119
120
  /* We know that all our ligatures have the same number of components. */
121
0
  OT::HBGlyphID16 ligature_list[table_length * ligature_count];
122
0
  unsigned int component_count_list[table_length * ligature_count];
123
0
  OT::HBGlyphID16 component_list[table_length * ligature_count * component_count];
124
125
0
  unsigned int num_ligatures = 0;
126
0
  unsigned int num_components = 0;
127
128
  /* Populate arrays */
129
130
  /* Sort out the first-glyphs */
131
0
  for (unsigned int first_glyph_idx = 0; first_glyph_idx < table_length; first_glyph_idx++)
132
0
  {
133
0
    hb_codepoint_t first_u = ligature_table[first_glyph_idx].first;
134
0
    hb_codepoint_t first_glyph;
135
0
    if (!hb_font_get_glyph (font, first_u, 0, &first_glyph))
136
0
      continue;
137
0
    first_glyphs[num_first_glyphs] = first_glyph;
138
0
    ligature_per_first_glyph_count_list[num_first_glyphs] = 0;
139
0
    first_glyphs_indirection[num_first_glyphs] = first_glyph_idx;
140
0
    num_first_glyphs++;
141
0
  }
142
0
  hb_stable_sort (&first_glyphs[0], num_first_glyphs,
143
0
      (int(*)(const OT::HBUINT16*, const OT::HBUINT16 *)) OT::HBGlyphID16::cmp,
144
0
      &first_glyphs_indirection[0]);
145
146
  /* Now that the first-glyphs are sorted, walk again, populate ligatures. */
147
0
  for (unsigned int i = 0; i < num_first_glyphs; i++)
148
0
  {
149
0
    unsigned int first_glyph_idx = first_glyphs_indirection[i];
150
151
0
    for (unsigned int ligature_idx = 0; ligature_idx < ligature_count; ligature_idx++)
152
0
    {
153
0
      hb_codepoint_t ligature_u = ligature_table[first_glyph_idx].ligatures[ligature_idx].ligature;
154
0
      hb_codepoint_t ligature_glyph;
155
0
      if (!hb_font_get_glyph (font, ligature_u, 0, &ligature_glyph))
156
0
  continue;
157
158
0
      bool matched = true;
159
0
      for (unsigned j = 0; j < component_count; j++)
160
0
      {
161
0
  hb_codepoint_t component_u   = ligature_table[first_glyph_idx].ligatures[ligature_idx].components[j];
162
0
  hb_codepoint_t component_glyph;
163
0
  if (!component_u ||
164
0
      !hb_font_get_nominal_glyph (font, component_u, &component_glyph))
165
0
  {
166
0
    matched = false;
167
0
    break;
168
0
  }
169
170
0
  component_list[num_components + j] = component_glyph;
171
0
      }
172
0
      if (!matched)
173
0
        continue;
174
175
0
      num_components += component_count;
176
0
      component_count_list[num_ligatures] = 1 + component_count;
177
0
      ligature_list[num_ligatures] = ligature_glyph;
178
179
0
      ligature_per_first_glyph_count_list[i]++;
180
181
0
      num_ligatures++;
182
0
    }
183
0
  }
184
185
0
  if (!num_ligatures)
186
0
    return nullptr;
187
188
189
  /* 16 bytes per ligature ought to be enough... */
190
0
  char buf[ARRAY_LENGTH (ligature_list) * 16 + 128];
191
0
  hb_serialize_context_t c (buf, sizeof (buf));
192
0
  OT::SubstLookup *lookup = c.start_serialize<OT::SubstLookup> ();
193
0
  bool ret = lookup->serialize_ligature (&c,
194
0
           lookup_flags,
195
0
           hb_sorted_array (first_glyphs, num_first_glyphs),
196
0
           hb_array (ligature_per_first_glyph_count_list, num_first_glyphs),
197
0
           hb_array (ligature_list, num_ligatures),
198
0
           hb_array (component_count_list, num_ligatures),
199
0
           hb_array (component_list, num_components));
200
0
  c.end_serialize ();
201
202
0
  return ret && !c.in_error () ? c.copy<OT::SubstLookup> () : nullptr;
203
0
}
Unexecuted instantiation: hb-ot-shaper-arabic.cc:OT::Layout::GSUB_impl::SubstLookup* arabic_fallback_synthesize_lookup_ligature<ligature_3_set_t [1]>(hb_ot_shape_plan_t const*, hb_font_t*, ligature_3_set_t const (&) [1], unsigned int)
Unexecuted instantiation: hb-ot-shaper-arabic.cc:OT::Layout::GSUB_impl::SubstLookup* arabic_fallback_synthesize_lookup_ligature<ligature_set_t [18]>(hb_ot_shape_plan_t const*, hb_font_t*, ligature_set_t const (&) [18], unsigned int)
Unexecuted instantiation: hb-ot-shaper-arabic.cc:OT::Layout::GSUB_impl::SubstLookup* arabic_fallback_synthesize_lookup_ligature<ligature_mark_set_t [1]>(hb_ot_shape_plan_t const*, hb_font_t*, ligature_mark_set_t const (&) [1], unsigned int)
204
205
static OT::SubstLookup *
206
arabic_fallback_synthesize_lookup (const hb_ot_shape_plan_t *plan,
207
           hb_font_t *font,
208
           unsigned int feature_index)
209
0
{
210
0
  if (feature_index < 4)
211
0
    return arabic_fallback_synthesize_lookup_single (plan, font, feature_index);
212
0
  else
213
0
  {
214
0
    switch (feature_index) {
215
0
      case 4: return arabic_fallback_synthesize_lookup_ligature (plan, font, ligature_3_table, OT::LookupFlag::IgnoreMarks);
216
0
      case 5: return arabic_fallback_synthesize_lookup_ligature (plan, font, ligature_table, OT::LookupFlag::IgnoreMarks);
217
0
      case 6: return arabic_fallback_synthesize_lookup_ligature (plan, font, ligature_mark_table, 0);
218
0
    }
219
0
  }
220
0
  assert (false);
221
0
  return nullptr;
222
0
}
223
224
#define ARABIC_FALLBACK_MAX_LOOKUPS ARRAY_LENGTH (arabic_fallback_features)
225
226
struct arabic_fallback_plan_t
227
{
228
  unsigned int num_lookups;
229
  bool free_lookups;
230
231
  hb_mask_t mask_array[ARABIC_FALLBACK_MAX_LOOKUPS];
232
  OT::SubstLookup *lookup_array[ARABIC_FALLBACK_MAX_LOOKUPS];
233
  OT::hb_ot_layout_lookup_accelerator_t *accel_array[ARABIC_FALLBACK_MAX_LOOKUPS];
234
};
235
236
#ifndef HB_NO_WIN1256
237
#include "hb-ot-shaper-arabic-win1256.hh"
238
#endif
239
240
struct ManifestLookup
241
{
242
  public:
243
  OT::Tag tag;
244
  OT::Offset16To<OT::SubstLookup> lookupOffset;
245
  public:
246
  DEFINE_SIZE_STATIC (6);
247
};
248
typedef OT::Array16Of<ManifestLookup> Manifest;
249
250
static bool
251
arabic_fallback_plan_init_win1256 (arabic_fallback_plan_t *fallback_plan HB_UNUSED,
252
           const hb_ot_shape_plan_t *plan HB_UNUSED,
253
           hb_font_t *font HB_UNUSED)
254
0
{
255
0
#ifndef HB_NO_WIN1256
256
  /* Does this font look like it's Windows-1256-encoded? */
257
0
  hb_codepoint_t g;
258
0
  if (!(hb_font_get_glyph (font, 0x0627u, 0, &g) && g == 199 /* ALEF */ &&
259
0
  hb_font_get_glyph (font, 0x0644u, 0, &g) && g == 225 /* LAM */ &&
260
0
  hb_font_get_glyph (font, 0x0649u, 0, &g) && g == 236 /* ALEF MAKSURA */ &&
261
0
  hb_font_get_glyph (font, 0x064Au, 0, &g) && g == 237 /* YEH */ &&
262
0
  hb_font_get_glyph (font, 0x0652u, 0, &g) && g == 250 /* SUKUN */))
263
0
    return false;
264
265
0
  const Manifest &manifest = reinterpret_cast<const Manifest&> (arabic_win1256_gsub_lookups.manifest);
266
0
  static_assert (sizeof (arabic_win1256_gsub_lookups.manifestData) <=
267
0
     ARABIC_FALLBACK_MAX_LOOKUPS * sizeof (ManifestLookup), "");
268
269
0
  unsigned j = 0;
270
0
  unsigned int count = manifest.len;
271
0
  for (unsigned int i = 0; i < count; i++)
272
0
  {
273
0
    fallback_plan->mask_array[j] = plan->map.get_1_mask (manifest[i].tag);
274
0
    if (fallback_plan->mask_array[j])
275
0
    {
276
0
      fallback_plan->lookup_array[j] = const_cast<OT::SubstLookup*> (&(&manifest+manifest[i].lookupOffset));
277
0
      if (fallback_plan->lookup_array[j])
278
0
      {
279
0
  fallback_plan->accel_array[j] = OT::hb_ot_layout_lookup_accelerator_t::create (*fallback_plan->lookup_array[j]);
280
0
  j++;
281
0
      }
282
0
    }
283
0
  }
284
285
0
  fallback_plan->num_lookups = j;
286
0
  fallback_plan->free_lookups = false;
287
288
0
  return j > 0;
289
#else
290
  return false;
291
#endif
292
0
}
293
294
static bool
295
arabic_fallback_plan_init_unicode (arabic_fallback_plan_t *fallback_plan,
296
           const hb_ot_shape_plan_t *plan,
297
           hb_font_t *font)
298
0
{
299
0
  static_assert ((ARRAY_LENGTH (arabic_fallback_features) <= ARABIC_FALLBACK_MAX_LOOKUPS), "");
300
0
  unsigned int j = 0;
301
0
  for (unsigned int i = 0; i < ARRAY_LENGTH(arabic_fallback_features) ; i++)
302
0
  {
303
0
    fallback_plan->mask_array[j] = plan->map.get_1_mask (arabic_fallback_features[i]);
304
0
    if (fallback_plan->mask_array[j])
305
0
    {
306
0
      fallback_plan->lookup_array[j] = arabic_fallback_synthesize_lookup (plan, font, i);
307
0
      if (fallback_plan->lookup_array[j])
308
0
      {
309
0
  fallback_plan->accel_array[j] = OT::hb_ot_layout_lookup_accelerator_t::create (*fallback_plan->lookup_array[j]);
310
0
  j++;
311
0
      }
312
0
    }
313
0
  }
314
315
0
  fallback_plan->num_lookups = j;
316
0
  fallback_plan->free_lookups = true;
317
318
0
  return j > 0;
319
0
}
320
321
static arabic_fallback_plan_t *
322
arabic_fallback_plan_create (const hb_ot_shape_plan_t *plan,
323
           hb_font_t *font)
324
0
{
325
0
  arabic_fallback_plan_t *fallback_plan = (arabic_fallback_plan_t *) hb_calloc (1, sizeof (arabic_fallback_plan_t));
326
0
  if (unlikely (!fallback_plan))
327
0
    return const_cast<arabic_fallback_plan_t *> (&Null (arabic_fallback_plan_t));
328
329
0
  fallback_plan->num_lookups = 0;
330
0
  fallback_plan->free_lookups = false;
331
332
  /* Try synthesizing GSUB table using Unicode Arabic Presentation Forms,
333
   * in case the font has cmap entries for the presentation-forms characters. */
334
0
  if (arabic_fallback_plan_init_unicode (fallback_plan, plan, font))
335
0
    return fallback_plan;
336
337
  /* See if this looks like a Windows-1256-encoded font.  If it does, use a
338
   * hand-coded GSUB table. */
339
0
  if (arabic_fallback_plan_init_win1256 (fallback_plan, plan, font))
340
0
    return fallback_plan;
341
342
0
  assert (fallback_plan->num_lookups == 0);
343
0
  hb_free (fallback_plan);
344
0
  return const_cast<arabic_fallback_plan_t *> (&Null (arabic_fallback_plan_t));
345
0
}
346
347
static void
348
arabic_fallback_plan_destroy (arabic_fallback_plan_t *fallback_plan)
349
0
{
350
0
  if (!fallback_plan || fallback_plan->num_lookups == 0)
351
0
    return;
352
353
0
  for (unsigned int i = 0; i < fallback_plan->num_lookups; i++)
354
0
    if (fallback_plan->lookup_array[i])
355
0
    {
356
0
      if (fallback_plan->accel_array[i])
357
0
  fallback_plan->accel_array[i]->fini ();
358
0
      hb_free (fallback_plan->accel_array[i]);
359
0
      if (fallback_plan->free_lookups)
360
0
  hb_free (fallback_plan->lookup_array[i]);
361
0
    }
362
363
0
  hb_free (fallback_plan);
364
0
}
365
366
static void
367
arabic_fallback_plan_shape (arabic_fallback_plan_t *fallback_plan,
368
          hb_font_t *font,
369
          hb_buffer_t *buffer)
370
0
{
371
0
  OT::hb_ot_apply_context_t c (0, font, buffer, hb_blob_get_empty ());
372
0
  for (unsigned int i = 0; i < fallback_plan->num_lookups; i++)
373
0
    if (fallback_plan->lookup_array[i]) {
374
0
      c.set_lookup_mask (fallback_plan->mask_array[i]);
375
0
      if (fallback_plan->accel_array[i])
376
0
  hb_ot_layout_substitute_lookup (&c,
377
0
          *fallback_plan->lookup_array[i],
378
0
          *fallback_plan->accel_array[i]);
379
0
    }
380
0
}
381
382
383
#endif /* HB_OT_SHAPER_ARABIC_FALLBACK_HH */